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

• 修复修改 unlock_levels 后 /warzstorage reload 显示解锁条件不变的问题。
  
  • 根因是默认配置里普通仓库 unlock_levels 缩进位置曾经错到 row_upgrade_settings 下面。
  • 已修正默认配置模板。
  • 也兼容读取旧错误路径 SETTING.row_upgrade_settings.unlock_levels，避免旧用户配置直接失效。
• reload 后会刷新已加载仓库菜单、页码菜单、解锁确认菜单，避免 GUI 继续显示旧价格。
• 二次确认已改成二级菜单：
  
  • 点击解锁按钮后进入确认菜单。
  • 可点“确认解锁”或“取消返回”。
  • 进入确认菜单本身不会扣款，只有点确认才扣费。
• 额外补了一个保护：仓库数据还没加载完时执行解锁，会等加载完成后再弹确认菜单，避免用默认页数误算。

• 修复 Lophine 1.21.11 核心下，物品使用 id/count 格式保存时被误判为损坏的问题。
• 保留旧核心常见的 type/amount 物品格式兼容，不影响 Spigot、Paper 等其他核心用户。
• 优化损坏物品数据处理逻辑，遇到真正异常数据时会先备份原始玩家数据，再清理异常槽位，降低数据丢失风险。
• Residence 领地限制默认改为关闭，避免用户未配置 Residence 时无法打开仓库。
• Residence 配置移动到 WorldGuard、世界限制同一区域，方便用户找到。
• 继续兼容旧版 Residence 配置路径。
• 管理员命令支持直接使用玩家 UUID：
  • /warzstorage open <UUID>
  • /warzstorage unlock <UUID>
  • /warzstorage del <UUID>
• 在玩家名缓存缺失时，也可以通过 data/<UUID>.yml 找回并打开旧仓库数据。
  
  
• 管理员命令优先支持直接输入玩家名，使用体验接近在线玩家：
  • /warzstorage open <玩家名>
  • /warzstorage unlock <玩家名>
  • /warzstorage del <玩家名>
• UUID 仍保留为兜底输入。
• 正版服本地缓存缺失时，会尝试通过 Mojang 正版名解析 UUID。
• 离线服会按离线 UUID 规则解析玩家名。
• YAML 和 SQL 存储都支持检查目标 UUID 是否已有仓库数据。
• GUI 标题增加玩家名兜底，减少离线查看时显示 Unknown 的情况。

• 修复 Lophine 1.21.11 的物品数据兼容问题，支持 id/count 新格式，同时保留旧核心的 type/amount 格式。
• 防止有效物品被误判为损坏并清除。
• 整理 Residence 配置：
  • 默认关闭 Residence 领地限制。
  • 与 WorldGuard、世界限制放在同一配置区域。
  • 兼容旧版顶层 Residence 配置。
• 根据历史备份生成数据恢复包，恢复了部分被误清空的玩家仓库。
• 更新配置说明和 WIKI。
• 已完成构建与 YAML 配置校验。

功能说明：

• 解锁按钮默认需要在 10 秒内连续点击两次，第一次不会扣款。
• require_previous_page_max_rows: true 时，必须先把上一页升级到 6 行，才能解锁下一页。
• 管理员免费代解锁不受该限制。
• 旧玩家数据不受影响，旧配置缺少该节点时默认不强制满行。

• 兼容和迁移更稳了
  旧仓库数据继续可读；降低 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 权限服务查询离线权限；如果权限插件不支持离线查询，则回退到最近一次缓存的权限页状态，尽量避免高页数被错误拦截。
• 优化权限页访问判定稳定性，玩家进服和仓库数据加载完成后会刷新权限页缓存，降低管理员查看、页码菜单、页码跳转时的误判概率。