传奇ESPGetUpgradeCount命令教程 获取装备强化加星数量脚本用法
摘要：详解传奇ESP插件核心指令ESPGetUpgradeCount使用方法，整理函数语法、全装备位置编号、时装参数对照表，教传奇GM通过脚本获取装备强化加星数量，解决无限装备模式下星数读取异常问题，快速制作各类星级功能。…
一、函数功能概述
ESPGetUpgradeCount是传奇ESP插件专属核心脚本函数，专门用于读取玩家指定装备部位的强化加星数量，支持单件装备、全身装备及时装装备星值采集。这款ESP插件指令广泛用于星级权限判定、强化属性加成、战力统计、地图准入等传奇版本功能开发，是传奇GM制作自定义强化系统不可或缺的核心脚本指令。
二、函数基础语法
ESPGetUpgradeCount 参数1 参数2
2.1 参数释义
参数1：装备位置编号，定位需要通过ESPGetUpgradeCount读取星数的装备部位，支持基础部位、全身、时装装备三种定位模式
参数2：自定义存储变量，用于承接读取到的强化星数，行业通用格式为N+数字，例如N0、N1
三、装备位置编号明细
3.1 基础装备位置编号
-1：全身所有装备
0：盔甲（衣服）
1：武器
2：照明物
3：项链
4：头盔
5：右手镯
6：左手镯
7：右戒指
8：左戒指
9：护身符
10：腰带
11：鞋子
12：宝石
13：斗笠
14：军鼓
15：马牌
16：盾牌
17：时装武器
18：时装衣服
19-30：首饰盒1-12号位
3.2 时装首饰装备位置编号
1001：时装项链
1002：时装手镯1
1003：时装手镯2
1004：时装戒指1
1005：时装戒指2
1006：时装头盔
1007：时装盾牌
1008：时装腰带
1009：时装鞋子
1010：时装军鼓
1011：时装宝石
1012：时装马牌
3.3 特殊补充说明
服务端开启ESP插件无限装备功能后，本文常规装备编号失效，使用ESPGetUpgradeCount函数时，必须沿用无限装备面板内的专属序号配置参数，有效杜绝星数读取失败、数据错乱等常见问题。
四、实战脚本示例
以下为适配M2引擎的ESP插件实战脚本，包含ESPGetUpgradeCount单部位读取、全身装备强化星数读取两大常用场景，传奇GM可直接复制套用至传奇版本中。
#act
;读取盔甲（衣服）部位强化星数，存入变量N0
ESPGetUpgradeCount 0 N0
;向玩家发送弹窗信息，展示衣服星数
SendMsg 0 衣服的强化星星数为 <$STR(N0)>
;读取玩家全身装备强化星数，存入变量N1
ESPGetUpgradeCount -1 N1
;向玩家发送弹窗信息，展示全身总星数
SendMsg 0 全身的强化星星数为 <$STR(N1)>
五、开发使用注意事项
使用ESPGetUpgradeCount时规范排布N系列自定义变量，避免变量重叠覆盖，杜绝脚本数据错乱
首饰盒装备仅支持19-30编号区间，超出该范围会直接触发脚本报错
时装装备仅限使用1000开头专属编号，禁止与基础装备编号混用
无限装备环境下，核对面板专属序号是解决星数读取为空、数值异常的关键
该函数仅识别玩家已穿戴装备的强化星数，背包、仓库未穿戴装备无法读取
