Skip to content

Latest commit

 

History

History
96 lines (65 loc) · 3.25 KB

File metadata and controls

96 lines (65 loc) · 3.25 KB

ImmersiveCinematics

给你的整合包加上过场动画。 一个模组搞定叙事——写 JSON 或用编辑器,不需要指令方块。

English Documentation

本项目由 AI Agent 生成。作者仅提供创意和概念,AI Agent 负责代码实现和功能开发。


这是什么?

ImmersiveCinematics 是一个为整合包设计的过场动画模组。服务端触发系统配合客户端播放,脚本作者通过 JSON 或游戏内编辑器定义过场动画,在指定条件(登录、位置、进度、群系、维度切换、击杀、实体交互、方块交互、手持物品交互目标、合成、使用物品、消耗物品、物品栏、结构、游戏阶段、自定义事件 — 共 16 种触发方式)满足时自动播放。

适用场景:

  • 进新区域自动播放入场动画
  • Boss 战前的剧情展示
  • 开宝箱时镜头特写
  • 固定机位视角解谜(生化危机0式)
  • 自动飞行巡览展示地图

功能特性

过场动画系统

  • 6 自由度相机:位置、偏航、俯仰、滚转、FOV、缩放
  • 关键帧驱动+贝塞尔曲线路径,流畅镜头运动
  • 相对/绝对定位,循环播放,无限时长
  • 多轨道时间轴:相机、黑边、音频、事件、模组事件
  • 宽银幕遮幅,关键帧驱动宽高比动画
  • 镜头间交叉淡化过渡

触发器系统(服务端)

  • 16 种触发类型:登录、位置(点+半径/方体区域)、进度、群系、维度切换、击杀、实体交互、方块交互、手持物品交互目标、合成、使用物品、消耗物品、物品栏、结构、游戏阶段、自定义事件
  • 支持 OR/AND 逻辑和通配符匹配
  • 可重复触发或单次触发,支持延迟执行

运行时控制

  • 18 项行为标志:可跳过、可打断、末帧保持、键盘/鼠标/生物 AI 屏蔽、7 项独立 HUD 开关、隐藏手臂、视角摇晃抑制、显示玩家模型、暂停时冻结等
  • 脚本排队与打断机制,适用于固定视角区域
  • 多玩家脚本追踪与完成状态同步

兼容性

  • 光影包兼容(不侵入 OpenGL 管线)
  • 视角摇晃抑制(受伤抖动、行走摇晃、反胃效果)
  • 暂停感知:游戏暂停时脚本自动冻结

快速开始

  1. 安装 Minecraft Forge 1.20.1(47.x+)
  2. 下载 ImmersiveCinematics 并放入 .minecraft/mods/
  3. 启动游戏

命令

命令 说明
/icinematics play <文件> 播放过场动画脚本
/icinematics stop 停止当前播放
/icinematics status 显示播放状态

游戏内编辑器

使用内置的时间轴编辑器,无需离开游戏即可可视化创建和修改脚本。

单一构建包含播放运行时和游戏内编辑器,所有用户下载同一个 jar 即可。


版本

当前版本:0.3.2

版本
Minecraft 1.20.1
Forge 47.x+
脚本格式 v3

未来计划

0.4.0

  • 音频轨道:背景音乐/音效在时间轴上同步播放,支持淡入淡出和循环
  • 事件轨道:在时间轴任意时间点执行游戏内命令
  • 时间轴多轨道完整支持:全部轨道类型可视化编辑

许可证

MIT 许可证