CommandGraph：基于节点的事件脚本

CommandGraph 是 MCE 的可视化脚本系统，用于创建 NPC 行为、过场动画、任务和交互事件。它提供基于节点的编辑器，你可以连接命令来定义事件序列——无需编写 C# 代码。

这是所有版本（包括无法访问源代码的 DLL 版本）的游戏设计师使用 MCE 时的主要工具。

什么是 CommandGraph？

CommandGraph 是附加到 Actor（世界中任何可交互实体）的节点图。当玩家触发 Actor（通过交互、踩上去或进入其区域），图表按顺序执行其节点。

可以将其理解为可视化脚本，每个节点是一个游戏动作：

[Start] → [Show Dialog] → [Branch: Has Badge?]
                              ├─ Yes → [Give Item] → [End]
                              └─ No  → [Show Dialog: "Come back later"] → [End]

创建你的第一个事件

步骤 1：创建 Actor

在场景中，在你希望放置 NPC 的位置创建一个空 GameObject。
添加 Actor 组件（或其变体之一：SimpleActor、TriggerActor）。
添加 SpriteRenderer 作为 NPC 的视觉表现。
Actor 将自动注册到 GridController。

步骤 2：打开 CommandGraph 编辑器

选择你的 Actor GameObject。
在 Inspector 中，找到 CommandGraph 部分。
点击 Edit Graph 打开节点编辑器窗口。

步骤 3：添加节点

在图编辑器中右键打开添加节点菜单。
节点按类别组织（见下文）。
选择节点类型将其添加到图中。
通过从一个节点的输出端口拖到另一个节点的输入端口来连接节点。

步骤 4：配置节点

点击节点在 Inspector 面板中查看其属性：

对话节点：输入要显示的文字、说话者名称和头像。
分支节点：选择要检查的游戏变量和比较方式。
道具节点：选择要给予/获取的道具及数量。
传送节点：设置目标场景和位置。

Actor 类型

MCE 提供多种 Actor 变体：

Actor 类型	触发方式	使用场景
`Actor`	玩家交互（面对时按互动按钮）	NPC、路标、物体
`SimpleActor`	玩家交互，简化设置	基础 NPC
`TriggerActor`	玩家踩上或进入区域	自动触发、隐藏事件
`GridSubscribingActor`	响应网格事件	压力板、近距离触发
`PushableActor`	玩家走向它时推动	巨石、谜题方块
`ActorItem`	玩家交互，给予道具后消失	地面上的道具拾取

节点类别

对话

显示文字、选择回复和管理对话。

节点	描述
ShowDialog	显示包含说话者消息的文本框
ShowChoiceDialog	向玩家展示多选项
ShowMonsterDialog	显示与怪兽相关的对话（展示精灵图）
CharacterPopUp	在 NPC 头顶显示弹出图标（!、?、...）

ShowDialog 示例：

Speaker: "Professor Elm"
Text: "Welcome to the world of monsters!"
Portrait: oak_portrait
Wait for Input: true

分支

根据条件控制流程。

节点	描述
BranchOnVariable	检查 GameVariable 并分支为是/否
BranchOnBadge	检查玩家是否拥有特定徽章
BranchOnItem	检查玩家是否拥有特定道具
BranchOnMonster	检查玩家队伍中是否有特定物种
BranchOnMoney	检查玩家是否有足够的金钱
BranchOnRosterCount	检查队伍中有多少只怪兽

每个分支节点有两个输出端口：True 和 False。

道具

管理玩家的物品栏。

节点	描述
GiveItem	向玩家背包中添加道具
TakeItem	从玩家背包中移除道具
GiveMonster	向玩家队伍中添加怪兽
GiveMoney	向玩家钱包中添加金钱
TakeMoney	从玩家钱包中扣除金钱

怪兽

与玩家的怪兽交互。

节点	描述
HealParty	完全治疗队伍中所有怪兽
SelectMonster	打开队伍界面让玩家选择怪兽
TeachMove	教授特定招式给怪兽
EvolutionCheck	触发所有队伍成员的进化检查
SetNickname	让玩家重命名怪兽

战斗

触发和配置战斗。

节点	描述
StartTrainerBattle	开始带有配置队伍的训练师战斗
StartWildBattle	开始与特定怪兽的野生遭遇
BranchOnBattleResult	检查玩家是否赢得了上一场战斗

变量

读写游戏状态。

节点	描述
SetVariable	将 GameVariable 设为某值
AddToVariable	向数值 GameVariable 添加值
CheckVariable	读取 GameVariable 的值用于逻辑判断

GameVariable 是全局状态系统。它们持久化在存档数据中，可以从任何 CommandGraph 或脚本中检查。

音频

控制音频播放。

节点	描述
PlayBGM	更改背景音乐
PlaySE	播放音效
StopBGM	停止当前音乐
FadeOutBGM	在一段时间内淡出音乐

