详细介绍一下GEE引擎中ITEMRECYCLEEX命令的参数

39传奇素材网

GEE 引擎中的 ITEMRECYCLEEX 命令是实现精细化物品回收的核心功能，其参数设计支持多维度筛选和多样化奖励配置。以下是参数的详细解析与应用示例：
一、参数结构与功能总览
plaintext
ITEMRECYCLEEX 玩家名 物品名称 最小强化等级 品质要求 奖励类型 奖励数值


参数        类型        功能描述
玩家名        字符串        目标玩家角色名（支持变量，如 <$USERNAME>）
物品名称        字符串        需回收的物品全称（需与 Item.txt 中定义完全一致，区分大小写）
最小强化等级        整数        仅回收强化等级 ≥ 该值的物品（0 表示不限制强化等级）
品质要求        整数        仅回收品质 ≥ 该值的物品（0 表示不限制品质）
奖励类型        整数        回收后的奖励类型（1= 金币，2= 经验，3= 指定材料，4= 元宝，5= 声望）
奖励数值        整数 / 字符串        对应奖励类型的具体数值（如奖励类型为 3 时，数值为材料在 Item.txt 中的 ID）
二、参数深度解析与示例
1. 玩家名
支持变量：可使用 <$USERNAME> 指代当前对话玩家，或通过变量传递（如 <$STR(N1)>）。
特殊场景：若需回收全体玩家的物品，需结合循环脚本（如遍历 PlayerList.txt）。
示例：
plaintext
ITEMRECYCLEEX <$USERNAME> 裁决之杖 5 4 3 102  ; 回收当前玩家的高强化武器

2. 物品名称
精确匹配：必须与 Item.txt 中的物品名称完全一致（包括空格和括号，如 裁决之杖(+7)）。
批量回收：支持使用 | 分隔多个物品（如 裁决之杖|骨玉权杖）。
特殊字符处理：若物品名称包含特殊符号（如 [、]），需在脚本中使用转义符 \（如 ITEMRECYCLEEX 张三 屠龙\[+9\] 9 5 1 100000）。
示例：
plaintext
ITEMRECYCLEEX 李四 裁决之杖|骨玉权杖 3 3 2 50000  ; 回收两种武器，奖励经验

3. 最小强化等级
取值范围：0（不限制）~ 99（根据引擎配置上限）。
强化等级判定：引擎通过 Item.txt 中的 UpgradeCount 字段识别强化等级（如 UpgradeCount=5 表示 +5）。
示例：
plaintext
ITEMRECYCLEEX 王五 龙纹剑 5 0 1 200000  ; 回收强化≥5的任意品质龙纹剑，奖励20万金币

4. 品质要求
品质体系：GEE 引擎的物品品质通过 Item.txt 中的 Quality 字段定义，取值范围为 1（普通）~ 5（神器）。
筛选逻辑：
0：不限制品质，回收所有品质的该物品。
3：仅回收品质为 精良、史诗、神器 的物品。
示例：
plaintext
ITEMRECYCLEEX 张三 麻痹戒指 0 5 4 10  ; 回收任意强化的神器品质麻痹戒指，奖励10元宝

5. 奖励类型
类型值        奖励类型        奖励数值含义
1        金币        直接增加玩家金币数量（数值范围：0~2147483647）
2        经验        直接增加玩家经验值（支持负数，如 ITEMRECYCLEEX ... 2 -50000 可扣除经验）
3        指定材料        奖励 Item.txt 中对应 ID 的材料（如 102 对应金刚石）
4        元宝        直接增加玩家元宝数量（需引擎开启元宝系统）
5        声望        直接增加玩家声望值（需引擎配置声望系统）

组合奖励：若需同时给予多种奖励，需分两次执行命令（如先奖励金币再奖励材料）。
示例：
plaintext
ITEMRECYCLEEX 测试玩家 沃玛号角 0 2 3 205  ; 回收任意强化的优秀品质沃玛号角，奖励ID=205的材料

6. 奖励数值
材料 ID 验证：当 奖励类型=3 时，奖励数值 必须是 Item.txt 中存在的材料 ID（如 205 对应 Item.txt 中的第 205 行）。
数值范围：
金币 / 经验 / 元宝 / 声望：-2147483648 ~ 2147483647（支持负数扣除）。
材料数量：默认奖励 1 个，若需多个可通过 GIVE 命令叠加。
示例：
plaintext
ITEMRECYCLEEX 李四 记忆项链 4 3 3 205,206  ; 无效！奖励数值仅支持单个ID，需分两次执行

