传奇背包物品按商店价格出售脚本 批量回收唯一ID出售教程
本文详解传奇引擎两款核心背包物品商店价格出售脚本，涵盖SellBagItem批量物品出售、SellMakeIndex唯一ID物品出售命令，解析全部参数含义，提供可直接复制的完整脚本案例与使用注意事项，适配传奇版本制作、玩家背包回收功能开发。…
在传奇版本制作、私服运维过程中，背包物品批量回收、按商店价出售功能是玩家体验优化、版本功能完善的核心模块。本文详解两款主流的背包物品商店价格出售脚本命令，包含多物品批量出售、唯一ID精准出售两种方案，附带完整参数解析与可直接套用的脚本案例，适配996传奇引擎，帮助开发者快速实现背包物品一键出售功能。
一、一键按价出售背包多物品脚本（SellBagItem）
该命令适用于批量回收、指定多物品一键按商店价格出售场景，支持物品批量串联、极品属性筛选、出售数据变量记录，是传奇版本中最常用的通用回收脚本命令。
1.1 完整命令格式
SellBagItem 物品名称 数量变量 金币变量 极品回收模式 颜色参数
1.2 参数详细说明
物品名称：支持单个物品或多个物品串联，多物品使用竖杠|分隔，精准匹配游戏内物品数据库名称；
数量变量：必填变量，用于脚本内保存本次实际成功出售的物品总数量；
金币变量：可选变量，用于保存本次出售物品获得的总金币数值，留空则不记录；
极品回收模式：控制极品物品回收规则，0/空=全部回收（含极品），1=不回收极品物品，2=仅回收极品物品；
颜色参数：可选参数，取值范围0-255，指定仅回收对应颜色的物品，留空则适配全部颜色。
1.3 可直接使用完整脚本案例
[@main]
#ACT
;一键出售背包内屠龙、天魔神甲等指定装备，记录出售数量与总金币
SellBagItem 屠龙|天魔神甲|怒斩|圣战戒指 N$数量 N$总金币
;向玩家推送出售结果提示
SENDMSG 6 成功回收<$STR(N$数量)>个物品获得金币<$STR(N$总金币)>
二、按商店价格出售唯一ID物品脚本（SellMakeIndex）
该命令针对物品唯一ID精准出售场景，区别于名称匹配，可针对单/多个指定ID物品定向按商店价出售，适合个性化物品管控、限定物品回收等定制化功能开发，常配合背包遍历指令使用。
2.1 完整命令格式
SellMakeIndex 物品唯一ID 金币变量
2.2 参数详细说明
参数1（物品唯一ID）：目标物品的数据库唯一ID，多个ID可使用逗号,串联，实现多ID同步出售；
参数2（金币变量）：可选变量，保存本次ID物品出售获得的总金币，为空则不统计写入金币数据。
2.3 可直接使用完整脚本案例
本案例结合背包遍历指令，实现读取玩家全部背包物品，按唯一ID批量出售并推送提示，适配全物品通用出售场景：
[@main]
#IF
#ACT
;初始化背包物品数据存储变量
MOV S$递增物品唯一ID
MOV S$递增物品名称
MOV S$递增物品数量
;遍历玩家背包所有物品，读取ID、名称、数量
LoopBagItems @获取当前背包所有物品 N$物品唯一ID S$物品的名称 S$物品的数量
;根据物品唯一ID按商店价出售，记录总金币
SellMakeIndex <$STR(S$递增物品唯一ID)> N$总金币
;推送单个物品出售提示
SENDMSG 6 成功出售<$STR(S$递增物品名称)>-获得金币：<$STR(N$总金币)>
;背包物品遍历赋值分段逻辑
[@获取当前背包所有物品]
#IF
#ACT
;拼接所有背包物品数据至对应变量
INC S$递增物品唯一ID <$STR(N$物品唯一ID)>,
INC S$递增物品名称 <$STR(S$物品的名称)>,
INC S$递增物品数量 <$STR(S$物品的数量)>,
三、脚本使用注意事项
1、物品名称、唯一ID必须严格匹配版本物品数据库，错别字、符号偏差会导致脚本执行失效；
2、极品回收模式仅针对游戏内标注极品属性的装备，普通装备不受该参数影响；
3、变量命名建议遵循引擎规范，统一使用N$数值变量、S$字符串变量，避免变量冲突报错；
4、颜色参数仅对带颜色区分的物品生效，无颜色属性的物品无需填写该参数。
