传奇获取装备宝石数量脚本教程
摘要：本文详解传奇ESP插件专属获取装备宝石数量脚本教程，讲解ESPGetItemStoneCount、ESPGetStoneCount核心命令参数，附装备位置编号、内置变量对照表及可直接使用的实战脚本示例，解决传奇版本制作中宝石统计、装备检测等场景需求，适配GOM引擎使用ESP插件版本。…
一、功能概述
传奇ESP插件内置专属宝石数量读取函数，可精准读取角色单件装备指定宝石数量、全身所有装备宝石总数量，广泛用于角色属性检测、宝石统计、穿戴校验、触发奖励等传奇脚本场景。该功能适配所有主流ESP插件版本，兼容常规GOM、GE引擎，是传奇版本制作中高频使用的基础脚本功能。
二、核心命令详解
2.1 单件装备宝石数量获取
命令格式：ESPGetItemStoneCount 装备位置 宝石名称 变量
参数说明：
装备位置：填写数字编号，对应角色身上指定装备槽位
宝石名称：指定需要统计的宝石名称，支持通配符*或all统计全部宝石
变量：自定义内存变量，用于存储读取到的宝石数量（常用N系列变量）
2.2 全身装备宝石数量获取
命令格式：ESPGetStoneCount 宝石名称 变量
参数说明：
宝石名称：指定统计宝石名称，支持*或all统计全身所有宝石
变量：存储全身对应宝石的总数量，无装备位置参数，直接读取角色全部生效装备
三、装备位置编号对照表
脚本中装备位置参数严格对应以下编号，编写脚本时需准确填写，避免读取位置错误：
0=盔甲，1=武器，2=照明物（蜡烛，属性升级无效），3=项链，4=头盔
5=右手镯，6=左手镯，7=右戒指，8=左戒指，9=护身符空位
10=腰带，11=鞋子，12=宝石
四、装备名称对应变量
脚本提示文本中可使用内置变量调用装备自定义名称，适配不同版本自定义装备命名，提升玩家展示效果：
<$DRESS>=衣服，<$WEAPON>=武器，<$RIGHTHAND>=蜡烛，<$HELMET>=头盔
<$NECKLACE>=项链，<$RING_R>=右戒指，<$RING_L>=左戒指，<$ARMRING_R>=右手镯
<$ARMRING_L>=左手镯，<$BUJUK>=护身符，<$BELT>=腰带，<$BOOTS>=鞋子，<$CHARM>=宝石
五、实战脚本示例
以下为可直接复制使用的成品脚本，覆盖全宝石统计、指定宝石统计两大常用场景，导入版本即可生效：
;==================================================
; 传奇ESP插件｜获取装备宝石数量 全套实战脚本
; 适配：GOM引擎 全版本ESP插件
; 说明：无报错、可直接复制至QFunction-0.txt投产
;==================================================
;--------------------------
; 【基础案例1】单件装备全宝石统计
; 位置1=武器，*代表统计所有宝石
;--------------------------
[@MainGetWeaponAllStone]
#ACT
ESPGetItemStoneCount 1 * N10
SENDMSG 6 你的【<$WEAPON>】镶嵌宝石总计：<$STR(N10)>颗
;--------------------------
; 【基础案例2】单件装备指定宝石统计
; 精准匹配数据库宝石名称，区分大小写
;--------------------------
[@MainGetWeaponAtkStone]
#ACT
ESPGetItemStoneCount 1 攻击青宝石(初级) N10
SENDMSG 6 武器内【攻击青宝石(初级)】数量：<$STR(N10)>颗
;--------------------------
; 【基础案例3】全身所有宝石总量统计
; 读取角色全部穿戴装备宝石总和
;--------------------------
[@MainGetAllBodyStone]
#ACT
ESPGetStoneCount * N10
SENDMSG 6 全身装备宝石总数量：<$STR(N10)>颗
;--------------------------
; 【基础案例4】全身指定类型宝石统计
; 常用于检测玩家宝石达标、权限判定
;--------------------------
[@MainGetBodyAtkStone]
#ACT
ESPGetStoneCount 攻击青宝石(初级) N10
SENDMSG 6 全身【攻击青宝石(初级)】总计：<$STR(N10)>颗
;--------------------------
; 【进阶案例】多装备槽位批量检测
; 同时检测头盔、项链、武器宝石总数
;--------------------------
[@CheckEquipAllStone]
#ACT
ESPGetItemStoneCount 1 * N10 ;武器
ESPGetItemStoneCount 3 * N11 ;项链
ESPGetItemStoneCount 4 * N12 ;头盔
CALC N13 = N10 + N11 + N12
SENDMSG 6 武器+项链+头盔宝石合计：<$STR(N13)>颗
;--------------------------
; 【实用案例】宝石数量达标触发奖励
; 满足指定宝石数量自动执行功能
;--------------------------
[@StoneCheckReward]
#ACT
ESPGetStoneCount 攻击青宝石(初级) N10
#IF
N10 >= 5
#ACT
SENDMSG 6 检测到你镶嵌5颗以上攻击青宝石，获得属性加成！
CHANGEABILITY 攻击 +10
#ELSEACT
SENDMSG 6 攻击青宝石数量不足5颗，无法激活加成属性
六、脚本使用注意事项
1、照明物位置编号2仅为道具占位，该槽位宝石属性不生效，无需对该位置做宝石统计脚本
2、变量建议统一使用N系列全局变量，避免局部变量导致读取数据清空、统计不准的问题
3、宝石名称必须和版本数据库中宝石物品名称完全一致，大小写、符号差异会导致读取失效
4、通配符*与all功能等效，统计全部宝石时任选其一即可，无需重复叠加使用
5、该脚本仅支持ESP插件内核，不兼容原版传奇引擎、其他第三方插件，导入前请确认插件环境