动画

为角色和摄像机添加动画。

节点	描述
MoveActor	将 NPC 移动到目标位置
TurnActor	让 NPC 面向某个方向
WaitSeconds	暂停图表执行一段时间
FadeScreen	将屏幕淡出为黑色或淡入
ShakeScreen	震动摄像机

传送

在不同位置之间移动玩家。

节点	描述
TeleportPlayer	将玩家移动到当前场景的特定地块
WarpToScene	将玩家传送到另一个场景

任务（Pro 版本+）

管理任务进度。

节点	描述
StartQuest	开始一个任务
CompleteObjective	将任务目标标记为完成
FailQuest	使任务失败
BranchOnQuestState	检查任务的当前状态
GiveQuestReward	发放任务奖励

商店

打开商店界面。

节点	描述
OpenShop	使用配置的道具列表打开买卖商店 UI

存档

管理存档数据。

节点	描述
SaveGame	触发保存到当前栏位

工具

各种实用节点。

节点	描述
DeactivateActor	隐藏 Actor（例如给予道具拾取后）
EnablePlayer	启用/禁用玩家移动

连接节点

CommandGraph 使用基于流程的连接模型：

每个节点有一个输入端口（左侧）和一个或多个输出端口（右侧）。
将输出端口连接到另一个节点的输入端口以定义执行顺序。
分支节点有标记的输出端口（True/False、Choice1/Choice2 等）。
没有连接输出端口的节点会结束图表执行。

示例：商店 NPC

[Start]
  → [ShowDialog: "Welcome! Would you like to browse my wares?"]
    → [ShowChoiceDialog: "Buy" / "Sell" / "No thanks"]
      ├─ Choice 1 ("Buy") → [OpenShop: item_list_potions]
      ├─ Choice 2 ("Sell") → [OpenShop: sell_mode]
      └─ Choice 3 ("No thanks") → [ShowDialog: "Come back anytime!"]

示例：任务发布者

[Start]
  → [BranchOnVariable: "rescued_lost_monster" == true]
    ├─ True → [ShowDialog: "Thank you for finding my monster!"]
    │           → [BranchOnVariable: "quest_reward_given" == true]
    │             ├─ True → [ShowDialog: "Enjoy the TM!"]
    │             └─ False → [GiveItem: TM_Thunderbolt, 1]
    │                         → [SetVariable: "quest_reward_given" = true]
    │                         → [ShowDialog: "Take this as thanks!"]
    └─ False → [ShowDialog: "Please help me find my lost monster!"]
               → [ShowDialog: "It ran off into the cave to the north."]
               → [SetVariable: "quest_find_monster" = true]

示例：道馆馆主

[Start]
  → [BranchOnBadge: "BoulderBadge"]
    ├─ HasBadge → [ShowDialog: "You've already proven yourself!"]
    └─ NoBadge
      → [ShowDialog: "I am the Gym Leader! Prepare for battle!"]
      → [StartTrainerBattle: gym_leader_team]
      → [BranchOnBattleResult]
        ├─ Won → [ShowDialog: "Impressive! You've earned this."]
        │        → [GiveBadge: "BoulderBadge"]
        │        → [GiveItem: TM_RockTomb, 1]
        └─ Lost → [ShowDialog: "Train harder and come back!"]

测试事件

在编辑器中进入播放模式。
将角色走到 Actor 旁边。
按下互动按钮（默认：Z 键或手柄 A 键）。
CommandGraph 将执行，你可以观察流程。

调试模式

如果图表表现不如预期：

检查控制台中的错误。
验证引用的 GameVariable、道具和怪兽是否存在。
确保所有输出端口都已连接——未连接的分支会静默结束图表。
使用 Debug 节点（如果可用）在执行期间记录变量状态。

最佳实践

给 Actor 取描述性名称。"NPC_Professor_Lab" 比 "Actor (3)" 好得多。
使用 GameVariable 管理状态。不要仅依赖 Actor 的启用/禁用。
测试两个分支。每个 BranchOnVariable 的 True 和 False 路径都应该正常工作。
保持图表可读。使用空间布局使流程清晰。将相关节点分组放置。
复用模式。一旦你有了一个可工作的商店 NPC，复制并修改它以用于其他商店。
测试前保存。CommandGraph 的更改是场景级别的更改，如果 Unity 崩溃可能会丢失。

什么是 CommandGraph？​

创建你的第一个事件​

步骤 1：创建 Actor​

步骤 2：打开 CommandGraph 编辑器​

步骤 3：添加节点​

步骤 4：配置节点​

Actor 类型​

节点类别​

对话​

分支​

道具​

怪兽​

战斗​

变量​

音频​

动画​

传送​

任务（Pro 版本+）​

商店​

存档​

工具​

连接节点​

示例：商店 NPC​

示例：任务发布者​

示例：道馆馆主​

测试事件​

最佳实践​