游戏叙事与剧情 / 系统课时
整理可复用的状态规范
整理可复用的状态规范
当剧情链已经能跑通,真正影响后续维护的往往不是“还能不能加一个字段”,而是团队是否用同一套规则新增、修改、存档和排查状态。本节把这些约定收敛成可执行规范,让新剧情接入时不再依赖口头记忆。
学习目标
- 为剧情状态建立稳定的字段命名、类型和归属规则
- 把状态修改统一收口到事件入口,并明确存档版本迁移方式
- 用审计记录和校验代码让问题能够复现、定位和回归验证
先统一字段的语义边界
状态字段首先要回答“谁负责、表示什么、能否直接改”。同一含义不要同时出现 trust、favor、npcLike 这类近义字段,否则条件判断很快会失去统一口径。
布尔值建议使用能直接读出事实的名字,例如 hasMetGuide;计数值表达可累积结果,例如 guardTrust;枚举字段表达互斥状态,例如 route: "neutral" | "rebel"。用于存档协议的系统字段,如 schemaVersion,应与业务状态分开管理,避免被普通剧情逻辑修改。
还要明确字段所有权。角色关系、任务进度、背包和全局路线可以属于不同状态域,但跨域逻辑不应直接同时改多个对象。更稳妥的做法是让一次剧情动作产生事件,再由唯一状态入口完成实际修改。
把所有修改收口到事件入口
如果 UI、对话脚本、战斗系统和调试面板都能直接写状态,任何一次异常都很难回答“是谁改的”。团队规范应明确:读取可以分散,写入必须收口。
一次标准写入可以按“命令或交互 → 领域事件 → 前置校验 → 状态归约 → 审计记录 → 存档”执行。这样条件校验、幂等处理和日志格式只需要维护一份。

事件名应描述已经发生的事实,例如 npc.met、choice.selected、item.obtained。事件负载只携带完成这次变更所需的数据,不把整份状态塞进去。这样既方便重放,也能在日志中直接看出状态为何变化。
把事件、存档和迁移写成协议
存档不是某个对象的临时序列化结果,而是长期兼容协议。每份存档都应带 schemaVersion,加载时只允许按已知版本逐级迁移,例如 1 → 2 → 3,而不是在业务代码中散落“如果字段不存在就补一个默认值”的兼容分支。
事件也要保持稳定。已经进入线上存档或审计日志的事件名称不要随意重命名;确需变化时,应新增事件版本或在读取层做明确转换。对于删除字段,同样先提供迁移规则,再移除运行时代码,避免旧存档直接失效。
用代码把规范变成门禁
规范如果只能靠评审记忆,很快就会被绕过。下面的 TypeScript 示例把“只能通过事件修改状态、非法变更立即拒绝、每次修改留下审计记录”固化为一个统一入口。
type Route = "neutral" | "rebel";
type GameState = {
schemaVersion: 1;
hasMetGuide: boolean;
guardTrust: number;
route: Route;
};
type StoryEvent =
| { type: "npc.met"; npc: "guide" }
| { type: "guard.trust.changed"; delta: number }
| { type: "route.selected"; route: Route };
type AuditRecord = {
eventType: StoryEvent["type"];
before: GameState;
after: GameState;
};
function applyEvent(
state: GameState,
event: StoryEvent
): { state: GameState; audit: AuditRecord } {
const before = { ...state };
let after: GameState = { ...state };
switch (event.type) {
case "npc.met":
after.hasMetGuide = true;
break;
case "guard.trust.changed":
after.guardTrust += event.delta;
break;
case "route.selected":
if (!after.hasMetGuide) {
throw new Error("route.selected requires hasMetGuide=true");
}
after.route = event.route;
break;
}
if (after.guardTrust < -100 || after.guardTrust > 100) {
throw new Error("guardTrust must stay within [-100, 100]");
}
return {
state: after,
audit: { eventType: event.type, before, after: { ...after } }
};
}
let state: GameState = {
schemaVersion: 1,
hasMetGuide: false,
guardTrust: 0,
route: "neutral"
};
for (const event of [
{ type: "npc.met", npc: "guide" },
{ type: "guard.trust.changed", delta: 20 },
{ type: "route.selected", route: "rebel" }
] satisfies StoryEvent[]) {
const result = applyEvent(state, event);
state = result.state;
console.log(result.audit.eventType, JSON.stringify(state));
}预期输出:
npc.met {"schemaVersion":1,"hasMetGuide":true,"guardTrust":0,"route":"neutral"}
guard.trust.changed {"schemaVersion":1,"hasMetGuide":true,"guardTrust":20,"route":"neutral"}
route.selected {"schemaVersion":1,"hasMetGuide":true,"guardTrust":20,"route":"rebel"}这段入口并不要求所有项目都采用同样字段,但它体现了可复用规范的关键点:事件类型有限、变更路径唯一、约束集中、结果可审计。之后新增字段时,应同步更新类型、事件、校验和迁移,而不是只在某个剧情脚本里临时赋值。
让排障记录能够被别人复现
状态问题的排障记录至少要回答四件事:使用哪份存档、触发了什么事件、修改前后关键字段是什么、最终违反了哪条规则。只写“第三章分支错了”几乎没有复现价值。
团队可以固定一条缺陷记录格式:saveId、schemaVersion、最近事件序列、关键状态快照、预期结果和实际结果。涉及隐私或体积较大的字段时,只记录定位所需的最小集合,不要无差别打印整份用户存档。
真正可复用的状态规范不是一张命名表,而是一条闭环:字段有唯一语义,修改有唯一入口,事件有稳定协议,存档有明确版本,异常有可复现证据。只要新增剧情仍沿这条链路进入系统,分支数量增长也不会把状态管理重新变成不可追踪的临时规则。