3K引擎实现跨地图自动寻路不需要A星算法或客户端插件，核心依靠三个命令和三个文件的配合。整套机制在服务端脚本层面完成，玩家点击NPC或任务按钮即可触发从一张地图走到另一张地图指定坐标的全自动行走。
## 核心命令与原理
跨地图寻路依赖两条命令交替执行。AUTOGOTOXY负责在当前地图内自动行走至指定坐标，格式为`AUTOGOTOXY X坐标 Y坐标`，也支持带地图参数的完整格式`AUTOGOTOXY 地图名 X坐标 Y坐标`。MAPMOVE负责跨地图传送，格式为`MAPMOVE 地图编号 X坐标 Y坐标`，将玩家直接移至目标地图的指定坐标。
单张地图内的行走只靠AUTOGOTOXY就能完成。跨地图的难点在于：MAPMOVE传送过去之后，玩家需要继续在新地图内自动行走，但脚本执行到MAPMOVE就已经结束了，无法自动衔接后续的AUTOGOTOXY。3K引擎的解决方案是利用MapEvent.txt中的地图事件触发，当玩家到达新地图的特定坐标时自动调用QFunction-0.txt中的脚本段，在那里执行下一段AUTOGOTOXY。
整个流程的控制依赖变量标记。脚本通过`check`和`set`命令读写个人变量，记录当前进行到哪一步，防止重复触发或逻辑混乱。
## 三个核心文件的协同
跨地图寻路涉及三个文件的修改，缺一不可。
QMission-0.TXT文件位于`Mir200\Envir\Market_Def`目录下，是任务系统的入口文件。玩家点击任务按钮后从这里开始执行，脚本中通过MAPMOVE传送玩家到起始地图，再通过AUTOGOTOXY开始第一段自动行走。
MapEvent.txt文件位于`Mir200\Envir`目录下，定义地图事件触发条件。每一行配置一个触发点，格式为地图号、坐标X、坐标Y、范围、触发标识、触发条件、触发机率、事件类型和调用的脚本标签。
QFunction-0.txt文件位于`Mir200\Envir`目录下，存放被MapEvent.txt调用的脚本段。地图事件触发后跳转到这里执行AUTOGOTOXY，完成新地图内的自动行走。
这三个文件的执行链路是：玩家触发QMission脚本→MAPMOVE传送至目标地图→玩家自动走到MapEvent设定的坐标点→MapEvent触发→跳转QFunction执行下一段AUTOGOTOXY。
## 具体实现范例
以下脚本实现从比奇城自动走到沃玛森林并继续行走到拾荒者附近。
在QMission-0.TXT中增加入口脚本：
```plaintext
[@主线任务]
测试篇 <自动寻路/@自动寻路>\
#ACT
break
[@自动寻路]
#IF
check [410] 0
#ACT
set [410] 1
MAPMOVE 0 337 112
#IF
check [410] 1
#ACT
AUTOGOTOXY 324 34
set [411] 1
#SAY
这是测试自动寻路：从比奇进入沃玛森林\
进入沃玛森林后，再自动行走一段距离。
```
这段脚本先判断变量[410]是否为0，为0说明还没开始过，将其设为1并通过MAPMOVE传送至地图0的坐标337,112（比奇城）。紧接着判断[410]是否为1，成立后执行AUTOGOTOXY走向324,34，同时将[411]设为1，标记已进入沃玛森林阶段。
在MapEvent.txt中增加触发配置：
```plaintext
1 560 554 5 -1:1 4:*:0 0 1:@MapEventWalk9
1 560 554 5 -1:1 5:*:0 0 1:@MapEventWalk9
```
第一个数字1是地图编号，对应沃玛森林。560和554是触发坐标，范围5表示玩家走到坐标560,554周围5格内即触发。`-1:1`中-1表示不需要特定物品，1表示需要组队状态或单人。`4:*:0`中的4表示走路触发，冒号后的星号表示不限制物品，0表示不需要特定条件。最后的`@MapEventWalk9`是要调用的脚本标签。第二行配置相同坐标但触发条件为5，即跑步触发，确保玩家走路或跑步进入该区域都能触发。
在QFunction-0.txt中增加对应的响应脚本：
```plaintext
[@MapEventWalk9]
#if
check [411] 1
#ACT
AUTOGOTOXY 560 540
reset [410] 2
break
```
当玩家走到沃玛森林的560,554附近触发地图事件后，脚本检查变量[411]是否为1。成立则执行AUTOGOTOXY走向560,540，到达后通过`reset [410] 2`将变量[410]清零，完成整个寻路流程。`reset`命令与`set`命令配合使用，前者用于变量归零，后者用于赋值。
## 寻路到NPC并自动打开对话框
如果目标是走到某个NPC旁边并自动弹出对话框，3K引擎提供了MOVETOCELL命令。格式为`MOVETOCELL X坐标 Y坐标 NPC名字`，NPC名字参数可省略，若填写且NPC存在，玩家到达目标坐标后会自动点击该NPC打开对话框。
```plaintext
[@寻找英雄特使]
#IF
#ACT
AUTOGOTOXY 183 324
MOVETOCELL 183 324 英雄特使
```
先用AUTOGOTOXY走到NPC附近坐标，再用MOVETOCELL执行精确移动并触发点击。两个命令搭配使用可以覆盖更远的距离和更复杂的路径。
## 变量在跨地图寻路中的作用
跨地图寻路脚本最容易出问题的地方就是变量管理。上述范例中使用了[410]和[411]两个变量。[410]是总控变量，初始为0，玩家第一次点击自动寻路按钮时设为1，表示寻路流程已启动。到达沃玛森林后清零为0，表示流程结束。[411]是阶段标记变量，在比奇城内执行AUTOGOTOXY时设为1，MapEvent触发时检查这个变量来决定是否执行后续行走。
如果变量设置混乱，常见的问题是玩家走到MapEvent触发点后没有任何反应，或者重复触发导致角色在地图上反复行走。排查时首先确认MapEvent.txt中的地图编号与MAPMOVE的目标地图编号一致，然后检查QFunction-0.txt中的变量判断条件是否与QMission-0.TXT中的变量赋值匹配。
另一个需要注意的点是MapEvent.txt中坐标范围和触发条件的设置。范围值设为0表示必须精确站在该坐标上才能触发，设为5表示周围5格内均可触发。实际使用中建议设为3到5，避免玩家因为路径偏差而无法触发。
## M2引擎端的地图事件开关
MapEvent.txt配置完成后，还需要在M2引擎端启用地图事件触发功能。打开M2Server程序，进入选项菜单，找到功能设置中的基本设置，勾选启用地图事件触发。如果这个开关没有打开，MapEvent.txt中的所有配置都不会生效，玩家走到触发坐标也不会有任何反应。
部分版本的3K引擎在M2中还有单独的地图事件日志选项，开启后可以在M2控制台看到触发记录，方便调试时确认事件是否正常触发。
## 多段寻路的扩展写法
如果需要实现更长距离的跨地图寻路，比如从比奇到沃玛再到盟重，只需增加MapEvent触发点和QFunction响应段。每一段的地图切换通过MAPMOVE完成，每段地图内的行走通过AUTOGOTOXY完成，地图切换的衔接点通过MapEvent.txt中的配置来实现。
变量方面可以延续上述模式，每经过一个地图切换点就更换变量标记，确保脚本逻辑不会因为玩家中途下线或意外移动而错乱。建议在每个QFunction响应段中都加入`check`变量判断，只有持有正确标记变量的玩家才会触发后续行走，避免其他玩家路过触发坐标时被误触发。
