问题背景#

在 Paper 26.2（对应 Minecraft 1.20.6）中，当玩家获得挖掘疲劳 III 时，挖掘速度乘数被错误计算。该问题已被 Mojang 官方记录为 MC-279819，并在原版 1.20.6（即 26.3）中修复，但 Paper 服务端目前仍停留在 26.2，因此该问题在 Paper 服务器上依然存在。

功能特点#

• 自动修复挖掘疲劳 III 的挖掘速度
• 支持开关指令，可随时启用或停用
• 开关状态持久化保存，重启服务器不丢失
• 轻量设计，几乎无性能损耗
• 仅作用于挖掘疲劳 III，不影响其他等级

环境要求#

• Minecraft 版本：1.20.5 ~ 26.2
• 服务端核心：Paper / Spigot / Purpur 等（支持 Bukkit API 即可）
• Java：21 或更高（26.x 需要 Java 25）

安装方法#

1. 从 GitHub Releases 下载最新版本的 MiningFatigue3Fix-x.x.x.jar
2. 将文件放入服务器 plugins 目录
3. 重启服务器

指令列表#

默认拥有权限：op

权限节点#

工作原理#

当玩家获得挖掘疲劳 III（amplifier = 2）时，插件会向玩家的 PLAYER_BLOCK_BREAK_SPEED 属性添加一个 MULTIPLY_SCALAR_1 修饰符，将挖掘速度乘数乘以 10，从而将错误值 0.0027 修正为正确的 0.027。当挖掘疲劳 III 消失或插件被禁用时，该修饰符会自动移除。

开关状态保存在 config.yml 中，重启服务器后仍然有效。

注意事项#

• 本插件仅支持 Minecraft 1.20.5 ~ 26.2（需要 BLOCK_BREAK_SPEED 属性）
• 1.20.4 及更早版本因缺少相关属性，无法使用本插件
• 当服务端更新到 26.3 或更高版本后，原版已修复此问题，可以安全卸载本插件
• 插件默认状态为 开启，服务器重启后自动恢复为开启状态

开源许可#

本项目采用 MIT License 开源，欢迎贡献代码或提交 Issue。

相关链接#

• GitHub 仓库：https://github.com/Fengchunye/MiningFatigue3Fix
• Bug 报告：MC-279819
• PaperMC 官方：https://papermc.io