传奇一键回收包裹物品脚本大全 TakeBagItem命令完整用法教程
在传奇私服版本搭建、脚本定制运营过程中，包裹物品一键回收是玩家体验优化、服务器减负的核心功能。很多GM在配置回收脚本时，常遇到参数填写错误、物品识别失效、变量读取异常等问题。本文详细解析传奇一键回收包裹物品全系脚本命令，包含基础回收、变量读取、数据库IDX回收、颜色值回收、英雄背包回收等完整用法，适…
在传奇私服版本搭建、脚本定制运营过程中，包裹物品一键回收是玩家体验优化、服务器减负的核心功能。很多GM在配置回收脚本时，常遇到参数填写错误、物品识别失效、变量读取异常等问题。本文详细解析传奇一键回收包裹物品全系脚本命令，包含基础回收、变量读取、数据库IDX回收、颜色值回收、英雄背包回收等完整用法，适配GOM、GEEM等主流引擎，帮助GM快速配置可用的物品回收脚本。
一、传奇基础一键回收脚本：TakeBagItem核心命令
1.1 基础命令标准格式详解
TakeBagItem是传奇引擎原生的包裹物品一键回收核心命令，支持多物品匹配、属性定制、提示控制等功能，完整参数顺序固定，参数缺失会直接导致脚本失效，标准格式如下：
TakeBagItem 物品名称(支持多个物品) 收取数量 增加元宝值 增加金币值 增加泡点值 增加经验值 变量(保存实际回收的物品数量) 聚灵珠经验 是否显示提示信息 颜色值 是否回收极品 是否回收改名 回收指定等级以下物品
1.2 全参数释义（GM必看）
物品名称：支持单物品或多物品用|分隔，精准匹配背包内物品；
收取数量：单次脚本触发可回收的物品最大数量；
增加元宝值/金币值/泡点值/经验值：单件物品回收后玩家获得的对应资源数值；
变量：自定义变量（N1/N99等），用于存储本次实际成功回收的物品数量，可用于弹窗提示；
聚灵珠经验：为空或0时不增加聚灵珠经验，填写1时同步叠加聚灵珠存储经验；
是否显示提示信息：0或空为弹出回收提示，1为隐藏系统提示；
颜色值：空或*代表回收所有颜色物品，0-255为指定装备颜色，多颜色用|分隔；
是否回收极品：为空或0允许回收极品装备，1则跳过极品物品不回收；
是否回收改名：0或空回收改名装备，1跳过改名专属物品；
回收指定等级以下物品：0或空不限制物品等级，填写数值则仅回收该等级以下装备。
1.3 基础可直接运行脚本示例
以下脚本为新手常用的基础回收配置，无颜色限制、回收基础新手装备，触发后推送明确系统提示：
[@main]
#ACT
;分别为不区分颜色，回收指定物品指定颜色
TakeBagItem 木剑|布衣(男)|布衣(女) 46 0 0 0 10000 N1 0
;TakeBagItem 木剑|布衣(男)|布衣(女) 46 0 0 0 10000 N1 0 0 255|243|253|251
;TakeBagItem 木剑|布衣(男)|布衣(女) 46 0 0 0 10000 N1 0 0 251
SENDMSG 6 成功回收<$STR(N1)>个木剑，布衣(男)，布衣(女)，价格为10000经验
注释：带分号的代码行为注释内容，引擎不会执行，可根据需求取消注释启用指定颜色回收规则。
二、进阶回收：物品名称变量读取脚本配置
固定物品名称脚本适合基础装备回收，针对高阶装备批量管理，推荐使用物品名称变量调用模式，将回收物品列表写入TXT文本，无需修改脚本即可批量更新回收清单，大幅降低版本维护难度。
2.1 变量调用核心命令
TakeBagItem <$STR(S99)> 46 0 1000 0 0 N99 0
释义：通过全局字符串变量S99读取预设物品名称，实现动态物品回收，参数规则与基础命令完全一致。
2.2 读取外部TXT清单完整脚本
该脚本可读取QuestDiary目录下的装备清单文件，自动读取列表内所有物品进行回收，是商业版本常用配置方案：
[@dddd]
#act
GetListString ..\QuestDiary\装备.txt 0 S1
TakeBagItem <$STR(S1)> 46 0 1000 0 0 N99 0
sendmsg 6 回收<$STR(n99)> 个物品
2.3 外部装备.TXT文件内容规范
文件路径必须放置在服务端根目录QuestDiary文件夹内，物品名称用|分隔，无多余空格，标准内容示例：
力量戒指|紫碧螺|泰坦戒指|骑士手镯|龙之手镯|心灵手镯|阎罗手套|裁决之杖
三、精准回收：数据库IDX编号专属回收脚本
2019年03月引擎更新新增TakeBagItemEx命令，打破物品名称匹配限制，直接通过数据库IDX编号回收物品，彻底解决重名装备、自定义道具回收识别错误问题，适合定制版本、专属道具回收配置。
3.1 TakeBagItemEx命令标准格式
TakeBagItemEx 物品编号 收取数量 增加元宝值 增加金币值 增加泡点值 增加经验值 变量(保存实际回收的物品数量) 聚灵珠经验 是否显示提示信息 颜色值 回收极品
核心特性：物品编号支持单个编号、多编号|分隔、连续编号区间（起始-结束），适配批量区间回收需求。
3.2 IDX编号回收脚本示例
;回收多个物品，编号之间用|分隔 支持多个连续的物品编号
TakeBagItemEx 55|60-65|70|100-120|155 46 0 0 0 10000 N1 0
SENDMSG 6 成功回收<$STR(N1)>个物品，价格为10000经验
提示：物品IDX编号可在服务端DB数据库中查询，修改编号区间即可精准控制回收道具范围。
四、定向回收：基于装备Color颜色值回收脚本
针对传奇装备颜色分级（普通、精品、稀有、神器等）场景，引擎新增TakeBagItemColor命令，根据装备数据库Color颜色值定向回收，无需区分物品名称，统一回收同品级装备，简化高阶品级回收配置。
4.1 TakeBagItemColor命令标准格式
TakeBagItemColor 物品颜色 收取数量 增加元宝值 增加金币值 增加泡点值 增加经验值 变量(保存实际回收的物品数量) 聚灵珠经验 是否显示提示信息 是否回收极品
4.2 颜色值回收脚本示例
;回收多个物品，颜色之间用|分隔 支持多个连续的物品颜色
TakeBagItemColor 55|60-65|70|100-120|155 46 0 0 0 10000 N1 0
SENDMSG 6 按照物品颜色成功回收<$STR(N1)>个物品，价格为10000经验
应用场景：可批量回收所有红色、金色品级装备，无需逐个添加物品名称，大幅简化高爆率版本的回收脚本配置。
五、英雄专属：英雄背包物品回收脚本用法
常规回收命令仅针对主号背包，如需回收英雄背包内的物品，只需在所有回收命令前添加H.前缀，参数规则、格式、取值逻辑与主号完全一致，回收收益归属主号本人。
5.1 英雄回收核心示例
H.TakeBagItem 圣战套装|法神套装|天尊套装 20 50 0 0 50000 N2 0
释义：一键回收英雄背包内的三大职业套装物品，单件回收获得50元宝、5万经验，回收数量存入变量N2，可自定义弹窗提示。
六、回收脚本通用补充说明
1. 价格计算规则：所有脚本中设置的回收价格均为单件物品价格，例如设置元宝回收值为10，代表每件回收物品玩家可获得10元宝，批量回收时自动叠加计算；
2. 引擎适配性：本文所有脚本兼容GOM引擎、GEEM引擎、HERO引擎，老旧引擎需核对参数位数，避免参数溢出导致脚本报错；
3. 变量规范：数值变量推荐使用N开头，字符串变量使用S开头，避免变量冲突导致回收数量统计错误；
4. 权限控制：可结合#CHECKITEM、#IF等判断命令，增加回收等级、转生、元宝权限限制，打造差异化回收功能。
