二次开发 工具 【1.13-1.21|Folia】WarZCustomShop —— 无上手难度|自带Web编辑器|全可视化自定义商店｜多货币体系｜NBT 完整保留｜ 1.7.18

• 新增 sell~amount~<数量>，支持右键一次出售一组物品。
• 默认仍然一次出售 1 个，完全兼容旧配置。
• 商店 GUI 会显示“出售需要”数量。
• Web 编辑器新增“扣除物品数量”字段。
• 文档补充示例：sell~eco~100 + sell~amount~64。

• 修复旧 config.yml 缺少 Lang.* 键时，/cshop open 打开商店会触发空指针的问题。
• 启动时自动补全缺失默认配置，旧服升级后不需要再手动补这些键。
• GUI 文案读取增加兜底和物品显示名回退，缺少个别配置时商店也能正常打开。

• 修复 1.16.5 因 Java 17 字节码导致无法加载的问题，编译目标降到 Java 8。
• 修复 Web 编辑器里 InputStream.readAllBytes() 的低版本兼容问题。
• 统一插件版本号、jar 名称和文档说明。

[MD]### Bug修复<br><br>- **修复数据库模式下 `/cshop reload` 和 `/cshop create` 报 CommandException 崩溃的问题**<br> - 根因：插件内部获取自身实例时使用了错误的插件名，导致异步任务调度失败<br> - 本地存储模式不受影响，此问题仅在开启 MySQL 时触发<br><br>### 改进<br><br>- `/cshop create` 行数参数增加数字格式校验，输入非法字符时不再崩溃，而是提示"行数必须是数字"<br>- 数据库连接断开后再次使用时自动尝试重连，避免操作静默失败<br>- 配置重载（`/cshop reload`）发生异常时，向玩家输出具体错误信息而非静默崩溃<br>- 创建商店时发生数据库异常，向玩家输出错误提示 [/MD]

• 修复部分商店因历史脏数据或异常编辑数据中存在非法槽位，导致 /cshop open 或 /cshop edit 直接报错、无法打开的问题。
• 修复商店加载、保存与展示流程缺少槽位边界校验的问题，异常槽位现在会被自动跳过，不再触发 ArrayIndexOutOfBoundsException。
• 优化 Web 编辑器的槽位范围判断，现在会按商店真实行数显示和编辑，避免 1-5 行商店被按 6 行布局写入越界槽位。
• 优化兼容性：已有坏数据的商店现在可以先正常打开，后续重新保存后会自然清理非法槽位。

[MD] ### v1.7.13-Universal - **修复**：修复 MySQL 模式下自定义货币 `costs` 表的字段读写错误。`/cshop cost list`、`create`、`rename`、`delete`、`clear` 等货币管理链路现在会按 `costid / costname` 正确读写，不再因为旧字段名写错导致列表为空或数据库报错。 - **修复**：修复 MySQL 模式下玩家货币导入时写错 `playerdata` 字段的问题。现在从文件数据上传玩家余额到数据库时，会正确写入 `costbal`，恢复旧版文件数据迁移与导入链路。 - **优化**：MySQL 模式下启动时会将数据库中的自定义货币定义并入运行时缓存，货币管理命令执行后也会同步更新内存状态，减少数据库、命令反馈与实际运行状态不一致的问题。 [/MD]

[MD] ### v1.7.12-Universal - **修复**：补全 `MySQL=true` 模式下的购买执行链路。现在无论是 GUI 点击购买还是直接购买 `/cshop buy`，都会走与文件模式一致的购买规则，不再出现 MySQL 分支点击后限购不生效、物品不扣除却能反复购买的问题。 - **修复**：统一 `s~daylimitself`、`s~playerlimit`、`s~cmd` 等逻辑的执行顺序。超出限购时将直接拦截，不再继续扣费、发货或执行奖励命令。 - **修复**：统一多种公式的判定与扣除行为： - `b~lore` 现在按物品堆叠只统计一次，避免同一组物品因多条 Lore 被重复累计。 - `c~papi` 改为独立判定，不再受前序条件结果污染。 - `c~inv` 现在只统计主背包空位，不再把副手和护甲槽算作可用空间。 - `b~id` / `material:dur` 在扣除时会同步校验耐久值，避免错误扣除相同材质但不同耐久的物品。 - `b~cost` 购买成功时会真实扣除自定义货币，不再只校验余额却不扣款。 - **优化**：MySQL 模式下的商店读取、刷新记录、编辑保存、删除与缓存同步流程一并整理，减少数据库模式与文件模式长期分叉带来的行为不一致。 [/MD]

[MD] ### v1.7.11-Universal - **修复**：修复网页编辑器与游戏内 `/cshop edit` 同时编辑同一商店时，旧的游戏内编辑界面可能在关闭或手动 `/cshop reload` 后把新内容覆盖回旧内容，导致网页修改“回退”的问题。 - **优化**： - 为商店编辑增加版本检测。若商店已被网页端或其他编辑来源更新，旧的游戏内编辑界面关闭时将不再覆盖最新数据。 - 网页编辑保存后，会主动让同商店的旧游戏内编辑界面失效，减少并发编辑造成的数据冲突。 - 手动 `/cshop reload` 完成提示改为中文：`[CustomShop] 配置重载完成！` [/MD]

[MD] - **新增**：新增 `s~hiderule` 公式。带有该公式的物品会隐藏商店界面中自动追加的购买消耗、购买条件、出售收益与限购等提示，但实际购买/条件/功能逻辑保持正常。 - 如果物品只有 `s~hiderule` 而没有其他可交互公式，点击效果与 `b~show` 一致，不会变成可免费领取物品。 - **网页编辑器**： - 快速设置页新增“隐藏购买/交互条件展示”勾选项。 - 编辑器现在会正确识别并回填该公式，保存时写回 `s~hiderule`。 - **优化**：Web 编辑器顶部版本号改为读取插件实际版本，避免页面内显示与插件版本不一致。 [/MD]

[MD] ### v1.7.9-Universal * **Web 编辑器重构与增强**： * **全面可视化**：新增折叠式属性面板，分类管理「购买消耗」、「购买条件」、「功能设置」、「出售回收」。 * **完整语法支持**： * **消耗 (b~)**：新增支持 `item` (特定物品), `fuzzyitem` (模糊匹配), `id` (材质ID), `lore` (描述匹配), `perm` (权限购买), `show` (仅展示)。 * **条件 (c~)**：新增支持 `c~nperm` (禁止权限), `c~inv` (背包空间), `c~papi` (变量判断), `c~str` (字符串比较)。 * **功能 (s~)**：新增支持 `s~open` (跳转商店), `s~take` (仅执行指令), 多种限购模式 (全服/个人/每日)。 * **出售 (sell~)**：支持自定义货币 (`cost`) 回收。 * **交互优化**：更新帮助文档链接为语雀官方文档；修复了部分输入框的显示逻辑。 [/MD]