Description — English
What is NeoStory?
NeoStory is an in-game node-graph editor for authoring narrative animation in Minecraft. Instead of writing /summon and /tp commands by hand, you place nodes on a Blueprint-style canvas, wire them together, and press play — dialogue, camera moves, sound and scripted entities all run from a single graph.
It is built for cutscene authoring: the graph decides what happens and when, and the player just watches.
Features
Node-graph editor
Open it with K, or with /neostory editor.
- Blueprint-style canvas: drag empty space to pan, scroll wheel to zoom (anchored at the cursor)
- Right-click a node to duplicate, rename or delete it;
Ctrl+C/Ctrl+Vto copy and paste - Full undo and redo —
Ctrl+Z/Ctrl+Y, or the buttons in the bottom bar - Graphs are plain JSON (
.neograph) and live in<game directory>/neostory/
Scripted entities without operator rights
The same jar runs on the client, on the server, or on both.
- If the server also has NeoStory installed, entity actions are executed server-side with operator-level permission — players do not need to be op.
- If the server does not have it, NeoStory falls back to the player's own commands, which requires op as usual.
Either way the graph itself is identical: one graph, two execution paths.
Tick-driven playback
Playback advances one node per game tick, so stories pause, resume and branch naturally. No blocking sleeps, no frozen game.
Node types
| Node | What it does |
|---|---|
| Dialogue | Show a subtitle line for a number of ticks |
| Camera turn | Snap the camera to a yaw and pitch |
| Camera glide | Smoothly turn the camera over a number of ticks |
| Play sound | Play a sound effect |
| Set variable | Assign a value to a story variable |
| Branch | Compare a variable and continue on then or else |
| Spawn entity | Summon a block display, item display, mob or NPC |
| Move entity | Move a spawned entity to coordinates |
| Rotate entity | Set an entity's yaw and pitch |
| Scale entity | Scale a display entity |
| Remove entity | Delete a spawned entity |
Spawned entities are addressed by a named handle instead of a UUID, so a graph stays readable and portable.
Getting started
- Install NeoForge for Minecraft 1.21.1.
- Put the jar in
mods/. The client install is what gives you the editor; the server install is optional. - Launch the game and press
K, or run/neostory editor. - Build a graph and press Play. Run
/neostory demoto load a built-in example and see how the pieces fit together.
Commands
/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
Requirements
| Minecraft | 1.21.1 |
| NeoForge | 21.1.72 or newer |
| Java | 21 |
Environment
| Side | Why you want it |
|---|---|
| Client | Required — the editor, playback and subtitles all live here |
| Server | Optional — install it and entity actions run with operator-level permission, so your players never need op |
Early release
NeoStory is under active development. The graph format and the node set may change between versions, and graphs saved with an older build may need rebuilding. Please back up anything you care about.
HeliWork 2026,All Rights Reserved.
Description — 中文
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，图读起来清楚，也更好移植。
快速上手
- 先装好 Minecraft 1.21.1 对应的 NeoForge。
- 把 jar 放进
mods/。编辑器在客户端，服务端那份是可选的。 - 启动游戏按
K，或者输入/neostory editor。 - 搭一张图按播放。想先看看成品长什么样，运行
/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，闭源模组，未经许可，禁止二次分发。