996引擎npc脚本跳转GOTO命令详解 - 标签段分支跳转配置教程

写NPC脚本时，一段主流程经常要按条件跳到不同标签段处理，比如玩家点不同按钮走不同分支。早期我只会用最朴素的GOTO跳到固定段，分支一多就乱，后来摸清了npc脚本跳转的几个命令分工：普通GOTO跳本NPC标签段、GOTOLABEL触发别人、RandomGoto按几率跳转。这篇把996引擎npc脚本跳转这组命令的格式、参数和跳转配置方法整理出来。

npc脚本跳转不是单指某一条命令，而是GOTO、GOTOLABEL、RandomGoto、DELAYGOTO这一组跳转触发命令的统称。它们解决的是同一个问题：让脚本从当前位置跳到指定标签段执行。区别在于跳谁、按什么条件跳、跳过去之后还能不能传参数。跳转配置做顺了，NPC对话分支才不会互相穿插。

命令格式

最基础的GOTO命令就是跳到本脚本里已有的标签段，格式只有命令加一个段名：

GOTO @标签段名

跨范围触发别人用GOTOLABEL，格式按模式不同分好几种，原文是这样列的：

GOTOLABEL 0 @小组成员触发 是否包含自己 传递变量1 传递变量2 传递变量3 传递变量4
GOTOLABEL 1 @行会成员触发 是否包含自己 传递变量1 传递变量2 传递变量3 传递变量4
GOTOLABEL 2 @当前地图的人物触发 是否包含自己 传递变量1 传递变量2 传递变量3 传递变量4
GOTOLABEL 3 @指定范围人物触发 X Y 范围 是否包含自己 传递变量1 传递变量2 传递变量3 传递变量4

GOTOLABEL后面的数字是模式，0到8分别对应小组、行会、当前地图、指定范围等不同触发对象，后面跟触发标签段名，再跟是否包含自己和四个可空的传递变量。随机跳转则用RandomGoto，格式是随机数母、随机数子加触发字段。

参数速查

RandomGoto的参数规则要单独记：随机数母和随机数子比较，子数值越大几率越高，子和母一样大就是百分百几率；多个触发字段用竖线隔开。DELAYGOTO则是时间加触发段加换地图是否删除，时间单位毫秒。

操作步骤

配置一段跨范围跳转，按下面几步走：

第一步，先把目标触发段写好，比如[@小组成员触发]，确认这段里用SENDMSG输出内容能正常显示。

第二步，在主段[@main]里用MOV把坐标和玩家名先存进变量，原文例子是先把X坐标、Y坐标和当前角色名各存入一个变量，供后面GOTOLABEL传递使用。

第三步，写GOTOLABEL命令，选好模式号和触发段名，把是否包含自己设成1不包含自己，再把n1、n2、S1作为传递变量带过去。

[@main]
#IF
#ACT
mov n1 <$X>
mov n2 <$Y>
mov S1 <$USERNAME>
GOTOLABEL 0 @小组成员触发 1 n1 n2 S1
GOTOLABEL 3 @指定范围人物触发 <$X> <$Y> 12 1 n1 n2 S1

[@小组成员触发]
#ACT
SENDMSG 6 对方名称<$STR(S1)>，坐标X:<$STR(N1)> Y:<$STR(N2)>

同类命令对比

GOM引擎也有GOTO和GOTOLABEL，写法接近，但996引擎在GOTOLABEL上扩展得更细。GOM版GOTOLABEL一般只按行会、小组这种粗粒度触发，996引擎把模式细分到0到8，连指定范围里攻击模式不一样的人都能单独触发，还多了GOTOLABELEX按QF脚本或当前NPC脚本选择触发位置。做npc脚本跳转时，别把GOM的模式号直接搬过来对号入座，两边模式定义不一样，搬过去容易触发错对象。

随机跳转这边，RandomGoto和RANDOMEX几率算法一致，但RandomGoto支持直接跳到触发字段。按原文提示，触发字段要按脚本顺序写，如果把百分百几率的字段写在前面，后面几个低几率字段永远不会触发，这是配置随机奖励时最容易踩的顺序坑。

问题排查

1. 问：大退踢人后小退再上线，恢复段怎么没反应？

答：小退重连后走的是恢复触发段，很多人在这里直接写逻辑就不触发，正确做法是在QManage.txt的[@RESUME]段加DELAYGOTO延时跳转，比如DELAYGOTO 1000 @恢复处理，给恢复段一点缓冲时间再跳转，否则小退回来那段脚本会没反应。（来源：BLUE官方常见问题，2024-08检索，已去隐私）

2. 问：怎么用脚本解决人物挂机发呆、站着不动的问题？

答：可以用机器人脚本定时检测人物坐标是否变化，长时间不动就判定发呆，然后先停止挂机再重新激活挂机。这类思路配合跳转命令做状态切换：检测到发呆就GOTO到重新激活段，和DELAYGOTO配合能把挂机掉线后的自动恢复串起来。（来源：MirCoding，2026-09检索，已去隐私）

3. 问：传奇人物在线改名的脚本应该怎么写？

答：一般用弹窗让玩家输入新名称，再用长度检测判断输入是否合法，接着用等值检测判断新名有没有被占用，都通过后再执行改名并更新名字数据。跳转命令在里面负责把校验失败的分支弹回去重输，和GOTO配合能把输入、校验、改名几个段串成一条线。（来源：CSDN，2021-01检索，已去隐私）

4. 问：GOTOLABEL传递过去的变量，在目标段里怎么取？

答：传递变量和接受变量用的是同一个变量名，传过去哪几个变量，目标段里就用对应的STR变量把它们取出来。原文例子里对方名称和坐标就是这么显示的，不要把接收变量名改成别的，否则取不到值。

5. 问：DELAYGOTO延时跳转中途换地图会失效吗？

答：这取决于第三个参数。DELAYGOTO格式是时间、触发字段、换地图是否删除此延时，填0或为空表示换地图不删除、延时照样执行，填1表示换地图就删除这个延时。不想让玩家换地图后还触发，就把第三参数设成1。

6. 问：RandomGoto为什么写了三个触发字段却只触发其中一个？

答：这是正常设计。RandomGoto按脚本顺序触发，每次只触发一个字段；没有百分百几率时甚至可能一个都不触发。要注意把百分百几率的字段写在后面，否则它在前面会直接短路，后面低几率字段永远轮不到。

总结

npc脚本跳转靠GOTO、GOTOLABEL、RandomGoto、DELAYGOTO这组命令分工：GOTO跳本NPC段，GOTOLABEL按0到8模式跨范围触发并能带变量，RandomGoto按几率跳，DELAYGOTO延时跳。配置时先写好目标段、再MOV存参、最后写跳转命令，注意996引擎的模式定义和GOM版不一样，别直接照搬。需要更多996引擎脚本命令解析，可以继续关注本站文章。

GOTO与GOTOLABEL的跳转示例在本地单机环境跑通，仅供学习调试参考，跨引擎或换版本前建议自己再测一遍。