旧版编辑器 · 节点类型

这里的「旧版编辑器」指当前线上在用的整套宇宙编辑器体系—— 策划在 UE 里摆的行为树、挂在节点上的行为与条件、以及客户端对应的执行器。 新一代编辑器另开一页（新版编辑器），等资料齐了再同步。

本页是第一批内容：节点类型说明。先把「策划能摆出来的东西一共有几类、各自什么语义、 谁来执行」讲清楚，其余章节（保存格式、导表、调试）后续补。

1. 先分清三层：树 / 节点 / 挂载物

策划打开编辑器看到的东西，代码里其实是三层，三层各有一套枚举，谁也不是谁。 排查「策划说找不到这个」的时候，第一步就是判断他说的是哪一层。

2. 13 种行为树节点（EBtNode）

定义在 UniverseEditor/Interface/IQuest.ts， 同文件里的 nodeTips 就是策划在编辑器里悬停看到的原文。 按「能挂几个子节点」分三组，这个分组直接决定了树能怎么搭：

// IQuest.ts:1374 —— 结构约束就写在类型里
export type TOneChildBtNode    = IAlwaysFalseBtNode | IAlwaysTrueBtNode | IRepeaterBtNode | IStartBtNode;
export type TManyChildrenBtNode = IParallelSelectBtNode | ISelectBtNode | ISequenceBtNode;
export type TLeafBtNode        = IActionBtNode | IChildQuestBtNode | IConditionBtNode
                                | IQuestFailedBtNode | IQuestSucceedBtNode;

2.1 单子节点（4 种）

2.2 Repeater 的六个字段

循环节点是单子节点里字段最多、也最容易配错的一个：

2.3 多子节点（3 种）+ 分支选择

ParallelSelect 的 Cnt 字段：0 表示要求全部完成，>0 表示完成对应个数即可。

ConditionSelector 结构上不是 Children[] 而是 Slots[]， 每个 slot 是 { Node, Condition } 一对——分支和它的进入条件绑在一起：

export interface IConditionSelectorBtNodeSlot {
    Node: TBtNode;
    Condition: IConditionGroup;
}

2.4 四个逻辑节点共享的一批字段（ILogicBtNode）

Sequence / Select / ParallelSelect / ConditionSelector 都继承 ILogicBtNode， 所以它们身上挂着一批和流程无关、但很关键的字段。 找不到某个功能配在哪，先来这里翻一遍：

2.5 叶子节点（5 种）

2.6 ChildQuest 节点的字段（最厚的一个）

3. 行为节点内容物：EAction（105 个）

Action 节点和 ChildQuest 的进入/退出钩子里挂的，都是 IActionInfo[]。 枚举定义在 Interface/IAction.ts，配置表在 Common/Operation/Action.ts 的 actionConfig。

3.1 actionConfig 的字段，决定节点「摆得出来吗」

// Common/Operation/Action.ts
interface IActionItem {
    ImplementType: 'Client' | 'Server';
    Context?: TActionContextType[];              // entity / levelPlay / quest / wildEvent / gm
    RestrictedMapContext?: 'DungeonOnly' | 'WpOnly';  // 限副本 / 限大世界
    IsTest?: boolean;                            // 非测试模式下会被过滤掉
    ContextForTest?: TActionContextType[];       // 测试阶段额外开放的上下文
    IsAbandoned?: boolean;                       // 废弃标记
    Tags?: string[];                            // 分类标签，如 ['HotFix']
}

Context 的分布（一个行为可以同时属于多个上下文）：

4. 子任务节点内容物：EChildQuest（50 种）

ChildQuest 节点的 Condition.Type，决定这个步骤「等的是什么」。 枚举在 IQuest.ts，一共 50 项：击杀、到达区域、交互、等待时间、比较变量、检查刷怪器剩余数、爬塔星级……

4.1 客户端只实现了 17 种，其余 33 种兜底给服务器

// Game/Module/GeneralLogicTree/Define/NodeTypeDefine.ts
public static readonly ChildQuestNodeType: Record<EChildQuest, NodeTypeData> = {
    [EChildQuest.DoInteractNew]:  new NodeTypeData(InteractNewBehaviorNode),      // 客户端专属实现
    [EChildQuest.ReachArea]:      new NodeTypeData(ReachAreaBehaviorNode),
    [EChildQuest.TowerClimb]:     new NodeTypeData(TowerClimbNode),
    // …… 共 17 个有专属节点类

    [EChildQuest.Kill]:           new NodeTypeData(ServerAchieveChildQuestNode),  // 服务器判定，客户端只收结果
    [EChildQuest.CompareVar]:     new NodeTypeData(ServerAchieveChildQuestNode),
    // …… 共 33 个走这个兜底类
};

4.2 有客户端专属实现的那 17 种（按用途分）

5. 判断条件：ECondition（76 种）

Condition 节点、ConditionSelector 的分支条件、 Repeater 的退出条件，用的都是 IConditionGroup，里面是 ECondition。

6. 客户端这边谁在执行

7. 加一个节点要动几处（速查）

8. 待补清单

本页目前只写了节点类型。后面按这个顺序补（顺序可调）：