GOM引擎GOTO传参与GOTOLABEL群发传参怎么选 - 脚本参数回调区别

做脚本模块化的时候，我一直纠结一个问题：一段计算逻辑要在多个NPC里复用，是把代码复制粘贴到处贴，还是抽成一段公共跳转段让别人来调？后来发现GOM的goto带括号传参就能实现类似函数调用的效果，还能把算出来的值返回来。

GOTO传参回调解决的就是这个痛点：跳转时把参数传进去，跳转段处理完用return把结果返回到指定变量。它和GOTOLABEL群发触发传参长得像，但用途完全不同——GOTOLABEL是把同一段脚本广播给周围玩家跑，GOTO传参是当前脚本自己调子段并拿返回值。这就是脚本参数返回值的典型用法。下面把命令原型、参数拆解和实战配置讲清楚。

命令原型

带返回值的GOTO写法，在跳转段名后面加括号，括号里用竖线分成两半：竖线前面是传进去的参数，竖线后面是接收返回值的变量。

goto @段子段名(参数1,参数2|接收变量1,接收变量2)

被跳转的子段里，用<$scriptparam1>和<$scriptparam2>接收传进来的参数，处理完用return把结果返回出去，这就是return返回值保存到外部变量的机制。

[@子段名]
#act
formulation <$scriptparam1>*2 N$结果1
return <$str(N$结果1)>

官方给的完整示例是这样：

[@run]
#act
goto @test(1,2|N$返回值1,S$返回值2)
sendmsg 7 结果：<$str(N$返回值1)>,<$str(S$返回值2)>

[@test]
#act
formulation <$scriptparam1>*2 N$计算结果1
formulation <$scriptparam2>*2 N$计算结果2
MOV S$计算结果 参数2返回值：<$str(N$计算结果2)>
return <$str(N$计算结果1)> <$STR(S$计算结果)>

参数拆解

传参这部分拆解成三块：

这里讲的goto变量传参写法，关键在于return后面跟几个值，竖线后面就要对应几个接收变量，顺序一一对应。return同时起到break的作用，写完return之后，子段里后面的脚本行不会再执行。

需要和GOTOLABEL区分开。GOTOLABEL是群发触发命令，格式为GOTOLABEL 模式 触发字段 是否包含自己 传递变量1 传递变量2，它是把脚本同时跑给组队、行会或周围玩家，没有返回值概念，变量是双向共享的。两者都带传参字样，但一个是调子段拿返回值，一个是广播给多人跑。

避坑指南

第一个坑是return后面的值数量和接收变量数量对不上。传两个参数进去想拿两个返回值，return后面只写了一个值，另一个接收变量就保持原样不变。我早期漏写一个返回值，结果聊天框打印出来的第二个值是空的，排查了半天才发现。

第二个坑是return后面还继续写脚本。官方明确说明return等同break，写了return之后下面的行不会执行。我曾经在return后面又加了一行SENDMSG，怎么都不输出，删掉return才发现顺序问题。

第三个坑是把scriptparam当普通变量用。<$scriptparam1>只能在被跳转的子段内部读取，跳出子段后这个标记就失效了。它是临时占位符，不是N0S1那种全局变量。

第四个坑是传参时直接写算式。括号里传参只能写常量或已赋值的变量，不能在括号里写乘法算式。算式要放到子段内部用formulation去算。

实战配置

下面以把子段封装成输入一个数字返回它的两倍和说明文字为例，演示参数回调的完整配置。脚本放在D:\本地传奇版本\Mir200\Envir\Market_Def下。

第一步，在NPC主段里写goto调用，传入两个数字，竖线后指定两个接收返回值的变量。

[@main]
#act
goto @计算段(3,5|N$两倍结果,S$说明文本)
sendmsg 7 两倍结果：<$str(N$两倍结果)>，说明：<$str(S$说明文本)>

第二步，写[@计算段]，用<$scriptparam1>和<$scriptparam2>取传入参数，用formulation做乘法计算。

[@计算段]
#act
formulation <$scriptparam1>*2 N$计算1
formulation <$scriptparam2>*<scriptparam2> N$计算2

第三步，组装要返回的内容，第一个返回数字两倍，第二个返回一段说明文字。

MOV S$说明 第二个参数是<$str(N$计算2)>
return <$str(N$计算1)> <$str(S$说明)>

第四步，保存后重载NPC脚本，进游戏点NPC触发[@main]，看聊天框是否正确打印两倍结果和说明文本，验证return返回值是否正确写入接收变量。

FAQ问答

1. 问：GOTO传参回调和普通goto跳转有什么区别？

普通goto @段名只是单纯跳过去执行，没有参数传递也没有返回值；带括号的goto @段(参数|变量)能把值传进去，子段算完用return把结果写回指定变量，相当于子程序调用。需要拿计算结果回来就用带括号的写法。（本条问题整理自百度知道真实提问：《传奇》服务端中变量运用的所有命令，2019-08）

2. 问：return后面能返回几个值？有数量限制吗？

官方示例返回了两个值，竖线后对应两个接收变量。return后面跟几个值，竖线后就要写几个变量，顺序对应。返回值数量没有硬性上限，但建议按实际需要控制在两到三个，太多容易乱。

3. 问：为什么我写了return，下面的SENDMSG还是不输出？

这是正常行为。return在GOM脚本里等同break，一旦执行到return，所在子段后面的所有行都不会再跑。需要在return之前把所有要做的事做完，return是收尾出口。

4. 问：scriptparam1在子段外面还能读到值吗？

读不到。<$scriptparam1>是子段内部的临时占位符，只在被goto跳转的那段脚本里有效。跳转结束回到主段后，这个标记就失效了。要保留结果，必须通过return返回到普通变量里。

5. 问：GOTOLABEL群发传参和GOTO传参回调是一回事吗？

不是。GOTOLABEL是把同一段脚本同时跑给组队、行会或当前地图的多个人，传递的变量在每个人上下文里共享，没有返回值。GOTO传参回调是当前脚本自己调子段，把值传进去再拿回来。一个面向多人广播，一个面向自己调子程序。（本条问题整理自百度知道真实提问：传奇gom引擎脚本命令常用命令分类，2026-07）

6. 问：传参时能直接在括号里写算式吗？比如括号里写乘法？

不能。括号里只能写常量或已经赋值好的变量，算式要放到子段内部用formulation算。比如传一个数字进去，在子段里写formulation <$scriptparam1>*2 N$结果。括号里写算式引擎不会按预期解析。

7. 问：脚本改完重载了，为什么return返回的变量还是旧值？

先检查return后面的值和竖线后接收变量的数量、顺序是否一一对应。再确认子段里formulation的计算结果变量确实被return带出去了。如果传参后脚本段没重载，goto还是跑的旧逻辑。（本条问题整理自百度知道真实提问：传奇服务端脚本改了游戏里面没变化，2022年11月）

总结

GOTO传参回调把脚本里重复的计算逻辑抽成公共子段，传参进去、return拿结果回来，避免到处复制粘贴。竖线前传参、竖线后接返回值，子段里用scriptparam取参，return既是出口也是break。它和GOTOLABEL群发传参用途不同，别混着用。

以上goto参数回调示例基于GOM引擎官方帮助文档的写法在本地版本验证通过，不同引擎分支对scriptparam占位符的支持存在差异，跨引擎迁移需自行测试。内容仅供本地学习调试使用。