Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
MultiMine changes one vanilla Minecraft rule: letting go of the mine button no longer erases your block-breaking progress.
What the mod does
In vanilla Minecraft, breaking a block is all-or-nothing. The moment you release the mine button, look away, switch to another block, or get knocked back, all accumulated mining progress on that block is instantly lost. MultiMine stores mining progress per block on the server, which changes mining in three concrete ways:
1. Pause and resume mining. Releasing the mine button, fighting a mob, eating, or walking away only pauses progress. The block keeps a visible crack, and mining it again later continues exactly where you left off. You can start breaking an obsidian pillar, go deal with a creeper, and return to finish the job instead of starting over.
2. Switch blocks freely. Every partially mined block remembers its own progress independently. Soften up an ancient debris block, clear the deepslate around it, then come back — both blocks kept their progress.
3. Mine together, break faster. When several players mine the same block at the same time, their mining speeds are combined. Each player contributes their real per-tick mining speed (including tool, Efficiency, Haste, and other modifiers), and the total is capped by a configurable multiplier so group mining is strong without becoming an instant-break exploit. Solo players are unaffected by the cap.
Everything runs on the logical server (dedicated server or single-player integrated server). Progress cracks are broadcast with vanilla block-crack packets and blocks break through the normal server-side breaking path, so joining players need no mods, no resource packs, and no settings — a stock launcher works. Drops, Silk Touch, Fortune, tool durability, statistics, experience, and advancements all behave exactly like vanilla.
Features
- Persistent per-block mining progress that survives releasing the button, retargeting, movement, and knockback.
- Cooperative mining speed: all miners on the same block stack their speeds, limited by a configurable multiplier.
- Vanilla crack overlay (stages 0-9) visible to all nearby players, so group progress is always readable.
- Configurable decay: idle progress expires after a timeout, instantly or with a gradual drain.
- Memory and abuse safeguards: capped number of tracked blocks and a maximum contributor distance.
- Respects game rules: creative and spectator players keep instant vanilla breaking; unbreakable blocks (bedrock, barriers, command blocks) and protected blocks (spawn protection, adventure-mode restrictions) can never gain progress.
- Live admin commands to inspect, reload, and clear progress.
Configuration
The file config/multimine.json is created automatically on first launch. Edit it with any text editor, then apply it with /multimine reload or by restarting. Default values:
| Option | Default | Description |
|---|---|---|
decayTimeoutSeconds |
60.0 |
Seconds an untouched block keeps its progress. 0 means progress is kept indefinitely, until the block changes or the server restarts. |
progressiveDecay |
true |
When true, progress drains gradually after the timeout. When false, the whole stored progress is forgotten at once when the timeout expires. |
decayAmountPerSecond |
0.05 |
Fraction of a full break lost per second after the timeout, used only when progressiveDecay is true. 0.05 means 5 percent per second, so a half-mined block fully fades in about 10 seconds. |
maxCoopMultiplier |
8.0 |
Cap on group mining speed. The combined speed can never exceed the fastest miner's speed multiplied by this value. 1.0 effectively disables speed stacking. |
coopEnabled |
true |
Master switch for cooperative mining. Set to false so only the fastest miner on a block contributes, while progress persistence keeps working. |
broadcastProgress |
true |
Send the vanilla crack overlay to clients. Disable for hidden progress or marginally fewer packets. |
maxTrackedBlocks |
1024 |
Maximum number of partially mined blocks remembered at once. The stalest entries are discarded first. |
maxMiningDistance |
6.0 |
Players farther than this distance in blocks, measured from the block center, do not contribute mining speed. |
debugLogging |
false |
Verbose console logging of mining start, break, and decay events. Useful while tuning the configuration. |
Example configuration file:
{
"decayTimeoutSeconds": 60.0,
"progressiveDecay": true,
"decayAmountPerSecond": 0.05,
"maxCoopMultiplier": 8.0,
"coopEnabled": true,
"broadcastProgress": true,
"maxTrackedBlocks": 1024,
"maxMiningDistance": 6.0,
"debugLogging": false
}
Commands
| Command | Required permission | Description |
|---|---|---|
/multimine reload |
Operator, gamemaster level and up (classic permission level 2) | Reloads config/multimine.json from disk without restarting. |
/multimine status |
Everyone | Shows how many blocks currently hold progress and how many players are actively mining. Operators additionally see a per-block breakdown with percentages. |
/multimine clear |
Operator, gamemaster level and up (classic permission level 2) | Forgets all stored progress everywhere and clears every crack overlay. |
Installation
- Install Fabric Loader for your Minecraft version. Use Java 21 for the 1.21.x file, or Java 25 for the 26.1.x, 26.2, and 26.3 files.
- Download Fabric API for the same Minecraft version, and the MultiMine file that matches your Minecraft version (see the version list below).
- Place both jars into the
modsfolder: the servermodsfolder for dedicated servers, or your instancemodsfolder for single-player and LAN worlds. Joining players install nothing. - Start the game or server once so
config/multimine.jsonis generated, adjust the values to taste, then run/multimine reload.
Which file to download:
| Minecraft version | File to download |
|---|---|
| 1.21 through 1.21.11 | multimine-1.0.0+1.21.jar |
| 26.1 through 26.1.2 | multimine-1.0.0+26.1.jar |
| 26.2 | multimine-1.0.0+26.2.jar |
| 26.3 | multimine-1.0.0+26.3.jar |
Frequently asked questions
Do other players need the mod installed? No. All logic is server-side and everything visible uses vanilla packets.
Does it work in single-player? Yes. It runs on the integrated server with the same code path as dedicated servers.
Will it lag the server? Only partially mined blocks are tracked, capped at maxTrackedBlocks (default 1024), and each costs one map entry plus one crack packet when its displayed stage changes.
Can it grief spawn or break bedrock? No. Spawn protection and adventure-mode restrictions are honored, and blocks with no mining speed gain zero progress.
Do Fortune, Silk Touch, and Mending still work? Yes. The final break goes through the normal server-side breaking path with the miner credited.
Why did stored progress disappear? The decay timeout expired (raise decayTimeoutSeconds or set it to 0), the block itself changed (water, piston, explosion, or someone broke it), or the server restarted (progress is kept in memory only, by design).
Can I keep persistence but disable group speed? Yes. Set coopEnabled to false or maxCoopMultiplier to 1.0.


