NeoStory

描述 — 英文

什么是 NeoStory？

NeoStory 是一款游戏内的节点图编辑器，用于在 Minecraft 中创作叙事动画。无需手动编写/summon和/tp命令，只需在蓝图风格的画布上放置节点、将它们连接起来，然后按下播放——对话、镜头移动、音效和脚本控制的实体都会由同一张图统一驱动。

它专为过场动画创作而设计：节点图决定发生什么以及何时发生，玩家只需观看。

功能

节点图编辑器

按下K即可打开，也可以使用/neostory editor。

• 蓝图风格画布：拖动空白区域即可平移，滚动鼠标滚轮即可缩放（以光标位置为中心）
• 右键点击节点可复制、重命名或删除；使用Ctrl+C / Ctrl+V进行复制和粘贴
• 支持完整的撤销和重做——使用Ctrl+Z / Ctrl+Y，或点击底栏中的按钮
• 图表采用纯 JSON 格式（.neograph），并保存在<game directory>/neostory/

无需管理员权限的脚本实体

同一个 jar 文件可运行在客户端、服务器上，也可同时运行在两者上。

• 如果服务器也安装了 NeoStory，实体操作就会在服务器端以管理员权限执行——玩家无需拥有 op 权限。
• 如果服务器没有安装 NeoStory，NeoStory 会改用玩家自己的命令；这与通常一样，需要 op 权限。

无论哪种情况，节点图本身都完全相同：一张图，两种执行方式。

基于游戏刻的播放

播放时每个游戏刻推进一个节点，因此故事可以自然地暂停、继续和分支。不会阻塞休眠，也不会冻结游戏。

节点类型

节点	功能
对话	显示一行字幕，并持续指定游戏刻数
镜头转向	将镜头立即转向指定的偏航角和俯仰角
镜头平滑转向	在指定游戏刻数内平滑转动镜头
播放音效	播放音效
设置变量	为故事变量赋值
分支	比较变量，并根据结果继续执行then或else
生成实体	召唤方块展示实体、物品展示实体、生物或 NPC
移动实体	将已生成的实体移动到指定坐标
旋转实体	设置实体的偏航角和俯仰角
缩放实体	缩放展示实体
移除实体	删除已生成的实体

生成的实体通过命名句柄而非 UUID 进行引用，因此节点图清晰易读且便于移植。

快速开始

1. 为 Minecraft 1.21.1 安装 NeoForge。
2. 将 jar 文件放入mods/。安装客户端版本即可使用编辑器；服务器端安装为可选。
3. 启动游戏并按下K，或运行/neostory editor。
4. 构建节点图后按下播放。运行/neostory demo即可载入内置示例，了解各部分如何配合。

命令

/neostory editor            open the editor
/neostory play              start the current graph
/neostory stop              stop playback
/neostory clear             remove all story entities
/neostory list              list saved graphs
/neostory save <name>       save the current graph
/neostory load <name>       load a graph
/neostory status            show the current state
/neostory demo              load a built-in demo graph
/neostory minimal           load a minimal example
/neostory demo_else         load a branching example

运行要求

Minecraft	1.21.1
NeoForge	21.1.72 或更高版本
Java	21

环境

端	用途
客户端	必需——编辑器、播放和字幕都在这里
服务端	可选——安装后，实体动作会以 op 级权限执行，玩家无需成为 op

早期版本

NeoStory 仍在积极开发中。图格式和节点集合可能随版本变化，使用旧版本保存的图可能需要重建。请备份重要内容。

HeliWork 2026，保留所有权利。

---

介绍 — 中文

NeoStory 是什么？

NeoStory 是一款游戏内节点图编辑器，用于编排 Minecraft 剧情动画。无需再手动编写 /summon、/tp 命令，只需在蓝图式画布上放置节点、连接节点，然后按下播放——对白、镜头、音效和剧情实体都由同一张图驱动。

它专为过场动画打造：节点图决定发生什么以及何时发生，玩家只需观看。

功能

节点图编辑器

按 K 打开，或使用 /neostory editor。

• 蓝图式画布：拖动空白处平移，滚轮缩放（以鼠标位置为中心）
• 右键点击节点可复制、重命名或删除；Ctrl+C / Ctrl+V 可复制和粘贴
• 完整支持撤销和重做——Ctrl+Z / Ctrl+Y，也可以使用底栏按钮
• 图文件采用普通 JSON 格式（.neograph），存放在 <游戏目录>/neostory/

无需给玩家 op 权限，也能驱动剧情实体

同一个 jar 可安装在客户端、服务端或两端。

• 如果服务端也安装了 NeoStory，实体动作就会在服务端以 op 级权限执行——玩家不需要是 op
• 。如果服务端没有安装，动作会自动改为使用玩家自己的命令，此时仍需要 op 权限。

两种情况下，图本身都完全相同：一张图，两种执行路径。

基于 tick 的播放

播放会逐游戏刻推进节点，因此剧情天然支持暂停、继续和分支。没有阻塞式等待，游戏也不会卡住。

节点类型

节点	功能
对白	显示一行字幕，持续指定的 tick 数
镜头转向	将镜头瞬间转到指定的 yaw / pitch
镜头平滑转向	在指定的 tick 数内平滑转动镜头
播放音效	播放音效
设置变量	为剧情变量赋值
条件分支	比较变量，并根据结果走 then 或 else
召唤实体	召唤方块展示实体、物品展示实体、生物或 NPC
移动实体	将已召唤的实体移动到指定坐标
实体转向	设置实体的 yaw / pitch
缩放实体	缩放展示实体
移除实体	删除已召唤的实体

召唤的实体使用具名句柄进行寻址，而不是 UUID，让图更清晰，也更容易移植。

快速上手

1. 先安装适用于 Minecraft 1.21.1 的 NeoForge。
2. 将 jar 放入 mods/。编辑器位于客户端，服务端版本为可选。
3. 启动游戏后按 K，或输入 /neostory editor。
4. 搭建一张图并按下播放。想先看看完成后的效果，可以运行 /neostory demo 加载内置示例。

指令

/neostory editor            打开编辑器
/neostory play              播放当前图
/neostory stop              停止播放
/neostory clear             清除所有剧情实体
/neostory list              列出已保存的图
/neostory save <名字>       保存当前图
/neostory load <名字>       载入一张图
/neostory status            查看当前状态
/neostory demo              载入内置演示图
/neostory minimal           载入最小示例
/neostory demo_else         载入分支示例

运行环境

Minecraft	1.21.1
NeoForge	21.1.72 或更高版本
Java	21

端	说明
客户端	必需——编辑器、播放和字幕都在这一侧
服务端	可选——安装后，实体动作会以 op 级权限执行，玩家无需成为 op

早期版本说明

NeoStory 仍在积极开发中。图格式和节点种类可能随版本变化，使用旧版本保存的图可能需要重建。请备份你在意的内容。

HeliWork 2026，保留所有权利。未经许可，禁止二次分发。