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

动作节点如何修改游戏状态

动作节点如何修改游戏状态

动作节点的职责不是“播放一段剧情”,而是把剧情意图可靠地转换成状态变更,例如发奖励、改变量、推进任务或发送事件。本课用统一动作执行器收口副作用,并重点处理执行顺序、失败边界和重复触发问题。

学习目标

  • 区分动作数据、动作执行器与具体游戏系统的职责
  • 设计发奖、改变量、任务推进和事件发送等常见动作
  • 控制副作用范围,并避免节点重复执行造成重复发奖

动作节点是副作用入口

条件节点应该只读,动作节点则相反:它的存在目的就是修改状态。真正需要约束的是副作用从哪里发生。如果剧情播放器直接调用背包、任务、成就和事件总线,播放器会迅速变成无法测试的大型业务类。

更稳定的结构是让剧情节点只保存“要做什么”的数据,由 ActionExecutor 解释动作,再通过有限接口调用变量仓库、奖励系统、任务系统和事件总线。

剧情动作节点执行与副作用边界

动作层不应随意暴露整个游戏对象。越多系统可以被脚本任意调用,就越难知道一个剧情节点会改哪些状态。最好给动作执行器一组窄接口,只开放剧情确实允许做的操作。

先定义可审计的动作数据

动作数据应能被序列化,也要能在发布前校验。下面是一组常见动作:

json
[
  {
    "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"
  }
]

这类数据比“执行任意脚本字符串”更容易审核,因为系统可以提前知道允许的动作类型、每个动作需要哪些字段,以及它可能修改哪些状态。新增动作类型时,也能明确评估保存、回滚和重复执行风险。

用统一执行器收口副作用

下面示例实现一个最小动作执行器。为了让示例可直接运行,四个业务系统用内存对象模拟;真实项目中可以替换成正式服务,但调用边界保持不变。

js
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));

预期输出:

text
{ 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 也不应该直接改玩家属性。这样做虽然多了一层处理器,但能让代码审查、自动测试和问题定位都更简单。

当剧情系统规模扩大后,真正可维护的不是“动作类型足够多”,而是每个动作的输入、修改范围、幂等策略和失败行为都能被清楚描述,并且所有副作用都经过同一个受控入口。

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

目录与阅读设置

阅读设置

17

记录一个想法

动作节点如何修改游戏状态

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

登录哪都通