传奇唯一ID存仓脚本教程 完整版仓库入库脚本参数详解
本文详解传奇唯一ID存仓脚本核心指令TAKEITEMTOSTORAGE参数用法，解析仓库剩余格子系统变量，提供可直接复制的智能存仓完整脚本，附带逻辑说明与GM配置注意事项，适配996引擎，助力传奇版本开发配置。…
在传奇版本制作、自定义功能开发过程中，物品精准存仓是高频刚需功能。其中唯一ID存仓脚本可精准定位物品身份，规避重复入库、异常掉落、属性错乱等问题，是传奇GM配置版本、优化仓库机制的核心脚本工具。本文详解传奇唯一ID存仓功能指令、参数用法、仓库格子检测变量以及完整可直接投产的脚本案例，适配996引擎。
一、唯一ID存仓功能概述
传奇唯一ID存仓，核心是通过物品专属唯一标识，将指定物品定向存入游戏仓库对应页面。该功能区别于普通批量存仓，可精准锁定单个物品，避免同外观物品混淆入库，广泛应用于专属装备、绑定道具、定制材料等物品的入库管控场景。
功能核心限制：唯一ID存仓操作必须在物品入包后执行，未进入玩家背包的物品，无法调用该指令完成仓库存储。
二、核心存仓指令与参数解析
2.1 主指令：TAKEITEMTOSTORAGE
该指令为传奇引擎内置唯一ID存仓核心指令，作用是将指定唯一ID的物品存入目标仓库页面，指令后需携带两个必填参数，缺一不可。
2.2 指令参数明细
参数1：存入仓库的页数。指定物品需要存入的仓库页码，支持1-5页常规仓库页面配置，需结合仓库剩余格子检测逻辑调用。
参数2：物品唯一ID。游戏内物品生成时自动生成的专属标识，通过变量<$NEWBAGITEMID>调取，精准定位目标物品。
三、仓库剩余格子检测系统变量
传奇引擎提供专属系统变量，可实时读取仓库各页面剩余空格数量，用于自动判断最优存入页面，无需人工指定页码，实现智能存仓。
<$STORAGEPAGECNT(1)>：仓库第一页剩余格子数量
<$STORAGEPAGECNT(2)>：仓库第二页剩余格子数量
<$STORAGEPAGECNT(3)>：仓库第三页剩余格子数量
<$STORAGEPAGECNT(4)>：仓库第四页剩余格子数量
<$STORAGEPAGECNT(5)>：仓库第五页剩余格子数量
脚本运行时可通过判断上述变量数值，优先将物品存入有剩余空间的靠前仓库页面，优化玩家使用体验。
四、完整版传奇唯一ID智能存仓脚本（可直接复制）
以下脚本已完成逻辑优化，支持物品属性校验、绑定标记判断、自动页码检测，适配全主流传奇引擎，导入即可使用。
[@addbag]
#IF
#ACT
LINKITEMBYMAKEINDEX <$NEWBAGITEMID>
#IF
NOT CheckItemFlag -1 32
#ACT
#ELSEACT
BREAK
#OR
CHECKITEMADDVALUE -1 0 > 0
CHECKITEMADDVALUE -1 1 > 0
CHECKITEMADDVALUE -1 2 > 0
CHECKITEMADDVALUE -1 3 > 0
CHECKITEMADDVALUE -1 4 > 0
#ACT
MOV N$可存入 1
MOV N$存入页 0
GOTO @存入页判断
#ELSEACT
MOV N$可存入 0
BREAK
#IF
LARGE N$存入页 0
EQUAL N$可存入 1
#ACT
SetItemFlag -1 32 1
TAKEITEMTOSTORAGE <$STR(N$存入页)> <$NEWBAGITEMID>
sendmsg 7 物品<$CURRTEMNAME>已存入到仓库的第<$STR(N$存入页)>页
[@存入页判断]
#IF
LARGE <$STORAGEPAGECNT(1)> 0
#ACT
MOV N$存入页 1
BREAK
#IF
LARGE <$STORAGEPAGECNT(2)> 0
#ACT
MOV N$存入页 2
BREAK
#IF
LARGE <$STORAGEPAGECNT(3)> 0
#ACT
MOV N$存入页 3
BREAK
#IF
LARGE <$STORAGEPAGECNT(4)> 0
#ACT
MOV N$存入页 4
BREAK
#IF
LARGE <$STORAGEPAGECNT(5)> 0
#ACT
MOV N$存入页 5
BREAK
五、脚本核心逻辑说明
第一步：物品入包校验。通过[@addbag]入库触发标签，调取物品唯一ID，完成物品基础绑定校验。
第二步：属性与标记检测。判断物品是否存在指定标记、自定义属性，筛选符合存仓条件的物品，过滤异常道具。
第三步：自动页码判定。跳转至存入页判断段，按仓库1-5页顺序检测剩余格子，自动赋值最优存入页码。
第四步：执行存仓指令。标记物品入库状态，调用TAKEITEMTOSTORAGE指令完成存仓，并向玩家推送入库提示信息。
六、GM配置常见注意事项
1. 该脚本仅针对已进入玩家背包的物品生效，离线物品、地面掉落物品无法触发存仓指令。
2. 仓库页面变量仅支持1-5页，超出页数范围会导致指令失效，配置时请勿修改变量后缀数字。
3. 物品标记32为专属存仓锁定标记，开启后物品无法二次流转，如需解绑可删除SetItemFlag对应执行行。
4. 适配996引擎，其他小众引擎需核对系统变量兼容性后再导入使用。
