传奇极品元素回收检测脚本教程 ESPCheckItemWitemValue命令详解

一、命令概述

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时，优先核对对应属性类型区间，普通属性与元素属性不可混用范围。