ESPGetUpgradeCount 获取强化加星数量函数使用教程

本文详细讲解传奇脚本中ESPGetUpgradeCount获取强化加星数量函数的用法、参数说明、装备位置对应表及实战脚本示例，帮助开发者快速掌握装备星级读取脚本指令，适配各类装备星级统计、全身星级检测、单件装备星级获取等游戏功能开发。

一、函数基础说明
函数名称：ESPGetUpgradeCount
函数作用：读取游戏装备的强化加星数量，可精准获取单件装备、分类装备或全身所有装备的星级数值，广泛应用于星级判定、装备评分、属性解锁、游戏提示等脚本场景。

二、函数参数详解
该函数包含两个必填参数，参数顺序固定，使用时需严格对应：
参数1：物品位置——指定需要读取星级的装备位置，支持单件装备、装备分类、全身装备等多种范围
参数2：变量——存储读取到的装备强化星星数值，可自定义变量名称，后续可通过变量调用星级数据

三、常规装备位置对应表
常规穿戴装备位置编码对应详情如下，覆盖游戏基础全套装备部位：
-1：全身所有装备
0：盔甲
1：武器
2：照明物
3：项链
4：头盔
5：右手镯
6：左手镯
7：右戒指
8：左戒指
9：护身符
10：腰带
11：鞋子
12：宝石
13：斗笠
14：军鼓
15：马牌
16：盾牌
17：时装武器
18：时装衣服
19-30：首饰盒1-12号位

四、时装首饰装备位置对应表
针对时装类首饰、专属装备，采用1001开头专属位置编码，具体对应关系如下：
1001：项链
1002：手镯1
1003：手镯2
1004：戒指1
1005：戒指2
1006：头盔
1007：盾牌
1008：腰带
1009：鞋子
1010：军鼓
1011：宝石
1012：马牌

五、特殊使用备注
若游戏开启无限装备功能，上述常规位置编码、时装位置编码失效，需以无限装备面板内对应的装备序号为准，读取对应部位的强化加星数量。

六、函数实战脚本实例
以下为可直接复制使用的完整脚本示例，分别演示单件装备、全身装备星级获取及弹窗提示效果：
#act
// 获取盔甲(衣服)部位强化星星数量，存入变量N0
ESPGetUpgradeCount 0 N0
// 弹窗提示显示衣服强化星星数
SendMsg 0 衣服的强化星星数为 <$STR(N0)>

// 获取全身所有装备强化星星数量，存入变量N1
ESPGetUpgradeCount -1 N1
// 弹窗提示显示全身装备强化星星总数
SendMsg 0 全身的强化星星数为 <$STR(N1)>

七、使用总结
ESPGetUpgradeCount函数操作简单、适配性强，是传奇脚本中读取装备星级的核心指令。通过灵活搭配不同装备位置编码，可精准实现单件装备星级查询、全身星级统计、时装装备星级检测等各类功能，适配绝大多数版本的装备强化、星级玩法开发需求。