传奇NPC界面自定义设置教程 界面参数及脚本用法详解
一、传奇NPC界面核心定义说明在传奇版本搭建与脚本修改过程中，NPC界面样式、弹窗布局、图片素材适配是优化玩家游戏体验的关键环节。传奇游戏支持通过专属脚本指令自定义NPC对话框界面，替换默认界面素材、调整弹窗位置、开启特效功能，告别原版单调的界面样式。本文将详细讲解传奇NPC界面自定义核心指令、参数…
一、传奇NPC界面核心定义说明
在传奇版本搭建与脚本修改过程中，NPC界面样式、弹窗布局、图片素材适配是优化玩家游戏体验的关键环节。传奇游戏支持通过专属脚本指令自定义NPC对话框界面，替换默认界面素材、调整弹窗位置、开启特效功能，告别原版单调的界面样式。本文将详细讲解传奇NPC界面自定义核心指令、参数含义、使用规范及实操案例，帮助版本制作者快速完成NPC界面优化设置。
二、两大NPC界面设置核心功能指令
2.1 SETMERCHANTDLGIMGNAME 指令
指令格式：SETMERCHANTDLGIMGNAME 图片名 索引
使用规则：该指令主要用于调用自定义素材图片作为NPC对话框界面，使用时必须保证索引数值不为0，同时填写的图片名为游戏内有效素材文件名。指令生效后，会直接调取对应素材文件中指定索引的图片，替换默认NPC弹窗界面。
2.2 NPC_DLG_OPTIONS 指令
指令格式：NPC_DLG_OPTIONS 地图 NPC名字 参数 排列 对话框图片名 索引
基础特性：该指令为升级版NPC界面设置指令，兼容性和展示效果优于传统指令，支持一次性固定配置，可在登陆脚本中定义，仅首次配置生效，后续无参数改动无需重复编写，是目前传奇版本优化NPC界面的首选指令。
三、NPC_DLG_OPTIONS 指令参数详细解析
3.1 地图参数
代表目标NPC所在的游戏地图编号，例如传奇土城对应地图号为3。若该参数设置为空值，系统会自动根据填写的NPC名字全域搜索匹配对应NPC。
重要限制规则：单张地图内不允许存在同名NPC，若MerChant.txt文件中同一地图设置了两个及以上相同名称的NPC，仅最先配置的NPC界面设置能够生效，其余同名NPC设置全部失效。例如比奇省地图中重复设置两个“屠夫”NPC，仅单个NPC界面配置正常生效。
3.2 功能参数（复合参数）
该参数为多功能复合数值，支持叠加使用，不同数值对应不同NPC界面功能，具体定义如下：
1：隐藏NPC对话框拉条
2：开启NPC对话框可移动功能
4：开启NPC对话框闪烁特效
叠加示例：参数设置为3（1+2），代表NPC对话框可移动且隐藏拉条；可根据需求自由组合数值，实现多种界面功能叠加。
3.3 排列参数
用于控制NPC对话框在游戏屏幕中的弹出位置，固定数值对应固定布局，具体参数定义：
0、1：默认弹窗位置
2：屏幕居中弹出
3：屏幕右上弹出
4：屏幕左下弹出
5：屏幕右下弹出
3.4 对话框图片名与索引参数
图片名参数留空时为系统默认样式；若索引参数未填写或数值为0，系统自动调用lui.pkg内置图片素材。当索引数值有效时，精准调取自定义素材文件中对应索引的界面图片，填写素材名时无需添加文件扩展名，保证素材文件路径正确即可。
四、特殊NPC名称及所属地图适配说明
传奇脚本中存在专属特殊功能NPC，此类NPC无常规地图坐标，仅可通过固定名称配置界面参数，专属NPC名单如下：QFunction/0、QMapEvent/0、QManage/0、RobotManage/0、QChatMission/0，配置这类NPC界面时，直接填写固定名称即可生效。
五、NPC界面设置核心注意事项
1、冲突规避规则：若已在QM脚本中通过NPC_DLG_OPTIONS配置了同名NPC界面，禁止再使用SETMERCHANTDLGIMGNAME指令调用相同素材，否则会引发界面冲突。
2、弹窗异常问题：重复叠加冲突指令后，点击MESSAGEBOX弹窗会出现界面错乱、失效等问题，同时影响服务器内其他NPC界面正常展示。
3、指令优选原则：新版本传奇脚本优化中，统一废弃SETMERCHANTDLGIMGNAME指令，全程使用NPC_DLG_OPTIONS指令替代，界面展示更稳定、功能更全面，适配所有传奇版本客户端。
六、传奇NPC界面设置脚本实操案例
以下为QManage.txt登录脚本标准配置案例，可直接复制套用，适配常规传奇版本NPC界面自定义需求：
[@login]
#act
NPC_DLG_OPTIONS 0149 盟重张家布衣 7 2 MerchantDlg.png
NPC_DLG_OPTIONS 0149 盟重手套店 3 3 ui1 2731
NPC_DLG_OPTIONS 0149 盟重老张头盔店 3 4 ui1 2924
NPC_DLG_OPTIONS 0 QFunction 3 4 ui1 3020
