游戏叙事与剧情 / 系统课时
把长故事拆成可读模块
把长故事拆成可读模块
当一个 Ink 文件同时塞进角色对话、地点事件、任务流程和章节推进时,真正的问题不是文件太长,而是边界消失。本节用 INCLUDE 和稳定的 knot 边界拆分脚本,让每个文件只承担一种明确职责,同时保持跨文件跳转可追踪。
学习目标
- 按剧情职责划分文件,而不是按行数机械切割
- 使用
INCLUDE组织多文件 Ink 故事并保持 knot 名称稳定 - 建立能降低跨文件耦合的模块边界
先决定模块边界
拆文件时优先看“谁拥有这段剧情”。地点文件适合承载进入地点后发生的事件,角色文件适合承载角色自身的会话节点,任务文件适合保存任务状态推进。章节入口只负责串联这些模块,不重复实现它们的内部细节。
一个实用原则是:文件边界可以变化,公开 knot 边界要稳定。其他模块只跳转到少量明确入口,例如 market_entry、merchant_intro,不要依赖对方文件内部大量临时节点。

用 INCLUDE 组成最小多文件故事
下面三个文件共同组成一个可运行示例。把它们放在同一目录中,并从 main.ink 启动或编译。
main.ink 只负责引入模块和定义章节入口:
INCLUDE market.ink
INCLUDE merchant.ink
-> chapter_start
=== chapter_start ===
你抵达港口市场。
-> market_entrymarket.ink 拥有地点入口,并在地点流程结束时跳到角色公开入口:
=== market_entry ===
摊位已经开张,商人正在整理货箱。
-> merchant_intromerchant.ink 只处理商人的对话节点:
=== merchant_intro ===
“第一次来港口吗?”商人抬头问你。
* [问路]
“沿着钟楼方向走,就能到旧城区。”
-> END
* [离开]
你点点头,转身离开市场。
-> END预期结果
你抵达港口市场。
摊位已经开张,商人正在整理货箱。
“第一次来港口吗?”商人抬头问你。
1: 问路
2: 离开不同运行器对选项编号或展示样式可能不同,但正文顺序应先经过 chapter_start、market_entry,再进入 merchant_intro。
避免按角色、地点重复保存同一状态
模块化最容易出现的坏味道,是为了“文件自治”把同一个任务状态复制到多个文件。例如地点文件维护一个 parcel_done,角色文件又维护一个同义变量,之后两者很容易失步。
共享状态应只定义一次,由多个模块读取或修改;模块边界解决的是代码组织问题,不是让每个文件拥有一套重复世界状态。真正需要隐藏的只是内部流程节点,而不是复制数据。
控制跨文件跳转数量
如果一个文件有十几个 knot 被其他文件直接跳入,它实际上已经没有清晰边界。优先暴露少量入口 knot,让模块内部自己决定后续路线。这样重命名内部节点、调整对话顺序或拆分子流程时,调用方通常不需要修改。
当故事继续增长时,可以继续按地点、角色、任务或剧情阶段拆分,但不要同时采用四种维度交叉复制同一段内容。选择“最能说明谁负责维护这段剧情”的维度作为主边界,其他维度通过跳转和共享状态协作即可。