原创 闭源 🚀 WarZMiner - 基于《塔科夫》机制的显卡挖矿系统 | 双模式GUI | 动态比特币经济 | 支持1.12.2-1.21+ | Folia兼容 3.2.1

[MD] ## WarZMiner v3.2.0 → v3.2.1 更新内容 ### 🐛 Bug 修复 修复 CraftEngine 26.7+ 兼容性问题 [/MD]

[MD] # WarZMiner v3.2.0 更新总结 ## 新增功能 - 支持按显卡稀有度自定义实际物品名称：`gpu.rarity.<RARITY>.name`。 - 支持按显卡稀有度自定义实际物品 lore：`gpu.rarity.<RARITY>.lore`。 - lore 支持 `&` 颜色代码和以下变量： - `${gpu_label}`、`${farm_label}`、`${rarity}` - `${gpu_id}`、`${hash_rate}`、`${power_consumption}` - `${durability}`、`${max_durability}`、`${durability_percent}`、`${durability_color}` ## 兼容处理 - 旧版 `config.yml` 缺少显卡 `lore` 配置时，自动使用默认 lore。 - 不修改显卡 NBT 数据结构，不影响已有显卡的识别、安装、卸载和耐久刷新。 - 使用 CraftEngine 显卡外观时，仍会在其物品基础上应用 WarZMiner 配置的名称和 lore。 ## 版本变更 - `plugin.yml`：`3.2.0` - `pom.xml`：`3.2.0` - 启动横幅、默认配置、Wiki 与构建信息：已同步到 `v3.2.0` ## 升级说明 - 更新前请备份 `plugins/WarZMiner/` 数据目录。 - 旧配置不会自动合并新字段；如需自定义显卡 lore，请将 `lore` 手动添加到对应稀有度节点。 - 重启服务器或执行 `/miner reload` 后，新生成及刷新出来的显卡会使用新配置。 [/MD]

	比特币产出翻倍 —— 物品模式不再同时入农场库存 + 直接掉背包,一次生产只产 1 个	全平台
	背包比特币不可堆叠 —— 产出统一入农场,GUI 收取时以可堆叠形式发放(随上一条消失)	全平台
	取消 Folia 任务反射报错 —— cancel() 补 setAccessible(true)	仅 Folia

[MD] ## 核心修复 - 修复 Folia 重复任务初始延迟为 `0` 时触发的 `Initial delay ticks may not be <= 0` 报错。 - 统一规范 Folia 兼容层的延迟与周期参数，避免后续调度继续踩到非法 tick 值。 - 将排行榜刷新任务改为合法初始延迟启动，提升区域线程环境稳定性。 [/MD]

[MD] ## 核心修复 - 修复 Folia / Lophine 1.21.8 下 GUI 点击操作仍调用 Bukkit 调度器的问题，解决点击农场开关、加燃料、收取比特币时可能出现的 `InventoryClickEvent` 异常。 - 修复 `FoliaSchedulerImpl` 反射签名不匹配的问题，改为按真实 Folia API 调用全局、区域、实体与异步调度，确保挖矿任务和 GUI 延迟刷新任务能够正常运行。 - 为动态农场 GUI 补上自动刷新机制，并在每次重建界面时重新计算变量，解决“挖矿进度条不动、燃料与状态显示停留旧值”的问题。 [/MD]

[MD] ## 核心修复 - 修复虚拟 GUI 创建农场时使用玩家精确坐标导致的位置索引不一致问题，避免重启后或交互后出现“农场像被重置/失效”的现象。 - 统一农场位置的存储、查询与删除逻辑为方块坐标，并补上 GUI 创建场景下的重复位置检查。 - 修复读档恢复显卡时覆盖 `installTime` 的问题，避免重启后显卡安装时间被重置。 [/MD]

[MD] ## 核心修复 - 修复 Paper 1.21.8 下 `paper-plugin.yml` 的 `api-version: 1.13` 导致插件在预加载阶段被拒绝的问题。 - 移除 `paper-plugin.yml`，改回 Bukkit 插件加载方式，避免继续触发 Paper 插件最低 API 版本限制。 - 保留 `plugin.yml` 中的 YAML 命令声明，解决仅提高 `api-version` 后 `getCommand("miner")` 在 Paper 插件启动阶段报错的问题。 - 更新 CraftEngine 兼容提示，避免继续引导用户检查已移除的 `join-classpath` 配置。 [/MD]

[MD] - 修复用户反馈的“每次重启服务器都会清空农场”问题。 - 当 `farms.yml` 中存在农场，但启动时世界暂未加载或个别农场数据解析失败时，插件现在会保留这些原始农场条目，不再被自动保存覆盖成空数据。 - 对世界未就绪导致暂未加载的农场加入延迟重试，世界恢复后会自动重新注册农场。 - 保存 `max-slots` 字段，避免升级后的农场重启后槽位数回退到默认配置。 [/MD]

[MD] - 同步提升插件版本号到 `3.1.14` - 补充 `plugin.yml` 中的 `folia-supported: true` 声明 - 保持 `paper-plugin.yml` 中 `CraftEngine` 的 `join-classpath: true` 依赖配置 - 同步更新启动横幅、配置文件头注释、Wiki 与构建信息中的版本标记 [/MD]

[MD] ## 核心更新 - 新增 `CraftEngine` 显卡贴图兼容： - 支持通过 `gpu.craft-engine.default-item` 统一指定显卡 CE 外观 - 支持通过 `gpu.craft-engine.items.<RARITY>` 按稀有度分别指定 CE 物品 - 未配置或 CE 物品不存在时自动回退为原版材质，不影响原服使用 - 新增独立比特币货币模式： - `bitcoin.currency-mode: SELL_TO_VAULT` 保持原有“卖币换金币”玩法 - `bitcoin.currency-mode: INDEPENDENT` 将比特币作为独立钱包货币使用 - 新增 `bitcoin.currency-symbol` 配置项，自定义 BTC 货币显示符号 - 新增 BTC 钱包管理命令： - `/miner bitcoin balance [玩家]` - `/miner bitcoin add <玩家> <数量>` - `/miner bitcoin remove <玩家> <数量>` - `/miner bitcoin set <玩家> <数量>` - 修复比特币存储逻辑： - 拆分“累计产出”和“待领取比特币” - 避免在线产出、离线收取、GUI 收取之间出现重复结算 - 更新 GUI 与文档： - GUI 新增背包比特币、待领取比特币、钱包 BTC 显示 - Wiki 补充 CraftEngine 集成、独立 BTC 配置、权限与命令说明 [/MD]