传奇极品元素回收检测脚本教程 ESPCheckItemWitemValue命令详解
摘要：本文详解传奇ESP插件ESPCheckItemWitemValue检测命令，拆解七大参数含义，提供单物品、多装备批量极品元素回收实战脚本案例，标注脚本编写避坑要点，适配传奇版本制作、ESP插件装备回收系统搭建，所有脚本可直接复制用于传奇服务端配置。…
一、命令概述
ESPCheckItemWitemValue是传奇ESP插件核心检测命令，主要用于检测装备极品属性、元素属性、颜色、星星数量等数据，搭配回收执行命令实现精细化极品装备回收功能。该命令支持单物品、多物品批量检测，可自定义属性阈值与回收规则，是传奇版本制作中极品元素回收系统的核心脚本指令。
配套执行命令：ESPTakeItemWitemValue，仅可在ESPCheckItemWitemValue检测后调用，用于回收符合检测条件的装备。
二、命令完整语法与七大参数详解
命令原型：ESPCheckItemWitemValue 参数一 参数二 参数三 参数四 参数五 参数六 参数七
2.1 参数一：物品名称
指定需要检测的装备名称，支持两种配置方式：单独装备名称，填写*代表服务器全部装备；多装备批量检测使用竖线|分割，示例：圣战戒指|圣战戒指A|杀猪刀B。
2.2 参数二：极品类型
定义需要检测的装备属性分类，固定取值如下：0为普通属性，1为元素属性，2为装备颜色，3为装备星星数。
2.3 参数三：极品位置
区分不同属性的检测索引，支持总和计算模式：普通属性取值范围0-6，元素属性取值范围0-19；填写-1时，自动计算对应类型下所有位置属性的总和值，无需单独指定单个位置。
2.4 参数四：判断符号
用于属性数值比对的逻辑符号，仅支持三种取值：>大于、<小于、=等于。
2.5 参数五：极品点数
自定义属性阈值数值，结合判断符号筛选符合条件的装备，无固定取值限制，根据版本需求自定义。
2.6 参数六：最大回收数量
限制本次检测的装备回收上限：填写0代表回收全部符合条件装备；非0数值时，若参数七为-1，该数值等同于已枚举的装备总数量。
2.7 参数七：缓存清空模式（重点）
控制是否清空上一次检测的回收缓存数据，默认值为0：0代表清空以往缓存数据，适用于脚本首次执行；-1代表保留缓存数据，用于多次叠加检测，实现多装备数据合并枚举，该参数需结合实际脚本场景测试适配。
三、配套核心命令说明
3.1 ESPTakeItemWitemValue
专属回收执行命令，必须在ESPCheckItemWitemValue检测命令之后调用，其他位置调用无效。参数N0为返回值，代表当前检测通过的装备总数量，是后续循环回收的核心变量。
3.2 ESPWhile循环指令注意事项
执行批量回收时必须搭配DEC N0 1指令，每次循环将数量变量减1；缺少该指令会触发死循环，导致服务器卡顿、脚本卡死，属于脚本编写必避坑点。
四、实战脚本案例（可直接复制使用）
4.1 案例一：单次回收无极品属性圣战戒指
功能说明：精准检测并回收未携带任何元素属性的圣战戒指，单件触发回收奖励
#if
ESPCheckItemWitemValue 圣战戒指 1 0 = 0 0
;检测规则：圣战戒指-元素属性-0号位-等于0点属性-全额回收
#Act
ESPTakeItemWitemValue N0
;调用回收指令，获取符合条件装备数量N0
ESPWhile N0 > 0
DEC N0 1
;变量递减，规避死循环
give 金币 5000
sendmsg 7 回收成功,金币+5000.
ESPendWhile
4.2 案例二：多装备批量叠加回收（无元素属性装备）
功能说明：同时检测圣战戒指、杀猪刀A、杀猪刀B三类装备，统一回收无元素属性目标，利用参数七叠加缓存数据
#IF
#Act
ESPCheckItemWitemValue 圣战戒指 1 -1 = 0 0 0
;首次检测清空缓存，枚举圣战戒指无元素属性数据
ESPCheckItemWitemValue 杀猪刀A 1 -1 = 0 0 -1
;保留缓存，叠加杀猪刀A检测数据
ESPCheckItemWitemValue 杀猪刀B 1 -1 = 0 0 -1
;保留缓存，叠加杀猪刀B检测数据
ESPTakeItemWitemValue N0
;统一回收所有枚举完成的符合条件装备
ESPWhile N0 > 0
DEC N0 1
;变量递减，规避死循环
give 金币 5000
sendmsg 7 回收成功,金币+5000.
ESPendWhile
五、脚本编写常见避坑要点
1. 命令调用顺序固定，必须先执行ESPCheckItemWitemValue检测，再调用ESPTakeItemWitemValue回收，倒置调用无效果。
2. 多装备批量检测时，首条检测语句参数七必须设为0清空缓存，后续叠加检测设为-1，避免数据错乱。
3. ESPWhile循环体内强制添加DEC N0 1变量递减指令，杜绝服务器死循环故障。
4. 属性位置参数填写-1时，优先核对对应属性类型区间，普通属性与元素属性不可混用范围。
