游戏叙事与剧情 / 系统课时

整理可维护的剧情文件

整理可维护的剧情文件

剧情验收通过后,下一步不是继续堆文本,而是把“入口、状态、内部节点”整理成稳定结构。目标是让编剧能定位内容、程序能依赖少量固定接口,并让后续重命名或拆分节点时不必同时修改整个游戏工程。

学习目标

  • 能按职责拆分 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:

text
INCLUDE state.ink
INCLUDE quest_guard.ink

-> quest_guard

state.ink:

text
VAR quest_guard_stage = 0
VAR quest_guard_has_key = false

quest_guard.ink:

text
=== 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 运行并选择“接受任务”后,应完成一次完整流程。

text
守卫:帮我找回遗迹里的旧钥匙。
你在倒塌的石像后找到了钥匙。
守卫:门已经打开,任务完成。

这套拆分的重点不是三个文件本身,而是依赖方向:根文件知道有哪些模块,任务文件知道自己的内部节点,状态文件只声明共享状态。

Ink 剧情文件结构与对外接口边界

控制跨文件耦合

整理时可以用一个简单原则判断某个名字是否应该公开:如果程序侧、存档迁移或测试工具需要长期依赖它,就把它视为稳定接口;如果只是为了让某段剧情继续运行,就尽量留在任务文件内部。

对象 建议稳定性 原因
根入口 quest_guard 高 游戏侧可能从这里进入任务
主状态 quest_guard_stage 高 存档和外部逻辑可能需要读取
内部节点 quest_guard_ruins 低 允许随剧情重构调整
临时条件 quest_guard_has_key 中 若只在 Ink 内使用,可继续隐藏在内容层

整理后重新做一次结构验收

文件拆分完成后,先从根文件编译,而不是分别验证每个片段。然后执行一条完整主流程,确认 INCLUDE 没有遗漏、跳转目标仍存在、变量只声明一次,并检查所有被游戏侧依赖的稳定名称是否保持不变。

如果整理过程中必须重命名公开入口或主状态,不要只做全文替换;还要同步检查游戏代码、存档字段映射和自动化测试。相反,内部节点重命名只要编译和剧情验收通过,就不应要求游戏侧跟着修改。

最终可维护的剧情文件应该满足一个直接标准:编剧可以在任务模块内自由改对白和内部节点,而游戏项目仍只依赖少量清晰、稳定、可搜索的入口与状态名称。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

整理可维护的剧情文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通