传奇获取装备绑定属性数据完整教程

一、命令功能介绍

传奇ESP插件中，ESPGetCustomItemValue是专门用于读取游戏内指定装备绑定属性数据的核心命令，可精准获取装备的属性数值、显示颜色、绑定类型、展示位置、百分比状态等全套属性信息。该命令适配各类传奇自定义装备、时装、无限装备，操作简单、兼容性强，是传奇版本制作、装备功能修改、属性调试的常用核心脚本命令。

二、命令完整格式

ESPGetCustomItemValue 参数1 参数2 参数3 参数4 参数5 参数6 参数7

三、七大参数详细解析

本命令共设置七个专属参数，每个参数对应不同的数据读取功能，参数顺序固定，不可随意调换，具体作用如下：

参数1：装备位置

用于指定需要读取属性的装备所在位置，常规穿戴装备直接填写对应位置编号，时装、无限装备需对照专属装备序号填写，精准定位目标装备。

参数2：属性位置

对应装备自定义属性的排序编号，不同位置编号对应装备不同的自定义绑定属性，按版本属性排序规则填写即可。

参数3：属性值_存放变量

自定义变量，用于存储读取到的装备属性具体数值，后续可通过脚本调用该变量展示、修改属性数据。

参数4：颜色_存放变量

专属存储变量，用来存放装备属性的文字显示颜色数据，控制属性在游戏界面的展示色彩。

参数5：绑定类型_存放变量

用于存储装备的绑定状态数据，可区分装备绑定、未绑定、限时绑定等不同绑定类型。

参数6：显示位置_存放变量

存储装备属性的界面展示位置数据，决定该条装备属性在装备面板的显示排序与展示区域。

参数7：是否百分比_存放变量

存储装备属性的数值展示状态，用于判断该属性数值为固定数值或百分比数值。

四、可直接套用的完整脚本案例

以下为实测可用的完整游戏脚本，包含装备自定义属性修改、属性数据读取、游戏内弹窗展示全套功能，可直接复制到传奇版本脚本中使用，适配常规自定义装备属性调试场景。

[@main]
#ACT
;修改装备0位置第0条自定义属性基础样式
CHANGECUSTOMITEMABIL 0 0 1 1
;修改装备0位置第1条自定义属性基础样式
CHANGECUSTOMITEMABIL 0 1 1 2
;给装备0位置第0条属性赋值10点
CHANGECUSTOMITEMVALUE 0 0 = 10
;给装备0位置第1条属性赋值20点
CHANGECUSTOMITEMVALUE 0 1 = 20
;读取装备0位置第0条全部绑定属性数据，存入对应变量
ESPGetCustomItemValue 0 0 N0 N1 N2 N3 N4
;游戏内弹窗展示第0条属性完整数据
SENDMSG 7 属性值=<$STR(N0)>，颜色=<$STR(N1)>，绑定类型=<$STR(N2)>，显示位置=<$STR(N3)>，是否百分比=<$STR(N4)>
;读取装备0位置第1条全部绑定属性数据，存入对应变量
ESPGetCustomItemValue 0 1 N0 N1 N2 N3 N4
;游戏内弹窗展示第1条属性完整数据
SENDMSG 7 属性值=<$STR(N0)>，颜色=<$STR(N1)>，绑定类型=<$STR(N2)>，显示位置=<$STR(N3)>，是否百分比=<$STR(N4)>

五、脚本使用说明

1、脚本内所有数字参数可根据自身版本装备编号、属性位置灵活修改，适配不同自定义装备；

2、N0-N4为通用自定义变量，无需手动定义，插件可自动识别存储对应属性数据；

3、SENDMSG 7为游戏公屏弹窗提示指令，运行脚本后可直观查看读取到的全套装备绑定属性数据，方便调试排查问题；

4、可基于该基础脚本拓展功能，搭配判断指令实现装备属性筛选、属性校验、属性修改等进阶玩法。

六、进阶拓展脚本（实用套用版）

新增常用进阶脚本，支持批量读取装备属性、判断属性百分比状态，满足版本定制、功能开发需求，直接复制即可使用：

[@CheckItemAttr]
#ACT
;批量读取装备多条自定义绑定属性
ESPGetCustomItemValue 0 0 A0 A1 A2 A3 A4
ESPGetCustomItemValue 0 1 B0 B1 B2 B3 B4
;判断属性是否为百分比属性并弹窗提示
#if <$STR(A4)> = 1
#ACT
SENDMSG 7 该属性为百分比属性，数值：<$STR(A0)>
#ELSE
#ACT
SENDMSG 7 该属性为固定数值属性，数值：<$STR(A0)>
#ENDIF