一键回收包裹物品教程 - GOM引擎回收价格配置

调试本地版本的时候，背包里往往堆满了木剑、布衣这类新手装备和练级过程中换下来的旧武器，一件一件手动扣走既慢又容易漏，回收价格对不上还得反复翻脚本核对。一键回收包裹物品就是为这种背包清理场景准备的：NPC对话里写好一条命令，玩家背包里符合条件的物品一次性收走，再按单件结算元宝、金币或者泡点经验，回收脚本一下子就干净了。

GOM引擎把这个回收能力拆成了三条命令，分别按物品名称、按数据库IDX、按物品颜色来圈定回收范围。下面按帮助文档原文，把TakeBagItem的十条参数、单件回收价格的口径、官方示例，以及2023年两次扩展新增的TakeBagItemEX和TakeBagItemColor系统过一遍，再给出NPC脚本的配置步骤、三种回收方式的对比和高频问题。

TakeBagItem格式说明

帮助文档对按物品名称回收的记载，命令格式行原文如下：

TakeBagItem 物品名称 收取数量 元宝值 金币值 泡点值 泡点经验值 变量 聚灵珠经验 物品标识|标识值 物品颜色

这条命令写在NPC脚本的#ACT动作段里，一次就能把背包里所有符合名称的物品批量收走。文档特别强调：注意：回收价格为单件物品价格，也就是说参数3到参数6填的数值是每收一件物品给多少，不是总共给多少，比如元宝回收价格填10，每回收一件物品就得10元宝，回收46件就是460元宝，配置回收价格时务必按单件口径来算。

物品名称参数支持多个物品，用竖线|隔开，这也是它和普通Take逐条收取最大的区别。后面九个参数依次控制数量、三种结算值、记录回收数量的变量、聚灵珠经验、物品标识过滤和物品颜色过滤，参数9和参数10是2023年03月26日才扩展进去的。

参数对照表

参数7是落地调试最有用的一个：它把这一条命令实际收走了多少件物品存进变量，后面配合SENDMSG把<$STR(N1)>打印出来，玩家回收了多少一目了然，不会出现提示文案和实际数量对不上的情况。参数9和参数10在2023年03月26日扩展，写0或留空表示不做这层过滤，需要按标识或颜色精筛时再填具体值。

扩展案例

帮助文档自带的标准示例整块引用如下，一次回收木剑、布衣(男)、布衣(女)三种物品：

[@main]
#ACT
TakeBagItem 木剑|布衣(男)|布衣(女) 46 0 0 0 10000 N1 0
SENDMSG 6 成功回收<$STR(N1)>个木剑，布衣(男)，布衣(女)，价格为10000经验

这组示例里，参数1列了三种新手装备，参数2填46表示最多收46件，参数3到参数5都是0也就是不给元宝和金币，参数6填10000表示每件给10000泡点经验，参数7用N1记录实际回收数，参数8填0不开聚灵珠经验。再看一组带颜色过滤的扩展写法：

#ACT
TakeBagItem 木剑|布衣(男)|布衣(女) 46 0 0 0 10000 N1 0 * *251
SENDMSG 6 成功回收<$STR(N1)>个非极品且物品颜色为251的木剑，布衣(男)，布衣(女)，价格为10000经验

2023年03月26日，一键回收包裹物品命令TakeBagItem扩展了两个参数：参数9物品标识|标识值（写0表示回收所有，如3|1按物品标识3的值为1时回收），参数10物品颜色（空或0回收所有，1到255回收对应颜色物品）。在此基础上，2023年12月3日又新增了两条命令。

第一条是TakeBagItemEX，按物品数据库IDX一键回收包裹物品，参数1填多个物品IDX、编号之间用竖线隔开，比如201|205|310，还支持连续编号如100到150，表示数据库IDX在100到150之间的物品都符合条件，后面参数2到参数8和TakeBagItem一致。它的标准示例如下：

[@main]
#ACT
TakeBagItemEX 29|30-35|38 46 0 0 0 10000 N1 0 * 251|254
SENDMSG 6 成功回收<$STR(N1)>个物品颜色251、254的物品，价格为10000经验

第二条是TakeBagItemColor，按物品名称颜色一键回收包裹物品，同样是2023年12月3日新增，参数1填多个物品颜色、用竖线隔开，比如250|254|253，也支持连续颜色范围如200到254，表示颜色在200到254之间的物品都符合条件，其余参数与前两条保持一致。三条命令的差别集中在参数1：TakeBagItem认名称，TakeBagItemEX认数据库IDX，TakeBagItemColor认物品颜色。

一键回收配置实操

把一键回收功能接到回收NPC上，按下面五步在本地GOM引擎环境里配置即可，每一步都能单独验证。

第一步，打开回收NPC的脚本文件，定位到玩家点击回收后的动作段，在#ACT下面写TakeBagItem命令，参数1按要回收的物品名称填写，多种物品之间用竖线隔开。

第二步，按回收上限填参数2的收取数量，再按单件结算口径填参数3到参数6，元宝、金币、泡点、泡点经验不需要的就填0，要给经验的把单件经验值写进参数6。

第三步，参数7填一个用来记录回收数量的变量如N1，方便后面提示玩家实际回收了多少件；不需要聚灵珠经验就把参数8保持0或留空。

