游戏叙事与剧情 / 系统课时
整理可维护的剧情文件
整理可维护的剧情文件
剧情验收通过后,下一步不是继续堆文本,而是把“入口、状态、内部节点”整理成稳定结构。目标是让编剧能定位内容、程序能依赖少量固定接口,并让后续重命名或拆分节点时不必同时修改整个游戏工程。
学习目标
- 能按职责拆分 Ink 文件,并用一致命名避免全局变量和节点冲突。
- 能区分对游戏项目稳定暴露的入口与剧情内部实现细节。
- 能在整理后通过根文件重新编译和走查,确认拆分没有改变剧情行为。
先确定哪些名字必须稳定
可维护结构的关键不是“文件越多越好”,而是稳定边界。建议把游戏侧可能依赖的名称控制在很小范围,例如任务入口 quest_guard、主进度变量 quest_guard_stage;遗迹、古门等内部节点可以继续拆分,但不要让游戏代码直接跳到每个内部节点。
Ink 的变量处于故事级作用域时,命名过短很容易在多任务项目里冲突。使用功能前缀能让 stage、has_key 这类通用词变成 quest_guard_stage、quest_guard_has_key,搜索时也能立即看出归属。
用根文件组织依赖关系
下面给出一个最小三文件结构。main.ink 只负责汇总文件和进入公开入口,状态声明集中到 state.ink,任务内部节点留在 quest_guard.ink。把三个文件放在同一目录后,从 main.ink 启动故事。
main.ink:
INCLUDE state.ink
INCLUDE quest_guard.ink
-> quest_guardstate.ink:
VAR quest_guard_stage = 0
VAR quest_guard_has_key = falsequest_guard.ink:
=== quest_guard ===
{ quest_guard_stage == 0:
守卫:帮我找回遗迹里的旧钥匙。
* [接受任务]
~ quest_guard_stage = 1
-> quest_guard_ruins
}
{ quest_guard_stage == 1:
-> quest_guard_ruins
}
{ quest_guard_stage == 2:
守卫:这件事已经处理完了。
-> END
}
=== quest_guard_ruins ===
{ quest_guard_has_key == false:
你在倒塌的石像后找到了钥匙。
~ quest_guard_has_key = true
}
-> quest_guard_gate
=== quest_guard_gate ===
{ quest_guard_has_key:
~ quest_guard_stage = 2
守卫:门已经打开,任务完成。
-> END
}预期结果:从 main.ink 运行并选择“接受任务”后,应完成一次完整流程。
守卫:帮我找回遗迹里的旧钥匙。
你在倒塌的石像后找到了钥匙。
守卫:门已经打开,任务完成。这套拆分的重点不是三个文件本身,而是依赖方向:根文件知道有哪些模块,任务文件知道自己的内部节点,状态文件只声明共享状态。

控制跨文件耦合
整理时可以用一个简单原则判断某个名字是否应该公开:如果程序侧、存档迁移或测试工具需要长期依赖它,就把它视为稳定接口;如果只是为了让某段剧情继续运行,就尽量留在任务文件内部。
| 对象 | 建议稳定性 | 原因 |
|---|---|---|
根入口 quest_guard |
高 | 游戏侧可能从这里进入任务 |
主状态 quest_guard_stage |
高 | 存档和外部逻辑可能需要读取 |
内部节点 quest_guard_ruins |
低 | 允许随剧情重构调整 |
临时条件 quest_guard_has_key |
中 | 若只在 Ink 内使用,可继续隐藏在内容层 |
整理后重新做一次结构验收
文件拆分完成后,先从根文件编译,而不是分别验证每个片段。然后执行一条完整主流程,确认 INCLUDE 没有遗漏、跳转目标仍存在、变量只声明一次,并检查所有被游戏侧依赖的稳定名称是否保持不变。
如果整理过程中必须重命名公开入口或主状态,不要只做全文替换;还要同步检查游戏代码、存档字段映射和自动化测试。相反,内部节点重命名只要编译和剧情验收通过,就不应要求游戏侧跟着修改。
最终可维护的剧情文件应该满足一个直接标准:编剧可以在任务模块内自由改对白和内部节点,而游戏项目仍只依赖少量清晰、稳定、可搜索的入口与状态名称。