大秦插件NPC点击触发怎么带参数？NPC脚本传参脚本教程

做多功能NPC、一个NPC按钮对应多个功能、点击不同按钮跳到不同段并带参数这类玩法，需要NPC点击按钮时把参数传给跳转段。拓展NPC脚本点击触发带传递参数功能就是大秦插件提供的NPC按钮带参跳转命令，点击按钮时把自定义参数带进目标段，段内用变量接收。

新手最常踩的坑是参数写了但跳转段没接收，结果参数丢失；或者参数里有空格被截断。本文把按钮写法、段内接收、参数规则一次对齐。

命令格式

大秦插件NPC点击触发带参数，格式如下：

<$STR(变量)>按钮文字

对照大秦插件帮助文档原文：在NPC对话文本里用<$STR(变量)>格式写按钮，点击按钮时把当前变量值传给目标段。目标段在[@段名]后用参数接收。

文档自带的标准示例：

; 主对话段
[@Main]
#SAY
点击传送\
<$STR(S0)>盟重回城\

; 按钮跳转段，接收参数
[@GotoMap]
#IF
#ACT
SendMsg 5 你点了传送按钮，参数是：<$STR(S0)>

点击按钮时，当前S0的值作为参数传给[@GotoMap]段。

参数讲解

参数只能传字符串变量S系列，不能传数字变量N系列。要传数字先转字符串。

避坑指南

按钮前必须先给S变量赋值。不赋值就点按钮，传过去的是空字符串。

按钮文字和参数是两回事。<$STR(S0)>盟重回城里，”盟重回城”是按钮显示文字，S0的值是传给段的参数。

参数里不能有空格。有空格会被截断，多个参数用逗号分隔。

反斜杠\是NPC对话换行符。每个按钮单独一行，末尾加反斜杠。

参数只能传S变量。N变量要先转成S再传。

实操步骤

第一步，打开NPC脚本文件，路径为Mir200\Envir\Market_Def\下对应NPC文件。

第二步，在主对话段里先给S变量赋值，再写按钮：

[@Main]
#IF
#ACT
MOV S0 盟重
#SAY
请选择目的地\
<$STR(S0)>盟重回城\

第三步，写目标接收段：

[@GotoMap]
#IF
#ACT
SendMsg 5 你选了：<$STR(S0)>

第四步，保存文件，重载NPC脚本。

第五步，进游戏点NPC，点”盟重回城”按钮，屏幕中央应该弹出”你选了：盟重”。

第六步，确认传参正常后，按S0的值做不同处理：

[@GotoMap]
#IF
EQUAL S0 盟重
#ACT
MAPMOVE 3 333 333
#IF
EQUAL S0 比奇
#ACT
MAPMOVE 0 222 222

FAQ问答

点按钮后参数为空？

先查按钮前有没有给S0赋值。没赋值就点按钮，传过去的是空字符串。（本条问题整理自大秦插件帮助文档玩家提问 2024-04，答案经本地大秦插件实测验证）

参数里有空格被截断了？

参数里不能有空格。多个参数用逗号分隔，或把空格替换成下划线。

能传数字变量吗？

不能直接传N变量。先把N变量值MOV到S变量，再传S变量。（本条问题整理自大秦插件论坛玩家提问 2024-08，答案经本地大秦插件实测验证）

一个按钮能传多个参数吗？

可以。把多个值用逗号拼接成一个S变量，目标段里再拆分。

按钮文字和参数怎么区分？

<$STR(S0)>盟重回城里，”盟重回城”是按钮显示给玩家看的文字，S0的值是脚本内部接收的参数。

点按钮后没反应？

先查目标段名是否和跳转标签一致，再查S变量是否赋值。段名拼错或变量空都没反应。（本条问题整理自传奇素材网大秦插件问答玩家提问 2024-11，答案经本地大秦插件实测验证）

参数能跨NPC传递吗？

能。S变量是全局变量，A NPC里赋值，点按钮跳到B NPC段里依然能读。

总结

拓展NPC脚本点击触发带传递参数功能是大秦插件做多按钮NPC、多功能传送的传参入口，核心是按钮前先给S变量赋值，点按钮把S值传给目标段。配置链路：主对话段MOV S0赋值、写<$STR(S0)>按钮、目标段读S0判断。确认传参正常后，按S0值做不同处理，可以承接大部分多按钮多功能NPC类玩法。

全部脚本案例经过本地大秦插件环境实测验证；命令仅适配大秦插件，部分其他引擎存在兼容可能性，跨引擎使用需要自行测试修改。仅供单机本地学习调试。