第四步，需要按标识或颜色精筛时再填参数9和参数10，不做过滤就都写0；写完TakeBagItem后下一行补一条SENDMSG 6提示，把<$STR(N1)>插在提示文案里。

第五步，保存脚本后在本地GOM引擎环境重载NPC，先在背包里放几件同名物品做测试，确认回收数量、结算值和提示输出都符合预期，再用带颜色或带标识的物品补测一次参数9、参数10的过滤效果。

回收方式对比

三条命令结算逻辑完全相同，区别只在怎么圈定回收范围。TakeBagItem按物品名称回收，适合装备名称规范、按名字清单回收的常规NPC，配置最直观，新手先从它入手。TakeBagItemEX按数据库IDX回收，物品改名后依然能按编号收走，适合回收那些改过名、或者一批连续编号的装备，不用一个个列名字。TakeBagItemColor按物品颜色回收，适合只回收某一档颜色品质装备的场景，比如只收颜色250到254的高亮装备。

回收脚本里到底用哪一条，看物品是不是改过名、是不是连续编号、是不是按颜色品质区分。名称稳定就用TakeBagItem，要绕开改名问题就换TakeBagItemEX，只按颜色品质筛就用TakeBagItemColor，三条命令可以在同一个NPC里按物品档次分开写，互不影响。

热点问答

1. 传奇服务端一键回收背包怎么弄？

先在回收NPC脚本的#ACT段写TakeBagItem命令，参数1列要回收的物品名称，参数2填回收数量，参数3到参数6按单件口径填结算值，参数7用变量记录实际回收数，再配一条SENDMSG提示玩家。保存后重载NPC，放几件测试物品验证回收数量和到账数值即可，不用逐个物品写Take。整理自百度知道真实提问：传奇服务端一键回收背包怎么弄，2025-12。

2. 传奇回收脚本一般怎么配才顺？

顺的关键是把回收范围和结算值一次写清：参数1用竖线列出所有要回收的物品，参数7接变量记录实际数量，SENDMSG里用<$STR(变量)>回显，避免提示与实际回收件数对不上。物品多时优先用竖线合并到一条命令里，比循环逐条Take更短，也不容易写成死循环。整理自百度知道真实提问：传奇回收脚本，2013-12。

3. 一键回收脚本写成死循环了怎么排查？

死循环多半是把回收判断写成了反复Take又反复判断的结构，物品没收走却一直在同一个判断段打转。正确做法是直接用TakeBagItem一条命令批量收走，它内部一次处理完背包里符合条件的物品，配合参数7记录实际数量，收完就往下走提示，不需要自己写循环；如果原来用CheckItem加Take逐条判断，记得收完用BREAK跳出，别让脚本回头再判断同一件物品。整理自百度知道真实提问：…才接触传奇脚本制作,现在在制作一个一键回收脚本,但是写成死循环了，2011-12。

4. 平时哪些场景最该用一键回收包裹物品？

最典型的是新手装备清理和挂机回收：玩家背包堆满木剑、布衣、旧武器时，一个NPC对话一键清掉并折算成经验或元宝。其次是材料回收和打宝产物回收，把某一类名称或某一档颜色的装备统一折算成泡点经验。凡是需要一次收走多件同名或同类物品的场景，都适合用TakeBagItem系列，比逐条Take省脚本行数。

5. 回收点了没反应，先查哪里？

先查物品名称和参数表位置是否对得上：参数1写的名称必须和背包里物品名完全一致（多个用竖线隔开），再核对参数2收取数量是不是大于背包实际数量。然后看结算参数有没有填成负数或空值，参数7变量有没有写对，最后确认命令确实写在#ACT动作段而不是对话段。逐项排完保存重载，再放测试物品点一次回收。

6. TakeBagItem和普通Take收物品有什么区别？

普通Take一次只收指定名称的一件物品，收多种装备要写好几行；TakeBagItem一次收走背包里所有符合条件的物品，参数1用竖线列多个名称，还能按单件结算元宝、金币和泡点经验，并用变量记录实际回收数量。一句话，Take偏单件收取和扣材料，TakeBagItem偏整批装备回收并折价，回收NPC用后者更合适。

7. 回收价格和回收数量到底怎么算？

回收价格按单件计算，这是文档明确的口径：参数3到参数6填的是每件物品给多少，不是总共给多少。实际到账等于单件价格乘以实际回收件数，而实际回收件数存在参数7的变量里，受背包里符合条件的物品数和参数2数量上限共同限制，所以回收46件、单件10000经验时，总经验是单件乘件数，写SENDMSG时直接引用变量即可。

总结

一键回收包裹物品把背包清理从逐条Take变成了一条命令批量结算，TakeBagItem按名称、TakeBagItemEX按数据库IDX、TakeBagItemColor按颜色三条线覆盖了常规回收、改名物品回收和按品质回收三种需求，配置时抓住单件价格口径、参数7回显数量、参数9和参数10的过滤条件这三件事，回收脚本就不会跑偏。

TakeBagItem系列回收命令的实例都在本地GOM引擎环境里实测过，价格参数与物品名匹配符合预期；命令以GOM引擎为基准开发，换引擎前请自行验证。本篇仅作本地学习调试记录。