游戏叙事与剧情 / 系统课时
大型项目怎样拆分剧情运行时
大型项目怎样拆分剧情运行时
剧情规模扩大后,如果执行条件、推进任务、播放对白、控制镜头和操作 UI 都集中在同一个剧情管理器里,任何新需求都会继续放大耦合。本课把运行时拆成核心执行器、领域适配层和表现层,并通过一个最小实现验证这些边界怎样支持扩展与跨项目复用。
学习目标
- 区分剧情核心执行、游戏领域能力与表现层各自应承担的职责
- 建立只向外声明意图、不直接依赖具体游戏系统的运行时核心
- 判断哪些模块适合跨项目复用,哪些逻辑必须留在项目适配层
先确定运行时真正需要做什么
剧情运行时的核心任务通常很少:读取当前节点、判断是否可以进入、执行节点语义、选择下一节点,并维护当前剧情状态。它并不天然需要知道 Unity、Unreal、任务系统、背包系统或具体 UI 的存在。
问题往往出在实现阶段。为了快速交付,核心执行器开始直接调用 QuestManager、InventoryService、摄像机、音频和界面对象。短期调用方便,长期却意味着任何领域系统变化都会迫使剧情核心一起修改。
大型项目更适合把依赖方向固定为:核心层描述“剧情想做什么”,适配层负责“在当前项目里怎样做到”,表现层负责“玩家怎样看到和操作”。

核心执行器只处理剧情语义
一个可复用的核心层应尽量使用与具体项目无关的数据。例如对白节点只产生“显示这句文本”的事件,动作节点只声明一个动作名称和参数。真正怎样弹出 UI、怎样完成任务,由外部实现决定。
下面的 Python 示例用三个类模拟这种拆分:NarrativeCore 推进节点,GameAdapter 执行项目领域动作,Presenter 负责显示对白。核心执行器没有直接操作任务系统或界面。
from dataclasses import dataclass
@dataclass(frozen=True)
class Node:
kind: str
value: str
next_id: str | None
class GameAdapter:
def run_action(self, action: str) -> None:
if action == "quest:start:harbor":
print("[domain] quest harbor started")
else:
raise ValueError(f"unsupported action: {action}")
class Presenter:
def show_line(self, text: str) -> None:
print(f"[ui] {text}")
class NarrativeCore:
def __init__(
self,
nodes: dict[str, Node],
adapter: GameAdapter,
presenter: Presenter,
) -> None:
self.nodes = nodes
self.adapter = adapter
self.presenter = presenter
def run_from(self, start_id: str) -> None:
current_id: str | None = start_id
while current_id is not None:
node = self.nodes[current_id]
if node.kind == "line":
self.presenter.show_line(node.value)
elif node.kind == "action":
self.adapter.run_action(node.value)
else:
raise ValueError(f"unsupported node kind: {node.kind}")
current_id = node.next_id
if __name__ == "__main__":
nodes = {
"intro": Node("line", "船已经靠岸。", "start-quest"),
"start-quest": Node("action", "quest:start:harbor", None),
}
runtime = NarrativeCore(nodes, GameAdapter(), Presenter())
runtime.run_from("intro")预期输出:
[ui] 船已经靠岸。
[domain] quest harbor started这个例子虽然很小,但已经体现了关键边界:剧情核心只识别节点语义;领域适配器负责把动作映射到当前项目;表现层负责把剧情事件转换为玩家可见结果。
领域适配层隔离项目差异
跨项目最容易变化的是任务、物品、属性、成就和存档接口。A 项目可能通过任务 ID 启动任务,B 项目可能需要调用状态机或 ECS 命令。如果这些差异都进入剧情核心,所谓“复用运行时”最终只是复制一份旧代码继续修改。
适配层应该承担协议转换。例如核心发出 quest:start:harbor 这样的领域意图,适配器再决定调用哪个任务接口。核心因此可以保持稳定,而各项目只需要实现自己的适配器。
表现层不要反向控制剧情规则
对话框、字幕、立绘、镜头和声音属于表现层。表现层可以接收“展示对白”“等待玩家选择”等事件,也可以把玩家选择反馈给核心,但它不应该自行决定某个剧情分支是否满足条件。
例如按钮是否可点击,可以展示核心已经计算出的结果;但“声望达到 20 才能选择该选项”这种业务判断应由条件系统或领域适配层完成。否则同一段剧情换成另一套 UI 时,很可能得到不同运行结果。
什么时候值得继续拆模块
拆分不是模块越多越好。只有当某个部分具有独立变化原因时,单独建立边界才有价值。节点执行和状态推进通常属于稳定核心;任务、背包、角色属性属于领域适配;UI、镜头、音频属于表现;数据格式迁移、热更新加载则可以进一步作为基础设施能力隔离。
当核心模块能够在不引用具体任务系统、UI 框架和引擎对象的情况下完成单元测试,并且更换项目时主要改动集中在适配层,就说明运行时边界已经具备实际复用价值。大型剧情系统的目标并不是造出一个巨大的万能框架,而是让每种变化尽量停留在自己的边界内。