NLibCutscene

NLibCutscene 是一款专业级工具，可直接在 Minecraft 内创建过场动画和电影。我们摒弃了复杂的聊天命令，采用现代 GUI 和强大的动作捕捉系统。只需点击录制，自由移动，该模组便会将您的飞行轨迹转化为流畅、专业的动画。

适用于追求在游戏中实现视频编辑器品质的地图制作者、服务器管理员和内容创作者。

✨ 主要特性

🎥 动作捕捉

无需手动输入坐标。按下“录制”键，模组便会实时捕捉您的飞行路径、头部旋转和摄像机倾斜。

🖥️ 现代深色 GUI

完全重新设计的界面，采用“幽暗深色”美学。半透明面板、极简按钮和动态星空背景，让编辑过场动画成为一种视觉享受。

您也可以使用以下命令启动过场动画：

/startct "过场动画名称"

🔄 高级摄像机控制

• 摄像机滚动： 完全支持 Z 轴旋转。录制时使用 Z 和 X 键可添加戏剧性的荷兰式倾斜角度。
• 摄像机抖动： 为任意关键帧添加可自定义的抖动效果（非常适合爆炸或强烈撞击场景）。
• 飞越模式： 创建复杂路径，摄像机使用 Catmull-Rom 样条曲线连续穿过各点而无需停顿。

📈 插值逻辑

为每个片段选择背后的运动算法：

• 🌊 Catmull-Rom： 通过点的平滑样条曲线插值（连续运动）。
• 🚀 缓入/缓出： 电影般的加速和减速效果。
• 🟦 线性： 恒定速度（机械运动）。
• ⚡ 瞬时： 硬切换（瞬移）。

📂 配置与数据

所有过场动画都保存为整洁、可读的 JSON 文件。这使得分享路径、添加到整合包或使用文本编辑器微调数值变得非常容易。

文件位置： config/cutscenemod/cutscenes/<过场动画名称>.json

📝 JSON 结构示例

您可以手动编辑这些文件以实现像素级精度：

{
  "startFromPlayer": true,        // 从玩家当前位置开始路径
  "startTransitionTime": 2.5,     // 飞到第一个点的时间
  "startInterpolation": "ease_out",
  "endToPlayer": true,            // 结束后返回玩家位置
  "endTransitionTime": 3.0,
  "endInterpolation": "ease_in",
  "points": [
    {
      "x": 5.67,
      "y": -58.38,
      "z": 0.29,
      "yaw": 177.0,
      "pitch": 0.45,
      "roll": 15.0,               // 摄像机滚动（倾斜）角度
      "moveDuration": 3.0,        // 移动到该点所需时间
      "holdDuration": 0.0,        // 等待时间（如果 isSmooth=true 则忽略）
      "interpolation": "catmull_rom", // 平滑类型
      "cameraShake": true,        // 启用摄像机抖动
      "shakeIntensity": 0.5,      // 抖动强度
    },
    {
      "x": 8.95,
      "y": -58.37,
      "z": -5.36,
      "yaw": 176.99,
      "pitch": 0.44,
      "roll": 0.0,
      "moveDuration": 3.0,
      "holdDuration": 1.0,
      "interpolation": "ease_in_out",
      "cameraShake": false,
      "shakeIntensity": 0.5,
    }
  ]
}