在传奇引擎架设中，通过自定义按钮触发 NPC 脚本，可实现快速调用 NPC 功能（如任务接取、道具兑换），核心操作需完成 “服务端按钮配置→客户端资源同步→NPC 脚本绑定” 三步，以下为具体流程（以 GOM、HERO 主流引擎为例）。
一、服务端配置：自定义按钮基础参数设置
服务端通过Button.ini文件定义按钮属性，包括位置、触发命令、显示条件，是按钮生效的核心环节：
找到按钮配置文件
打开服务端根目录，进入Mir200\Envir文件夹，找到Button.ini文件（部分引擎命名为CustomButton.ini），右键用记事本或 Notepad++ 打开。
添加自定义按钮配置段
在文件末尾新增按钮配置，需明确 6 个关键参数，示例如下（以 “快速兑换” 按钮为例）：
[CustomButton1] ; 按钮ID，从1开始递增（避免重复）
Name=快速兑换 ; 按钮显示名称
PosX=800 ; 按钮在客户端界面的X坐标（根据分辨率调整，如1024分辨率设800）
PosY=500 ; 按钮在客户端界面的Y坐标
IconIndex=302 ; 按钮图标索引（对应客户端Item.wil中的图标）
Command=@CallNPC 1001 ; 触发命令（@CallNPC+NPC编号，1001为目标NPC的ID）
ShowLevel=1 ; 按钮显示等级（1级及以上角色可见，0为所有角色可见）
配置说明：Command参数是关键，需通过 “@CallNPC+NPC 编号” 关联目标 NPC，后续脚本将基于该命令触发。
保存配置并加载生效
保存Button.ini文件后，无需重启整个服务端，只需在引擎控制器中找到 “刷新配置” 按钮（GOM 引擎在 “参数设置” 界面，HERO 引擎在 “服务管理” 界面），点击刷新按钮配置，确保新按钮参数被加载。
二、客户端同步：确保按钮显示正常
客户端需同步按钮图标与界面配置，否则按钮会显示空白或无法点击，操作如下：
同步按钮图标资源
打开客户端根目录Mir文件夹，找到Item.wil文件（图标资源文件），用 WIL 编辑器（如 “传奇 WIL 工具”）打开：
找到服务端Button.ini中设置的IconIndex数值（如 302），确认该索引位置有有效图标（非空白）；
若图标空白，将准备好的按钮图标（建议尺寸 32×32 像素，BMP 格式）导入该索引位置，保存Item.wil文件。
调整客户端界面布局（可选）
若按钮位置偏移（如超出屏幕），需修改客户端Mir\Config\UIConfig.ini文件（部分引擎为Interface.ini）：
搜索 “CustomButton” 关键词，找到对应按钮 ID（如 CustomButton1）的PosX和PosY参数，与服务端Button.ini保持一致；
保存文件后，关闭客户端重新启动，确保按钮在界面显示位置正确。
三、NPC 脚本绑定：关联按钮触发逻辑
自定义按钮的Command命令需与 NPC 脚本绑定，才能实现点击按钮后触发 NPC 功能，步骤如下：
确定目标 NPC 编号与脚本文件
首先在服务端Mir200\Envir\NPCs文件夹中，找到目标 NPC 的脚本文件（如新手村NPC.txt），查看该 NPC 的编号：
NPC 脚本首行通常标注编号，格式为#1001 新手村村长 320 330 新手村（# 后数字 1001 即为 NPC 编号，需与服务端Button.ini的Command参数中 “1001” 一致）。
编写按钮触发的 NPC 脚本逻辑
在目标 NPC 的脚本文件中，添加@CallNPC触发段，示例如下（实现 “点击按钮→NPC 对话→道具兑换” 功能）：
#1001 新手村村长 320 330 新手村
[@Main]
欢迎来到新手村！\
<任务接取/@TaskAccept>\
<道具兑换/@ItemExchange>\
; 自定义按钮触发的脚本段（与服务端Button.ini的Command对应）
[@CallNPC 1001]
#ACT
GOTO @ItemExchange ; 直接跳转至“道具兑换”功能，无需手动点击NPC对话
[@ItemExchange]
#IF
CHECKITEM 新手币 10 ; 检查是否有10个新手币
#ACT
TAKE 新手币 10
GIVE 初级药水 5 ; 兑换5瓶初级药水
SENDMSG 7 成功用10个新手币兑换5瓶初级药水！
#ELSE
SENDMSG 7 新手币不足10个，无法兑换！
脚本说明：[@CallNPC 1001]是按钮触发的入口，通过GOTO命令直接跳转至 NPC 现有功能段，减少操作步骤。
验证脚本语法正确性
保存 NPC 脚本文件后，打开引擎控制器的 “脚本检查” 工具（GOM 引擎在 “辅助工具” 界面，HERO 引擎在 “脚本管理” 界面），选择刚修改的 NPC 脚本文件，点击 “检查语法”：
若提示 “语法正确”，则脚本可正常执行；
若提示 “命令错误”（如 CHECKITEM 拼写错误），需返回脚本文件修正后重新检查。
四、测试验证：确保按钮触发正常
完成配置与脚本绑定后，需通过客户端测试功能是否生效：
启动服务端与客户端
确认服务端LoginGate、GameGate、DBServer均正常启动，启动客户端并登录角色（等级需满足按钮ShowLevel设置，如 1 级及以上）。
触发自定义按钮测试
在客户端界面找到新增的 “快速兑换” 按钮（位置与Button.ini的PosX/PosY一致），点击按钮；
正常情况：点击后直接触发 NPC 的 “道具兑换” 逻辑，若新手币足够，背包中会新增初级药水，同时收到系统提示；
异常情况：点击无反应，需检查Button.ini的Command是否正确（如 NPC 编号是否与脚本一致）、脚本语法是否有误。
常见问题排查
按钮不显示：检查客户端Item.wil的IconIndex是否有图标、服务端Button.ini的ShowLevel是否低于角色等级；
脚本不触发：确认[@CallNPC 1001]的 NPC 编号与按钮Command中的编号一致，且脚本已通过语法检查；
位置偏移：同步修改服务端Button.ini与客户端UIConfig.ini的PosX/PosY，重新刷新配置。
五、注意事项：避免操作失误
按钮 ID 唯一性
新增按钮时，[CustomButtonX]的 ID（X）需从 1 开始递增，避免与已有按钮 ID 重复（可在Button.ini中查看已用 ID），重复会导致后添加的按钮失效。
引擎版本适配
不同引擎的Button.ini参数名称可能略有差异（如 HERO 引擎用BtnPosX替代PosX），若找不到对应参数，可在服务端根目录搜索 “按钮配置说明” 文档（通常命名为ButtonHelp.txt）。
脚本命令兼容性
编写 NPC 脚本时，需使用当前引擎支持的命令（如 GOM 引擎支持GOTO，部分老旧引擎需用#GOTO），避免因命令不兼容导致脚本无法执行，可参考引擎自带的 “脚本命令手册”（在Mir200\Envir\Help文件夹中）。
总结
自定义按钮触发 NPC 脚本的核心是 “服务端参数定按钮→客户端同步显按钮→脚本绑定实功能”：
服务端Button.ini定义按钮的位置、触发命令，是功能基础；
客户端同步图标与界面配置，确保按钮可见可点；
NPC 脚本中添加@CallNPC触发段，关联按钮与具体功能。
按此流程操作，可快速实现自定义按钮调用 NPC 功能，减少角色操作步骤，提升体验。若需添加多个按钮，只需重复 “新增配置段→同步客户端→绑定脚本” 步骤，注意保持 ID 与命令的唯一性即可。
