传奇极品元素回收检测脚本教程 ESPCheckItemWitemValue参数详解
摘要：本文详细讲解传奇ESP插件ESPCheckItemWitemValue极品元素回收检测命令，拆解七大运行参数含义，提供单装备、多装备批量回收可直接复制的脚本案例，标注新手常见报错避坑要点，帮助传奇版本制作者快速配置自定义极品装备回收功能。…
一、命令概述
ESPCheckItemWitemValue是传奇ESP插件核心极品元素回收检测命令，主要用于精准检测角色背包内装备的普通属性、元素属性、颜色、星星数量等词条数值，搭配配套回收命令实现自定义极品装备回收逻辑。该命令支持单装备、多装备批量检测，可灵活设置属性判定条件、回收数量与数据缓存规则，是传奇版本定制智能回收功能的核心脚本指令。
配套核心回收命令：ESPTakeItemWitemValue，仅可在ESPCheckItemWitemValue检测后调用，用于回收所有满足检测条件的装备。
二、ESPCheckItemWitemValue七大参数详解
命令完整格式：ESPCheckItemWitemValue 参数一 参数二 参数三 参数四 参数五 参数六 参数七
参数一：物品名称
指定需要检测的装备名称，填写*代表检测服务器全部装备；多件装备批量检测时，使用|分割多个装备名称。示例：圣战戒指|屠龙刀|裁决之杖。
参数二：极品类型
定义需要检测的装备词条分类，固定取值如下：
0=普通基础属性，1=元素附加属性，2=装备颜色标识，3=装备星星数量
参数三：极品位置
区分不同属性的检测索引，支持区间取值与总和计算：
普通属性取值范围0-6，元素属性取值范围0-19；填写-1时，自动计算对应分类下所有位置属性的总和数值，无需单独指定单个索引。
参数四：判断符号
设置属性数值的判定逻辑，仅支持三种运算符：>（大于）、<（小于）、=（等于）。
参数五：极品点数
自定义判定的基准数值，结合参数四的符号，筛选出符合数值条件的装备。
参数六：最大回收数量
限制本次脚本可回收的装备总量：填写0代表回收所有符合条件装备；数值非0时，结合参数七可限定单次回收的装备上限。
参数七：缓存清空规则（重点）
控制多次检测指令之间的数据缓存逻辑，也是新手最易出错的参数，默认值为0：
0=清空上一轮检测缓存数据，用于脚本首轮检测初始化；-1=保留历史缓存数据，将当前检测装备数据与上一轮数据叠加，适用于多装备批量检测场景。
该参数无需死记硬背，建议结合下文实战案例本地测试，快速理解缓存叠加逻辑。
三、配套回收命令说明
ESPTakeItemWitemValue N0
专属配套回收指令，必须在ESPCheckItemWitemValue检测命令执行后调用，在其他脚本位置调用无效。参数N0为动态返回值，代表当前筛选完成、可回收的装备总数量。
四、实战脚本案例（可直接复制使用）
案例1：单次回收无元素属性的指定装备
功能需求：检测并回收背包内没有任何元素属性的圣战戒指，回收后给予5000金币奖励。
#if
ESPCheckItemWitemValue 圣战戒指 1 0 = 0 0
;参数释义：检测圣战戒指、元素属性、0号位置、数值等于0、回收全部、清空缓存
;逻辑：筛选无元素属性（元素位置0数值为0）的圣战戒指
#Act
ESPTakeItemWitemValue N0
;调用回收指令，读取符合条件的装备总数存入N0
ESPWhile N0 > 0
DEC N0 1
;必须递减1，否则会触发死循环
give 金币 5000
sendmsg 7 回收成功,金币+5000.
ESPendWhile
案例2：多装备批量回收无元素属性装备
功能需求：同时检测圣战戒指、杀猪刀A、杀猪刀B三件装备，回收所有无元素属性的装备，统一发放5000金币奖励。
#IF
#Act
ESPCheckItemWitemValue 圣战戒指 1 -1 = 0 0 0
;首轮检测，参数7为0清空缓存，统计圣战戒指全元素属性总和为0的装备
ESPCheckItemWitemValue 杀猪刀A 1 -1 = 0 0 -1
;叠加检测，参数7为-1保留缓存，数据合并至上述列表
ESPCheckItemWitemValue 杀猪刀B 1 -1 = 0 0 -1
;继续叠加检测，完成三件装备的数据枚举
;统一回收所有叠加筛选后的符合条件装备
ESPTakeItemWitemValue N0
ESPWhile N0 > 0
DEC N0 1
;必须递减1，规避死循环问题
give 金币 5000
sendmsg 7 回收成功,金币+5000.
ESPendWhile
五、新手常见避坑要点
1. 指令调用顺序固定：必须先执行ESPCheckItemWitemValue检测，再调用ESPTakeItemWitemValue回收，顺序颠倒无效果。
2. 循环语句必写递减：ESPWhile循环内部必须添加DEC N0 1指令，缺失该语句会导致脚本死循环，服务器卡顿。
3. 多装备检测缓存规则：批量检测时，仅第一条检测指令参数7设为0，后续所有叠加指令参数7必须设为-1。
4. 属性位置取值区分：普通属性仅支持0-6，元素属性仅支持0-19，超出区间会导致检测失效。
