二维游戏寻路¶

用途¶

此节点在二维游戏画面中定位角色，并按目标点移动。可使用白色通行遮罩自动规划路线，也可沿手动设置的目标点行走。校准信息由通用游戏组件提供。

类型 ID 为 event.global_map_navigation，添加路径为 Shift+A → 宏 → 二维游戏寻路。

双击节点配置地图、路径和组件。二维模式不旋转地图，也不依赖玩家朝向或视角拖拽；参考图与实际画面应使用相同的地图几何。

输入端口¶

ADB 和桌面目标二选一，不能同时指定。保留上游输出的完整目标身份，不要把安卓实例信息拆成裸 ADB 地址。目标语法见目标描述。

路线与通行遮罩¶

• 手动目标点：按顺序设置路线，节点依次前往各点。
• 自动规划：提供与参考图对齐的通行遮罩，以白色区域表示可通行范围，再设置需要到达的目标。
• 到达范围：按编辑器标示的原图或处理后像素设置；更换参考图或处理缩放后，重新检查目标点、玩家模板和遮罩是否对齐。

遮罩可以连接到输入 7，也可使用节点中保存的配置。不要把小地图寻路的端口序号直接套到本节点：本节点的白色通行遮罩是输入 7，小地图寻路为输入 6。

移动组件¶

组件中的万向轮盘、四键轮盘与八向开关决定可用移动方式。支持半杆时优先使用半杆慢走；否则使用已启用的慢走键，或按配置执行方向脉冲。四向模式的斜向移动通过两轴交替脉冲完成，八向模式可同时按相邻方向。

二维导航不使用跳跃恢复。游戏本身支持穿墙位移时，可以配置“可穿墙位移”组件并设为主要组件，供二维导航使用；未启用该能力时仍按普通移动处理。组件不会让本来没有位移能力的游戏获得穿墙能力。

输出与后续交互¶

后续动作应先判断“完成”。到达一个坐标不代表已经取得物品或通过关卡；需要交互时，再用识别、点击和分支确认游戏状态。取消、参数和资源错误仍按错误处理。

最小示例¶

开始执行 → 二维游戏寻路 → 分支

先设置实例或窗口目标，连接参考地图、玩家图标与组件组。自动规划时补充白色通行遮罩，配置目标点后，根据“完成”决定交互或失败恢复路线。

相关内容¶

• 小地图寻路
• 通用游戏组件
• 目标描述