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

• 兼容和迁移更稳了
  旧仓库数据继续可读；降低 maxUnlock 不会删旧页；default_mode 对老玩家可选择强制跟随；名称和图标字段也能平滑迁移。
• 普通仓库规则修正了
  maxUnlock 现在是真正生效的上限，不再是摆设；页码选择菜单的翻页和跳页问题也修了。
• 虚拟堆叠体验调整了
  普通仓库默认关闭虚拟堆叠，保持原版习惯；虚拟堆叠 GUI 里的显示数量改成可配置，默认仍沿用旧版“按最大堆叠数显示”的观感。
• 仓库自定义功能补上了
  玩家可以给自己的仓库重命名、换图标，支持命令，也支持页码菜单里的 Shift 操作。
• 运维更方便了
  /warzstorage save 和 /warzstorage reload 现在控制台也能执行，重载后会刷新配置缓存。
• 经济模式语义更清楚了
  BOTH 不是“二选一优先扣一个”，而是同时扣金币和点券；失败时会做回滚处理。
• 1.6.6 新增了存入黑名单
  store_filter 可以按物品类型或 Lore 关键词禁止入仓，覆盖普通仓库手动/Shift/拖拽，以及灵魂仓库手动存入和自动拾取；只拦后续存入，不会删旧数据。

• 补充并真正启用 maxUnlock，默认最大 10 页。
• 新页面默认 2 行，行数升级配置可以正常使用。
• 普通仓库默认支持虚拟大堆叠，兼容 YAML、SQLite、MySQL 和旧数据。
• BOTH 模式改为同时扣除金币和点券，第二笔扣款失败会退还第一笔。
• 修正解锁按钮和帮助文本，移除左右键二选一误导。
• 普通仓库虚拟堆叠默认改为关闭，旧配置缺少该项时也按关闭处理。
• 保留旧 YAML、SQLite、MySQL 数据兼容，避免升级时改变玩家仓库数据。
• 修复旧配置中战斗冷却、WorldGuard 嵌套路径读取问题。
• Wiki 已重写为面向服主的详细教程，覆盖安装、命令、权限、经济模式、页数、行数、虚拟堆叠、灵魂仓库、迁移、排错及全部配置项。
  
  
• Shift + 左键 点击已解锁页：进入改名，聊天栏输入新名字
• 改名输入 reset 或 重置：恢复默认名称
• 改名输入 cancel 或 取消：取消本次改名
• Shift + 右键 点击已解锁页：把主手物品设为该页图标
• Shift + 右键 且主手为空：恢复默认图标

[MD] ### v1.6.1 (当前版本) - 兼容 Paper / Folia 26.x 服务端启动 - 升级内置 XSeries 到 `13.7.1`，修复 26.x 版本号解析失败导致 `XMaterial` 初始化异常的问题 - 插件版本更新为 `1.6.1` [/MD]

[MD] ### v1.6.0 (2026-07-21) * **[新增]** 页码选择菜单按钮支持自定义材质、名称、Lore 与 CustomModelData。 * `SETTING.page_select.button_unlocked/button_locked/button_input/button_prev/button_next` 可分别配置已解锁页、未解锁页、输入跳转、上一组、下一组按钮。 * `custom-model-data` 同时兼容 `custom_model_data`、`model-data`、`model_data` 写法，便于资源包模型配置。 * 页码点击现在按菜单槽位识别，不再要求在 Lore 中显示 `page:1` 这类内部标记。 * **[兼容]** 旧版配置可直接升级。 * 旧配置缺少新 `page_select.button_*` 节点时会自动使用原有默认图标，不影响现有服务器启动与使用。 * 玩家仓库数据结构未变更，无需执行数据迁移。 [/MD]

• 修复管理员查看玩家仓库时高页数只能看第一页/误判打不开
• 修复 TACZ 枪械、NBT 物品反序列化异常，避免乱码、标签丢失、内容回退
• 修复 YAML 存储下自动备份偶发 NoSuchFileException

• 修复管理员查看离线玩家仓库时，只能打开第一页、权限页被误判为“未解锁”的问题。
• /warzstorage open <玩家> [页数] [模式] 现在会优先按仓库主人的实际权限页数判断，不再错误回退到查看者状态或仅数据库已购页数。
• 当目标玩家离线时，插件会优先通过 Vault 权限服务查询离线权限；如果权限插件不支持离线查询，则回退到最近一次缓存的权限页状态，尽量避免高页数被错误拦截。
• 优化权限页访问判定稳定性，玩家进服和仓库数据加载完成后会刷新权限页缓存，降低管理员查看、页码菜单、页码跳转时的误判概率。

• 修复仓库首次异步预加载期间，玩家或管理员立即打开仓库时界面不弹出的问题。
• 现在加载中的仓库会缓存打开请求，等数据读取完成后自动继续打开流程。
• 解决了只提示“正在加载仓库数据，请稍候...”，但仓库窗口一直没有打开的竞态问题。
• 保持坏数据自愈逻辑兼容；如果玩家仓库里有损坏物品数据，仍会先自动备份原始数据，再清理异常槽位并继续加载。

• 修复仓库内有失效物品时，玩家打开仓库直接报错的问题
• 新增“先备份、后清理”的坏数据自愈流程
• 支持 yaml / sqlite / mysql 三种存储后端
• 新增 GUI 打开阶段的二次兜底，尽量避免漏网坏物品再次炸仓库
• 版本已更新到 1.5.6，README/WIKI 也已同步

v1.5.5 更新内容
1. 修复 YAML 玩家数据文件损坏时，后台持续报 InvalidConfigurationException 的问题。
2. 新增损坏 YAML 自动清洗与恢复机制，检测到 0x00 等非法字符时会优先移除并重写文件。
3. 当玩家数据文件已无法恢复时，会自动备份为 .corrupt-时间戳.bak 后继续运行，避免反复报错。
4. 优化 YAML 落盘流程，改为同玩家文件串行写入 + 原子替换，降低异步保存导致文件损坏的风险。

[MD] ### v1.5.4 (2026-05-03) * **[修复]** 修复管理员查看其他玩家仓库时，权限解锁页被误判为“未解锁”的问题。 * ` /warzstorage open <玩家> [页数] [模式] ` 现在会优先按仓库主人的实际可访问页数判断，而不再错误使用查看者自己的解锁状态。 * 当目标玩家通过 `unlock_levels.permission` 获得额外页数时，管理员查看对应页数将不再被错误拦截。 [/MD]