三、特殊场景与注意事项
1. 变量与动态参数
动态物品名称：可通过变量传递物品名称（需预先通过 MOV 命令赋值）。
plaintext
MOV S1 裁决之杖
ITEMRECYCLEEX 张三 <$STR(S1)> 5 4 3 102

动态强化等级：支持通过 <$STR(N1)> 等变量传递数值。
plaintext
MOV N1 5
ITEMRECYCLEEX 王五 骨玉权杖 <$STR(N1)> 3 3 20000

2. 参数冲突处理
优先级规则：若多个 ITEMRECYCLEEX 命令匹配同一物品，最后执行的命令生效。
冲突示例：
plaintext
ITEMRECYCLEEX 张三 裁决之杖 5 4 3 102  ; 优先回收强化≥5的史诗品质裁决
ITEMRECYCLEEX 张三 裁决之杖 3 3 3 205  ; 若物品满足强化≥3且品质≥3，最终奖励205材料

3. 日志与调试
引擎日志：回收操作会记录在 Log/Recycle.log 中，包含玩家名、物品名称、奖励类型等信息。
调试技巧：
plaintext
#IF
  CHECKITEM 裁决之杖 1
#ACT
  ITEMRECYCLEEX <$USERNAME> 裁决之杖 5 4 3 102
  SENDMSG 6 回收成功！获得102号材料

4. 与其他命令的配合
批量回收：结合 TAKEBAGITEM 命令实现一键回收（需编写复杂脚本）。
条件筛选：通过 CHECKITEM 命令预先检测物品是否存在。
plaintext
#IF
  CHECKITEM 裁决之杖 1
  CHECKUSERVALUE HP 1000
#ACT
  ITEMRECYCLEEX <$USERNAME> 裁决之杖 5 4 3 102

四、参数配置对照表
参数        合法值示例        非法值示例        错误后果
玩家名        张三、<$USERNAME>        张 三（含空格）        引擎无法识别玩家，命令失效
物品名称        裁决之杖、麻痹戒指        裁决杖（名称不全）        引擎无法匹配物品，命令失效
最小强化等级        0、5        -1、100        引擎自动修正为 0 或上限值
品质要求        0、3        6、-1        引擎自动修正为 0 或上限值
奖励类型        1、3        6、0        引擎默认视为 1（金币）
奖励数值        100000、102        金币、金刚石        引擎无法解析，命令失效
五、典型应用场景
1. 高价值装备定向回收
plaintext
ITEMRECYCLEEX 李四 屠龙 7 5 4 50  ; 回收强化+7的神器品质屠龙，奖励50元宝
2. 新手引导回收
plaintext
ITEMRECYCLEEX 张三 木剑 0 0 1 500  ; 回收任意木剑，奖励500金币（用于新手启动资金）
3. 材料换购系统
plaintext
ITEMRECYCLEEX 王五 铁矿 0 0 3 205  ; 回收铁矿兑换指定材料（如铁矿→金刚石）
4. 惩罚性回收
plaintext
ITEMRECYCLEEX 张三 裁决之杖 0 0 2 -50000  ; 回收武器并扣除5万经验（用于违规惩罚）
六、常见问题与解决方案
问题现象        可能原因        解决方案
回收后无奖励        奖励类型与数值不匹配（如 奖励类型=3 但 奖励数值 非有效材料 ID）        检查 Item.txt 中的材料 ID 是否存在，确保 奖励数值 正确
物品名称匹配失败        物品名称包含特殊符号未转义（如 裁决之杖[+7] 未写成 裁决之杖\[+7\]）        使用转义符 \ 处理特殊符号
强化等级筛选失效        Item.txt 中的 UpgradeCount 字段未正确配置强化等级        检查物品配置文件，确保 UpgradeCount 与实际强化等级一致
品质筛选失效        Item.txt 中的 Quality 字段未正确配置品质（如 Quality=0 表示普通）        修正 Item.txt 中的品质值，确保 品质要求 参数与配置一致

通过以上参数解析与示例，开发者可灵活设计符合需求的回收规则，实现从基础装备回收（如新手木剑换金币）到高端装备定向回收（如神器换元宝）的全场景覆盖。核心是确保 物品名称 与 Item.txt 完全一致，并合理组合 最小强化等级 和 品质要求 实现精准筛选。