MiningFatigue3Fix

Fixed the issue of abnormal mining speed in Mining Fatigue III (MC-279819).

The original version only officially fixed this issue in 26.3, and this plugin provides a temporary fix for versions prior to 26.3.

Problem description

When the excavation fatigue level was upgraded from Level II to Level III, the speed multiplier erroneously used 0.03 instead of 0.3, resulting in:

Status	Speed Multiplier	Actual Effect
Error (current)	0.0027	Approximately 370 times slower
Correct (expected)	0.027	Approximately 37 times slower

This plugin corrects the incorrect speed to the correct value by temporarily adding the BLOCK_BREAK_SPEED attribute modifier.

Functional Features

• Automatically adjust the mining speed of players with Mining Fatigue III
• Supports on/off commands, allowing for instant activation/deactivation
• The switch status is saved persistently, ensuring it is not lost upon restart
• Lightweight design, with almost no performance impact
• Only affects Excavation Fatigue III, and does not affect other levels

Environmental requirements

• Minecraft 1.20.5 ~ 26.2
• Core Paper / Spigot / Purpur, etc. (as long as they support Bukkit API)
• Java 21 or higher (26.x requires Java 25)

Installation method

1. Download the latest version of MiningFatigue3Fix-x.x.x.jar
2. Place it in the plugins folder of the server
3. Restart the server

Instructions

Command	Description	Permissions
/mf3fix	View current status	miningfatigue3fix.toggle
/mf3fix on	Enable repair	Ditto
/mf3fix off	Turn off repair	Ditto
/mf3	ditto (alias)	ditto
/miningfatigue3fix	ditto (alias)	ditto

The default permission is op.

Permissions

Permission node	Description	Default
miningfatigue3fix.toggle	Allow the use of toggle commands	op

Working principle

When the player has Excavation Fatigue III (amplifier = 2), the plugin will add a MULTIPLY_SCALAR_1 attribute modifier to multiply the excavation speed by 10, thereby correcting the error from 0.0027 to the correct 0.027.

When the effect disappears or the plugin is closed, the modifier will be automatically removed.

The switch state is saved in config.yml and remains valid after restarting the server.

Precautions

• Only supports Minecraft 1.20.5 ~ 26.2 (requires the BLOCK_BREAK_SPEED attribute)
• After updating the server to version 26.3 or later, the original version has already fixed this issue, so you can directly uninstall this plugin
• Versions 1.20.4 and earlier cannot use this plugin due to the lack of relevant attributes

License

This project is open-sourced under the MIT License.

Acknowledgements

• Original bug report: MC-279819
• PaperMC team