CineWolf AutoDirector

CineWolf AutoDirector 是 Flashback 的一个客户端 Fabric 扩展，可将回放活动转换为可编辑的电影级镜头工作。它通过确定性的本地回放分析生成单镜头或多镜头蒙太奇。

安装

1. 为 Minecraft 26.2 安装 Fabric Loader。
2. 安装 Fabric API 0.153.0+26.2 或兼容的更新 26.2 版本。
3. 安装 Flashback 0.41.1。
4. 将 cinewolf-autodirector-1.3.5.jar 放入客户端的 mods 文件夹。
5. 在 Flashback 中打开一个回放。 CineWolf AutoDirector 窗口会出现在回放编辑器中。

Flashback 是必需的外部依赖项。CineWolf 不会遮蔽、捆绑、复制或修改它。

生成蒙太奇

1. 标记 Flashback 的 In/Out 范围。
2. 打开 生成蒙太奇 部分。
3. 选择一个预设以及一个主目标或自动目标检测。
4. 可选地调整时长、宽高比、节奏、镜头边界、事件类别、碰撞避免、回放速度偏好和高级采样限制。 镜头平滑控制与手动镜头共享；仅更改这些控制项会保留已完成的回放分析和已编辑的蒙太奇计划。
5. 选择 分析回放。采样可取消，且不会在渲染回调中运行。
6. 在 CineWolf 自有的紧凑事件迷你时间线上查看事件和评分原因。
7. 查看建议的镜头列表。根据需要禁用、重新排序、锁定、移除、替换或重新生成未锁定的镜头。
8. 预览蒙太奇。垂直预设会显示居中的 9:16 安全区域参考线。
9. 确认生成并解决任何相机、FOV 或回放时间冲突。
10. 编辑生成的原生 Flashback 关键帧或撤销整个 CineWolf 蒙太奇。

事件迷你时间线属于 CineWolf 面板。版本 1.2.0 不会将标记注入 Flashback 的原生时间线，也绝不会修改原生回放标记。

手动镜头

1. 选择一个实体目标。
2. 选择镜头类型（包括 Reveal、Crane、Spiral、跟踪、Chase、Close Detail、Vehicle Profile）并调整其字段。
3. 标记 Flashback In/Out 点，或使用当前回放时间加上 时长。
4. 选择 预览路径，检查 3D 路径和警告，然后选择 生成镜头。
5. 使用“取消”、“不删除而添加”或“替换区间内”来解决冲突。取消是安全的默认选项。

相机路径平滑

该过滤器在本地世界碰撞检查之前运行，之后绝不会移动受碰撞约束的采样点。 位置强度 在保留 Orbit 半径和程序化 Dolly 距离的同时，平滑相对于目标的相机路径。 旋转强度 在重新计算偏航角和俯仰角之前平滑瞄准点。 窗口 控制居中的时间跨度，因此不会引入仅向前延迟。可选的异常值剔除仅移除同时超过两个配置阈值的孤立高速“出-入”脉冲；持续快速运动、真实转向、端点以及传送/不连续边界会被保留。

输出时间与回放时间

CineWolf 将输出时长、源回放时间、回放速度和原生相机轨道时间分开。Flashback 在源回放刻轴（tick axis）上评估原生轨道。因此，CineWolf 写入 Timelapse 点，其关键位置为源回放刻，其值为经过的输出刻；Flashback 根据这两个轴之间的比率推导播放 TPS。

Flashback 0.41.1 不提供适用于任意非相邻回放片段的稳定源剪切抽象。因此，版本 1.2.0 计划一个连续、严格递增的源窗口，并且不会反转、重新定位或拼接源绑定的相机内容。该窗口内的回放速度变化保持在配置的最小值、最大值和相邻变化边界内。非时间顺序的 Trailer 请求会被报告并按时间顺序规划，而不是不准确地表示。

配置

首选项存储在 config/cinewolf-autodirector.json 中。模式版本 4 添加了一个共享的 pathSmoothing 部分，包含位置/旋转强度、时间窗口和孤立运动剔除控制项。montage 部分保留检测器阈值、事件评分、镜头多样性、输出、采样、碰撞、回放速度、安全区域和调试设置。迁移期间会保留旧的手动镜头和蒙太奇值。格式错误的文件会被移至 cinewolf-autodirector.json.malformed，并替换为安全默认值。