游戏叙事与剧情 / 系统课时
多人协作怎样拆分剧情资源
多人协作怎样拆分剧情资源
多人同时改剧情时,最容易冲突的不是台词本身,而是入口文件、全局变量和 Unity 引用都混在一起。本节给出一套可落地的拆分边界:Ink 按内容域分文件,公共契约集中管理,Unity 只依赖编译产物与稳定入口。
学习目标
- 按“入口、公共契约、剧情模块”拆分 Ink 文件,减少多人同时改同一文件。
- 明确公共变量、Knot/Function 命名和 Unity 资源引用的责任边界。
- 用代码审查规则判断一次剧情改动是否越过了团队约定的边界。
先把冲突源分成三类
多人协作中的冲突通常来自三处:大量作者都要修改的总入口、被多个章节共享的变量与函数、以及 Unity 场景或脚本直接引用具体剧情文件。真正有效的拆分不是“一个人一个文件”,而是让高频改动尽量落在彼此独立的模块,同时把少量共享内容收敛到明确的公共层。

推荐把职责拆成三层:main.ink 只负责汇总与默认入口;globals.ink 只放跨模块共享且需要长期稳定的变量、常量约定或公共函数;具体剧情放到按场景、章节或功能域划分的独立文件。这样普通台词修改不会频繁碰到总入口和公共契约。
用稳定入口组织 Ink 文件
下面是一个最小的拆分示例。它是片段示例,需要把这些文件放在同一 Ink 工程中,由 main.ink 统一编译。
// main.ink
INCLUDE globals.ink
INCLUDE prologue.ink
INCLUDE market.ink
-> prologue
// globals.ink
VAR trust = 0
VAR has_key = false
// prologue.ink
=== prologue ===
你在清晨抵达城门。
~ trust = trust + 1
-> market
// market.ink
=== market ===
集市已经开始营业。
-> END这个结构里,作者修改 prologue.ink 时通常不需要碰 market.ink。只有新增跨章节状态时才修改 globals.ink;只有新增顶层模块、调整默认入口或改变装配顺序时才修改 main.ink。公共文件因此天然成为“低频、高审查”的资源。
Knot、Function 和共享变量名也要视为跨模块 API。已经被 Unity 或其他 Ink 模块引用的名字,不应因为文案重构随意改名;需要改时,应像改代码接口一样先检索调用方,再一次性更新。
让 Unity 只依赖编译后的总故事
Unity 侧不要为每个作者维护的 .ink 文件建立独立运行时引用,否则文件拆分会泄漏到游戏代码。更稳妥的做法是只暴露编译后的总故事和稳定入口。下面这个 ScriptableObject 只保存运行时真正需要的契约。
using UnityEngine;
[CreateAssetMenu(menuName = "Story/Story Catalog")]
public sealed class StoryCatalog : ScriptableObject
{
public TextAsset compiledStory;
public string entryKnot = "prologue";
}这是配置数据结构,不单独产生控制台输出。验证时只需确认 compiledStory 指向由 main.ink 编译出的 JSON,运行剧情时由统一的故事控制器读取它,并通过 entryKnot 进入约定入口。以后即使把 prologue.ink 再拆成多个子文件,Unity 资源引用也不需要跟着变化。
给公共契约设置更严格的修改门槛
团队可以把文件按“普通内容”和“公共契约”设定不同审查级别。普通剧情模块允许作者独立提交;main.ink、globals.ink、Unity 故事目录资源和负责加载 Ink 的脚本则要求至少一名集成负责人审查。
审查公共变量时重点看三件事:名字是否已经存在、默认值改变是否会影响旧存档、删除或改名是否会让 Unity 读取失败。审查入口与 Knot 时则检查是否仍可从总入口到达、是否被 Unity 直接跳转、是否存在重复命名。
一次合并前该检查什么
提交前先确认自己只修改了职责范围内的文件;如果必须修改公共契约,要在同一个提交中同步 Unity 调用方、测试和存档迁移说明。合并请求中应明确列出新增或变更的共享变量、入口名与 Tag 契约,让审查者不必从大量台词差异里寻找接口变化。
这套拆分的核心不是追求文件越多越好,而是让高频内容变化局部化、公共契约少而稳定、Unity 只依赖编译后的总故事。做到这三点,多人并行写作时的文本冲突和集成风险都会明显下降。