原创 付费 娱乐 🎮 WarZPianoBlock - 把 "别踩白块" 搬进 Minecraft！紧张刺激的钢琴块小游戏插件来了！ 1.3.2

• v1.3.2 修复了 Paper 1.12.2 + Java 8 环境下插件无法加载的问题。
• 构建目标已调整为 Java 8，解决 UnsupportedClassVersionError 报错。
• 清理了源码中的高版本 Java 写法，提升旧版本运行兼容性。
• 优化了 1.12.x 环境下的 GUI 材质和玩家头颅兼容处理。

WarZPianoBlock-1.3.1更新
修复内容：

1. Mod 物品兼容修复 :
- 定位到报错原因为 XMaterial.matchXMaterial 在处理未知的 Mod 物品（如 TACZ_TARGET ）时抛出 IllegalArgumentException 。
- 在 ButtonListener.java 中添加了 try-catch 异常捕获逻辑，当玩家点击不支持的材质时自动忽略，不再抛出后台报错。

1. 核心架构升级
- 跨版本支持 (1.7 - 1.21+) ：
- 引入了 XSeries 库（包含 XMaterial , XSound , XBlock ），彻底解决了不同 Minecraft 版本间的物品材质（Material）和声音（Sound）名称不一致的问题。
- 现在插件可以在低版本（如 1.8）和高版本（如 1.21）服务器上无缝运行，无需修改代码。
- Folia 服务器支持 ：
- 在 plugin.yml 中添加了 folia-supported: true 声明。
- 实现了智能调度器 SchedulerUtil.java ，通过反射自动检测服务器环境。
- 在 Folia 环境下自动切换使用 GlobalRegionScheduler 和 RegionScheduler ，在 Bukkit/Spigot 环境下回退使用标准 BukkitScheduler 。 2. 代码重构与修复
- 材质处理标准化 ：
- 将所有硬编码的 Material （如 Material.WOOL , Material.STAINED_GLASS ）替换为动态解析的 XMaterial 。
- 修复了 GameManager 和 ControlButtonManager 中 Block 与 ItemStack 的类型转换错误，改用 XBlock.setType() 进行安全的方块操作。
- GUI 交互修复 ：
- 修复了 GameGUI 中缺失 handleClick 方法的问题，并将监听器逻辑从 GUI 类中分离，遵循单一职责原则。
- 监听器优化 ：
- 优化了 GameListener.java 和 ButtonListener.java ，确保交互事件能正确识别跨版本的方块类型。 3. 构建系统更新
- Maven 依赖管理 ：
- 更新 pom.xml ，添加了 XSeries 和 Folia-API 依赖。
- 配置了 maven-shade-plugin ，将必要的依赖库（XSeries）打包进最终的 JAR 文件中，确保用户即插即用。
- 编译修复 ：
- 解决了所有 Java 编译报错，确保项目可以通过 mvn clean package 顺利构建。 4. 文档与资源
- 新增 WIKI ：
- 创建了详细的 WIKI.md 文档，包含安装指南、指令列表、权限节点说明以及游戏模式介绍。
- 配置更新 ：
- config.yml 的默认配置现在完全兼容 XSeries 的材质命名规范。

1. 修复交互逻辑冲突

- 问题描述 ：用户反馈在设置游戏后，右键点击开始游戏的方块（默认钻石块）时，打开的不是主菜单，而是错误地进入了游戏区域管理界面。这导致普通玩家无法正常开始游戏。
- 修复方案 ：
- 分离交互逻辑 ：修改了 ControlButtonListener ，现在只有 管理员 （拥有 warzpianoblock.admin 权限）且 处于潜行状态 (按住 Shift) 时，右键点击方块才会打开管理界面。
- 优化事件监听 ：更新了 ButtonListener ，添加了 ignoreCancelled = true 属性，确保普通右键点击能正确触发游戏主菜单，不再被管理界面的逻辑覆盖。
- 当前行为 ：
- 右键点击 ：打开游戏主菜单（所有玩家）。
- Shift + 右键点击 ：打开区域管理界面（仅限管理员）

修复多处语言键缺失错误