小地图寻路¶

用途¶

此节点将实时采集的小地图匹配到参考图，定位角色后按顺序前往目标点。需要提供可用参考图，缺失或不可用时输出 完成 = false。

目标统一填写目标描述，支持桌面窗口、屏幕或安卓实例。校准数据可由通用游戏组件提供；二维游戏也可直接使用二维游戏寻路。

Shift+A → 宏 → 小地图寻路

节点需要打开详情编辑器完成配置（双击节点或选中后按详情编辑进入）。

节点循环采集小地图、在参考图中定位并发出移动操作。全部目标完成时输出 完成 = true；普通识别或寻路失败时输出 false，两种结果都走执行输出。任务取消、资源和参数错误仍按错误处理。

遍历终点固定停稳确认，其他目标可按需勾选“谨慎点”。设当前点的到达半径为 R：需要精准停稳的点在距离不大于 2.5R 时进入谨慎阶段；非终点距离大于 3R 时退出，终点仍保持谨慎确认。到达仍以 R 判定。自动规划生成的内部路点不会继承终点标记。

端口	类型	必填	说明
执行输入	执行	是	开始目标点路线。
目标描述	字符串	否	单一目标端口，填写或连接窗口、屏幕、安卓实例的目标描述；留空自动选择可用安卓实例。
参考图	图像	是	可通过连线或节点内保存的素材提供，供小地图匹配定位。
地图玩家图标	图像	视配置	按方向识别配置提供；有朝向时模板应朝上。
置信阈值	数值	否	定位判定阈值。
组件目标组	数组	否	组件目标描述字符串数组，提供校准基础。
白色通行遮罩	图像	视配置	自动规划使用的通行遮罩。

编辑器内主要分区：

“场景”可选择三维或二维。三维场景按配置识别角色朝向并控制视角；二维场景在不旋转的地图上定位，不依赖玩家朝向与视角拖拽，也不使用跳跃恢复。二维移动按轮盘、四向/八向能力和慢走配置执行；需要使用游戏本身的可穿墙位移时，在组件中明确启用该能力。

白色通行遮罩输入为索引 6。自动规划时使用与参考图对齐的遮罩；连接的图像会作为本次运行的遮罩输入，不能只把图像放在画布旁边而不连接。

在目标点区按顺序添加、选择和调整目标点；使用通行遮罩自动规划时，导入或更换与参考图对齐的通行遮罩。更换参考图后，已保存的目标点和搜索范围仍沿用原坐标，应确认新旧图对齐。

每个目标点的到达范围默认锁定并跟随统一值。点击锁图标可解锁：初始独立值取当前统一值，随后可单独修改；重新锁定后恢复跟随统一值。输入框旁标明使用原图像素还是处理后像素，设置时按该标注填写。

端口	类型	说明
执行输出	执行	路线成功或业务失败后继续。
完成	布尔	是否成功完成目标路线。
导航状态	字符串	本次导航结果。
规划路径 JSON	字符串	本次规划路径的 JSON 文本。
更新组件目标组	数组	本次寻路输出的组件目标描述字符串数组，可供后续节点使用。

小地图和移动组件应完整；三维场景还需配置实际使用的视角与朝向信息。可选的奔跑、慢走键、跳跃或二维位移按场景与主要组件选择使用。慢走策略与轮盘能力见通用游戏组件。到达半径只判断导航目标是否到达，不代表游戏已经显示交互按钮；需要交互时，应将目标点和到达范围放在游戏实际可交互区域内，再用识别与分支确认。