游戏叙事与剧情 / 系统课时
动作节点如何修改游戏状态
动作节点如何修改游戏状态
动作节点的职责不是“播放一段剧情”,而是把剧情意图可靠地转换成状态变更,例如发奖励、改变量、推进任务或发送事件。本课用统一动作执行器收口副作用,并重点处理执行顺序、失败边界和重复触发问题。
学习目标
- 区分动作数据、动作执行器与具体游戏系统的职责
- 设计发奖、改变量、任务推进和事件发送等常见动作
- 控制副作用范围,并避免节点重复执行造成重复发奖
动作节点是副作用入口
条件节点应该只读,动作节点则相反:它的存在目的就是修改状态。真正需要约束的是副作用从哪里发生。如果剧情播放器直接调用背包、任务、成就和事件总线,播放器会迅速变成无法测试的大型业务类。
更稳定的结构是让剧情节点只保存“要做什么”的数据,由 ActionExecutor 解释动作,再通过有限接口调用变量仓库、奖励系统、任务系统和事件总线。

动作层不应随意暴露整个游戏对象。越多系统可以被脚本任意调用,就越难知道一个剧情节点会改哪些状态。最好给动作执行器一组窄接口,只开放剧情确实允许做的操作。
先定义可审计的动作数据
动作数据应能被序列化,也要能在发布前校验。下面是一组常见动作:
[
{
"type": "setVariable",
"key": "story.reputation",
"value": 3
},
{
"type": "grantReward",
"rewardId": "reward-chapter-2"
},
{
"type": "advanceQuest",
"questId": "quest-main-02",
"targetState": "active"
},
{
"type": "emitEvent",
"eventName": "story.chapter2.started"
}
]这类数据比“执行任意脚本字符串”更容易审核,因为系统可以提前知道允许的动作类型、每个动作需要哪些字段,以及它可能修改哪些状态。新增动作类型时,也能明确评估保存、回滚和重复执行风险。
用统一执行器收口副作用
下面示例实现一个最小动作执行器。为了让示例可直接运行,四个业务系统用内存对象模拟;真实项目中可以替换成正式服务,但调用边界保持不变。
class ActionExecutor {
constructor(services) {
this.services = services;
this.executed = new Set();
}
executeBatch(executionId, actions) {
// 同一剧情动作批次只允许成功提交一次,避免重进节点后重复发奖。
if (this.executed.has(executionId)) {
return { status: "skipped", reason: "already-executed" };
}
for (const action of actions) {
this.executeOne(action);
}
this.executed.add(executionId);
return { status: "ok" };
}
executeOne(action) {
switch (action.type) {
case "setVariable":
this.services.variables[action.key] = action.value;
return;
case "grantReward":
this.services.rewards.push(action.rewardId);
return;
case "advanceQuest":
this.services.quests[action.questId] = action.targetState;
return;
case "emitEvent":
this.services.events.push(action.eventName);
return;
default:
throw new Error(`Unsupported action type: ${action.type}`);
}
}
}
const services = {
variables: {},
rewards: [],
quests: {},
events: []
};
const actions = [
{ type: "setVariable", key: "story.reputation", value: 3 },
{ type: "grantReward", rewardId: "reward-chapter-2" },
{ type: "advanceQuest", questId: "quest-main-02", targetState: "active" },
{ type: "emitEvent", eventName: "story.chapter2.started" }
];
const executor = new ActionExecutor(services);
console.log(executor.executeBatch("dialogue-42:choice-a", actions));
console.log(executor.executeBatch("dialogue-42:choice-a", actions));
console.log(JSON.stringify(services, null, 2));预期输出:
{ status: 'ok' }
{ status: 'skipped', reason: 'already-executed' }
{
"variables": {
"story.reputation": 3
},
"rewards": [
"reward-chapter-2"
],
"quests": {
"quest-main-02": "active"
},
"events": [
"story.chapter2.started"
]
}示例中的 executionId 是最小化的幂等保护。正式项目通常应把执行记录放在可持久化状态中,否则读档、切场景或进程重启后,内存集合会丢失,仍可能重复执行。
执行顺序和失败边界必须明确
一个动作批次里,顺序可能影响结果。例如先把任务设为 active 再发送“任务已开启”事件,监听者才能读到最新状态。反过来发送,监听者可能看到旧状态。因此动作数组应被视为有序命令,而不是无序集合。
更棘手的是中途失败。假设奖励已发放,但任务推进失败,如果直接重试整个批次,就可能再次发奖。常见处理方式有三类:
- 所有目标系统都支持事务时,使用统一事务提交。
- 无法跨系统事务时,让高风险动作本身支持幂等键,例如奖励服务按
executionId去重。 - 对可补偿动作记录执行进度,失败后从未完成步骤继续,而不是从头重放。
限制动作能力,避免剧情脚本越界
动作系统不应允许内容数据直接调用任意方法、访问文件或拼接反射调用。工程上更推荐白名单:每种 type 对应一个明确处理器,处理器只能获得完成该动作所需的最小服务。
例如 grantReward 不需要拿到任务系统,emitEvent 也不应该直接改玩家属性。这样做虽然多了一层处理器,但能让代码审查、自动测试和问题定位都更简单。
当剧情系统规模扩大后,真正可维护的不是“动作类型足够多”,而是每个动作的输入、修改范围、幂等策略和失败行为都能被清楚描述,并且所有副作用都经过同一个受控入口。