Director’s Camera

导演镜头

DirectorsCamera 为你的世界带来一支摄影团队。

不必把玩家传送来传送去，也不用把他们锁在船上展示某处景物。你可以使用镜头工具、kubejs 或 JSOn 数据包描述镜头路径，然后让游戏沿途飞行，向玩家展示你想让他们看到的内容。视角会从玩家身上升起，沿着你设定的路径滑行，并在镜头结束后将控制权交还给玩家。播放期间，玩家无法行走、环顾四周或破坏任何东西，因此他们看到的画面正是你精心构图的镜头。

这些过场动画适用于出生点导览、Boss亮相、任务开场、展示刚刚完成的机器，或缓缓掠过基地的天际线。

边走边构建镜头

导演镜头（工具与实用工具选项卡）可以录制镜头，无需任何人输入坐标。站在你想要的镜头位置，朝向你想拍摄的方向，然后点击即可。

手持镜头时，你可以在世界中看到完整镜头路径，每个镜头点都有编号标记。指示镜头朝向的线条会从一个镜头点延伸到下一个镜头点，并显示镜头实际经过的曲线路径。你当前注视的标记会变成绿色，方便你确认即将修改的是哪一个镜头点。

录制内容会保存在物品上，因此你可以把镜头交给其他人、在箱子里存放多个镜头以备不同场景使用，也可以复制一个镜头并编辑副本。

满意后，为镜头命名并保存，之后随时都可以播放：

/directorscamera camera save myworld:intro
/directorscamera play myworld:intro

你可以为自己、指定玩家、范围内所有玩家或服务器上的所有玩家播放镜头。

跟随建筑的镜头

在房间里放置一个过场锚点方块，并以该方块为基准录制镜头。同一房间的其他副本，无论旋转了多少角度、位于世界何处，都能正确播放相同的镜头。这适用于地牢房间、预制结构，以及任何会被结构重复生成的建筑。

锚点也可以在玩家走到设定距离内时自行播放过场动画，并可设置为每位玩家只播放一次，或在冷却时间结束后再次播放。锚点方块在生存模式下是隐形的，因此除了你以外，其他人都看不到它（创造模式下或手持镜头时除外）。

音效、震动与退出方式

镜头可以包含与画面同步的音效提示，并由每位观看者分别播放，因此即使服务器卡顿，音乐和音效也能保持同步。音效可以固定在世界中的某个位置，也可以跟随镜头移动。

屏幕震动也可以独立使用，并可设置作用半径，让附近的玩家感受到更强烈的震动，远处的玩家感受到较弱的震动。可以用来表现爆炸、机械运作或 Boss 落地。

任何可跳过的镜头都会在玩家按住跳跃键一秒半后结束，屏幕角落还会显示进度条，提示玩家操作正在生效。如果出现问题，使用 /directorscamera fix 即可立即让玩家恢复对角色的控制。

预设镜头

几种常用镜头动作都只需一行命令：绕某个点完整环绕一圈、直线飞掠、下降至目标处、原地转向、向某个物体推进，以及原地旋转并可无限循环、直到玩家跳过的全景镜头。

整合包作者须知

过场动画可以写成数据包 JSON 文件，因此整合包无需任何脚本即可附带它们。点位生成器负责繁琐的部分：轨道、螺旋、弧线和全景由中心和半径来描述，而不是手动列出几十个点。

如果你的整合包使用 KubeJS，一切也都可以从脚本中使用：在代码中构建镜头，在镜头中的精确时刻运行命令或你自己的逻辑，对过场动画的开始、刻更新、完成或被跳过做出反应，并在播放开始前取消播放。在游戏中使用相机物品制作的镜头可以直接导出为数据包文件或 KubeJS 脚本，并粘贴到你的整合包中。

底层还有一个 Bedrock 风格的关键帧动画系统，带有表达式、循环模式和混合过渡，如果你想从 Blockbench 动画驱动相机（或任何其他东西）。

需求

Minecraft 26.1.2，NeoForge。KubeJS 是可选的，仅在脚本 API 中需要。其他所有内容，包括相机物品、锚点和数据包过场动画，无需它即可工作。

完整文档、命令列表和脚本参考都在 GitHub 页面上。