过场动画API

Cutscene API 是一个模组，允许你制作带有摄像机移动和可选效果的过场动画，并在游戏中实时播放它们。它旨在供地图制作者和模组制作者使用，让他们的项目更加精美。

功能概览

决定玩家所见内容的是一个过场动画类型，或简称为过场动画，在数据包中定义。过场动画有一个_长度_（以刻为单位）、摄像机的_路径_、玩家在观看过场动画时允许执行的_动作_列表、开始_和_结束过渡，以及一些特殊的_效果_。所有这些都是可选的，但组合起来，它们可以制作出精美的过场动画。

你可以在下面的折叠框中找到更多细节：

路径

在过场动画期间，玩家的摄像机可以沿着某条路径移动。这条路径由一组段定义，每一段可以是简单的直线、贝塞尔曲线、Catmull-Rom 样条曲线、静止点，或坐标由数学函数定义的特殊点。

摄像机的旋转使用相同类型的段来定义，此外还有一种特殊的段，让你可以从所在位置看向特定点。

过渡

玩家不必瞬间切入过场动画——你可以指定一个过渡，让它看起来更加精美。目前实现的过渡有“平滑缓动”，让你平滑地进入或离开过场动画的路径，以及“淡入淡出”，将屏幕淡入某种颜色（不一定是单一颜色，也不一定是恒定颜色），然后开始或结束过场动画。

动作开关

在过场动画期间，你可以阻止玩家移动、转头、破坏方块、使用物品、受到伤害，或者让他们变为旁观者模式，这样生物就不会将他们作为目标。目前这有点不稳定。

效果

除了摄像机路径，你可能还想让玩家在过场动画中看到一些文字或图像。效果允许你做到这一点。目前实现的效果包括“出现文字”，随时间缓慢出现；“三角带”，可用于用三角形绘制简单几何图形；“矩形”，绘制一个矩形；以及“纹理 blit”，在指定位置绘制纹理。

命令

/cutscene start <player> <type> [at_preview | position] [start_camera_rotation] [path_rotation] - 在指定位置开始一个过场动画，摄像机初始朝向为 start_camera_rotation，路径围绕起始位置旋转 path_rotation

/cutscene stop [player] - 为玩家停止一个过场动画

/cutscene preview set <type> [start_pos] [path_rotation] - 从某个点预览过场动画路径，围绕该点旋转

/cutscene preview hide - 隐藏预览

自己看看

在源代码仓库中，有一个名为“Example Cutscenes”的文件夹，它是一个数据包，里面包含了一堆我用来测试新功能的过场动画，你可以用它来看看这个模组能提供什么。它们有时有点奇怪，但能达到目的。

兼容性

我尽量让这个模组尽可能与其他模组兼容。应该不会有问题。

我发布的大多数版本通常是向后兼容的，尤其是在格式方面。