传奇脚本教程：获取角色装备显示至格子及NPC界面兼容设置
摘要：本文讲解传奇服务端EQUIPITEMS指令用法，详解角色/英雄装备显示到格子的设置方法、新旧NPC界面兼容规则，附带完整可直接使用的脚本代码及常见问题排查方案。…
一、核心功能概述
本文详解传奇服务端脚本中，角色身上装备读取并展示至界面格子的实现方法，同时说明新旧NPC界面的兼容规则、面板配置要求及完整脚本示例。该功能常用于个人装备面板、NPC装备查看、回收预览等游戏场景，是传奇定制脚本中高频使用的核心功能。
二、NPC界面兼容强制规则
传奇服务端存在新旧两套NPC界面编写逻辑，装备展示面板调用必须遵循以下强制规则，否则会出现界面报错、格子不显示、点击无响应等问题：
1. 新旧写法界面完全兼容，但单个NPC界面只能使用一种写法，禁止同一界面内混用新旧面板代码；
2. 启用新NPC装备面板前，必须在M2服务端后台完成配置：依次打开M2-客户端控制-页面显示，勾选启用新NPC面板写法，配置生效后才可正常调用EQUIPITEMS类面板指令。
三、装备展示核心指令详解
3.1 主指令基础说明
传奇脚本中实现装备读取并显示到格子，核心使用两大专用指令，分别对应角色主体装备、英雄装备：
角色装备面板指令：<EQUIPITEMS>
英雄装备面板指令：<HEROEQUIPITEMS>
其中HEROEQUIPITEMS所有参数与EQUIPITEMS完全一致，仅展示对象为英雄身上装备，参数配置逻辑通用。
3.2 全参数功能解析
装备面板指令支持多参数自定义，可控制装备位置、格子样式、交互逻辑等，所有参数可按需组合，关键参数说明如下：
positions：指定读取的装备位置，赋值*代表读取角色全部身上装备
select：存储已选择道具的唯一ID，固定搭配变量<$STR(S0)>使用
count：定义界面生成的装备格子总数量
selecttype：选择类型，0为多选模式、1为单选模式，适配批量操作、单独选择场景
showstar：控制装备星级显示，1开启显示、0关闭隐藏
row：设置装备格子的展示行数，配合count控制整体排版
iwidth：自定义单个装备格子的宽度，适配界面尺寸调整
iheight：自定义单个装备格子的高度，适配界面尺寸调整
showtips：鼠标悬浮提示开关，1显示装备详情提示、0关闭提示
link：格子点击触发的脚本跳转命令，该参数必须放置在指令末尾
<$STR(S0)>：系统内置变量，用于接收选中装备的唯一ID，联动跳转脚本执行后续逻辑
四、完整可直接使用脚本示例
以下为标准无报错的装备格子展示脚本，适配新NPC面板写法，可直接复制至传奇服务端NPC脚本文件中使用，实现装备显示、点击获取装备ID功能。
//装备展示面板完整示例脚本
[@MAIN]
#IF
#SAY
//X/Y为面板坐标，可根据NPC界面布局自行调整
<EQUIPITEMS|x=85.0|y=42.0|select=<$STR(S0)>|positions=*|count=4|row=1|link=@脚本命令>
//装备格子点击触发的自定义逻辑
[@脚本命令]
#IF
#ACT
//向全服发送选中装备的唯一ID，可替换为回收、查看、取下等功能
SendMsg 0 --【选中装备ID】--<$STR(S0)>
//执行完成后返回主界面
GOTO @MAIN
五、常见问题排查要点
1. 装备格子空白不显示：检查M2后台是否开启新NPC面板，核对界面是否混用新旧写法，positions参数是否配置正确；
2. 点击格子无反应：确认link参数放在指令最后，跳转脚本标签名无拼写错误，变量<$STR(S0)>未被篡改；
3. 界面排版错乱：通过iwidth、iheight调整格子尺寸，修改row行数和count数量适配界面大小。
