传奇极品元素回收检测ESPCheckItemWitemValue脚本使用教程

本文详细讲解传奇服务端极品元素回收检测命令 ESPCheckItemWitemValue 的完整参数含义、使用规则以及实战脚本案例，帮助新手快速掌握装备极品属性批量回收、精准检测的脚本写法，适配各类传奇版本自定义回收功能搭建。

一、ESPCheckItemWitemValue 命令核心参数详解
该命令主要用于检测游戏装备极品属性、元素属性、颜色、星星数量等数据，搭配回收命令可实现精准的极品装备分类回收，是传奇自定义回收系统的核心脚本指令，共包含7个可控参数，每个参数作用及填写规范如下：

参数一：物品名称
支持填写单一装备名称，例如：圣战戒指；填写 * 代表检测全部装备；批量检测多个装备时，可使用| 分割多个装备名称，示例：圣战戒指|圣战戒指A|圣战戒指B。

参数二：极品类型
固定数值选型，对应不同装备检测维度：0=普通属性、1=元素属性、2=装备颜色、3=星星数量。

参数三：极品位置
根据极品类型对应不同数值区间，支持总和计算：
1、普通属性对应区间：0-6；
2、元素属性对应区间：0-19；
3、填写 -1 代表计算对应属性的总和，即普通属性(0-6)全部总和 / 元素属性(0-19)全部总和。

参数四：判断符号
支持基础对比符号：>(大于)、<(小于)、=(等于)，用于判断极品点数数值条件。

参数五：极品点数
自定义设置的极品属性点数阈值，搭配判断符号使用，作为装备回收的判定标准。

参数六：最大回收数量
填写0代表回收全部符合条件的装备；填写非0数值时，若参数七为-1，则回收数量为当前脚本枚举到的装备总数量。

参数七：缓存清空开关(重点)
默认值为0，作用是清除上一次脚本执行的回收缓存数据；填写-1为不清除缓存，多用于多次叠加检测多装备的脚本场景，是批量回收多装备的核心参数，建议结合实战案例测试掌握用法。

二、脚本实战案例演示
所有案例脚本可直接复制使用，代码格式已标准化，适配传奇服务端脚本编译规则，附带详细注释，新手可直接套用修改。

案例1：单次回收单个无极品属性装备
功能需求：单独回收没有任何极品元素属性的圣战戒指，回收后给予5000金币奖励。
#if
ESPCheckItemWitemValue 圣战戒指 1 0 = 0 0
;因为是等于0所以回收没有极品属性的圣战戒指
#Act
ESPTakeItemWitemValue N0
;这个命令是配套ESPCheckItemWitemValue的直接调用，会回收满足检测命令条件的所有装备，仅可在检测命令后使用，其他位置调用无效
;回收命令 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
;第七个参数调写0，清除缓存，作为首次执行检测
ESPCheckItemWitemValue 杀猪刀A 1 -1 = 0 0 -1
;第七个参数改-1，叠加本次装备检测数据，保留上一轮缓存
ESPCheckItemWitemValue 杀猪刀B 1 -1 = 0 0 -1
;第七个参数改-1，继续叠加装备检测数据，实现多装备批量枚举

;以上三行命令完成多装备回收数据枚举，下方执行统一回收逻辑
ESPTakeItemWitemValue N0
;配套检测命令使用，回收所有符合条件的装备
;N0为实时检测到的可回收装备数量
ESPWhile N0 > 0
DEC N0 1
;必须递减数值，避免脚本死循环
give 金币 5000
sendmsg 7 回收成功,金币+5000.
ESPendWhile

三、脚本使用注意事项
1、ESPTakeItemWitemValue 为专属配套命令，必须在 ESPCheckItemWitemValue 检测命令之后使用，单独调用无效；
2、循环回收逻辑中必须添加 DEC N0 1 递减代码，否则会触发脚本死循环，导致服务端卡顿；
3、批量多装备回收时，首条检测参数七填0清空缓存，后续所有装备检测统一填-1叠加数据，避免数据错乱；
4、属性位置参数填写-1时，默认统计对应属性全部区间总和，适合批量筛选无极品、低极品属性装备。