原创 付费 【1.7-1.21+|Folia】WarZStorage —— ✨ 私人仓库系统 × RPG经济玩法 × 双仓库灵魂堆叠 × 完全自定义 GUI 1.9.2

[MD] ### v1.5.3 (2026-04-18) * **[修复]** 修复 CatServer 1.12.2 下灵魂仓库点击 `SWAP_OFFHAND` 报错的问题。 * 兼容旧核心对 `ClickType` 枚举的差异，避免点击灵魂仓库时抛出 `NoSuchFieldError`。 * 异常情况下现在会优先取消点击事件并保留数据安全，不再出现“点完切页后第一页物品消失”的假象。 * **[修复]** 修复灵魂仓库同类物品不自动叠加的问题。 * 现在会优先扫描所有已解锁灵魂仓库页并合并同类物品，而不是只在当前槽位或当前页处理。 * **[新增]** 新增灵魂仓库自动拾取开关。 * 玩家可使用 `/warzstorage autopickup [on|off]` 切换状态。 * 开启后，地面拾取物品会优先进入灵魂仓库；状态会持久保存到 YAML / SQLite / MySQL。 [/MD]

[MD] ### v1.5.2 (2026-04-11) * **[修复]** 修复页码选择菜单未正确识别权限页的问题。 * 玩家拥有 `unlock_levels` 中配置的对应 `permission` 后，页码菜单会直接将对应页数显示为可访问，而不再固定显示为屏障。 * **[修复]** 修复权限页点击打开与输入跳转仍提示“未解锁”的问题。 * 页码菜单点击、聊天输入页码、直接打开指定页数，现在都会按玩家实时权限重新判定可访问页数。 * **[修复]** 修复权限页高页数数据持久化不完整的问题。 * 权限页中的页面行数与物品数据现在会正常保存并在重载后恢复，避免高页数物品丢失或页面状态回退。 * **[兼容]** 保持原有购买解锁逻辑兼容。 * 已购买页数仍然按数据库中的 `unlock` 保存；权限页则作为额外可访问页数动态生效。 [/MD]

• 优化灵魂仓库交互，新增 Shift+左键 直接把一组物品放入玩家背包
• 保留原有左键取出到鼠标、右键取出 1 个的操作方式，兼容旧习惯
• 背包空间不足时，只扣除实际成功放入的数量，避免吞物或超取
• 同步更新界面提示、README 与 Wiki，方便玩家理解新交互

• 新增自动数据备份，支持启动备份、定时备份、停服前备份，并自动清理旧备份。
• yaml 模式直接备份 data/，sqlite/mysql 额外导出 storage-dump.sql。
• 修复普通仓库重新打开时物品被错误清空的问题。
• 修复旧配置缺少 SETTING.residence.enabled 时误触发区域限制的问题。
• 增强旧版 YAML 数据回退读取，尽量兜住 modes.normal 为空但旧根节点仍有数据的情况。

[MD] ### v1.4.1 (2026-03-27) * **[修复]** 修复 Residence 限制无法显式关闭的问题。 * 新增 `SETTING.residence.enabled` 配置项，默认 `true` 以保持旧版本兼容。 * 即使服务器安装了 Residence，也可以明确关闭领地限制，不再误拦截仓库开启。 * **[优化]** 优化 Residence 名单读取逻辑。 * 统一使用已加载的配置缓存，减少重载配置后的行为歧义。 * **[优化]** 补齐缺失的权限声明。 * 新增 `warzstorage.command.admin`、`warzstorage.bypass.worldguard`、`warzstorage.bypass.worldlimit`、`warzstorage.bypass.combat` 等权限声明，方便权限插件直接管理。 [/MD]

● 【新增】双仓库模式：普通仓库+灵魂仓库，支持独立切换、独立配置；
● 【新增】灵魂仓库虚拟堆叠功能，优化高频材料存储体验；
● 【新增】灵魂仓库全套独立配置，支持自定义页数、解锁成本；
● 【兼容】百分百兼容旧版数据，老玩家仓库数据自动归入普通仓库，无数据丢失风险。

修复主页导航问题，支持无限页数。

[MD] ### v1.2.8 (2026-03-23) * **[新增]** 新增仓库页数选择菜单，默认打开仓库时可先选择目标页（可在配置中关闭）。 * **[新增]** 新增输入页码跳转流程，支持玩家通过聊天输入页码快速打开已解锁页。 * **[优化]** 补齐页数菜单点击跳转与输入跳转前的限制校验，保持与命令入口一致（权限、战斗冷却、世界限制、WorldGuard/领地限制）。 * **[兼容]** 原有上一页/下一页按钮、解锁与扩容逻辑保持可用。 [/MD]

WarZStorage v1.2.7 更新内容摘要
- [新增] GUI 返回按钮功能 ：
- 允许在仓库界面添加一个自定义的返回按钮。
- 高度自定义 ：可在 config.yml 中配置按钮的启用状态、显示位置（0-8）、执行指令（支持 {player} 变量）以及按钮的物品材质、名称和 Lore。
- 典型用途 ：方便玩家从仓库界面快速返回服务器的主菜单或个人中心。

### 更新内容总结 (v1.2.5)
本次更新主要集中在 数据安全性 和 同步机制 的优化，解决了核心的“数据回档”隐患：

- 实时保存机制 (Real-time Save) :

- 在玩家进行 点击 ( InventoryClick ) 或 拖拽 ( InventoryDrag ) 操作后，插件会延迟 1 tick 自动触发数据保存。
- 优势 : 即使 Mod 或其他插件强制切换 GUI（导致服务器处理关闭事件滞后），最新的物品状态也已安全写入数据库，杜绝了因时序差导致的数据覆盖。
- 事件优先级调整 (Priority Adjustment) :

- 将 InventoryCloseEvent （背包关闭事件）的监听优先级从 MONITOR （最低）提升至 HIGH （高）。
- 优势 : 确保在发生 GUI 冲突或关闭流程中，本插件的保存逻辑优先于其他清理逻辑执行，进一步保障数据落地。