Breakable Blocks

Breakableblocks

Breakableblocks is a server-side Fabric mod that makes normally unbreakable or restricted blocks mineable with exact timings, tool requirements, custom drops, and explosion protection. It is configured through a single JSON5 file on the server. Vanilla clients can join without installing anything.

Server owners use it to open up progression on bedrock, barriers, command blocks, portal blocks, spawners, trial spawners, vaults, end gateways, reinforced deepslate, and any other registered block ID, while keeping full control over how long each block takes and what it drops.

What the mod does

• Makes configured blocks breakable with server-authoritative mining sessions.
• Tracks mining progress every server tick and shows the normal block-cracking animation.
• Shows an action-bar progress bar with percent, a text bar, and seconds remaining.
• Requires specific tools, material tiers, and Silk Touch before mining can start.
• Replaces vanilla drops with a configured item and count after the timer completes.
• Optionally preserves supported block entity data on the dropped item.
• Protects configured blocks from explosions by filtering them before destruction.
• Optionally restricts sensitive blocks to server operators.
• Cancels safely when the player stops mining, disconnects, changes dimension, moves too far away, or the block changes.
• Reloads configuration without restarting the server.

Custom mining only applies to blocks listed in the config. All other blocks use normal vanilla behavior.

Installation

1. Install Fabric Loader 0.19.3 or newer for Minecraft 1.21.11, or 0.19.3+ for 26.1 and 26.2, or 0.19.5+ for 26.3.
2. Install the matching Fabric API version.
3. Download the Breakableblocks file that matches your Minecraft version:
   • 1.21.11: Java 21 required
   • 26.1, 26.1.1, 26.1.2: Java 25 required
   • 26.2: Java 25 required
   • 26.3: Java 25 required
4. Place the JAR in the server mods folder. The mod is only required on the server.
5. Start the server once to generate config/block-configuration.json5.
6. Edit the file, then run /blockconfiguration reload in game or restart the server.

No client mod, resource pack, or extra setup is needed for players.

Configuration

The config file is created at:

config/block-configuration.json5

Each top-level key is a namespaced block ID. The file supports comments and trailing commas.

Simple example:

{
  "minecraft:bedrock": {
    "breakSeconds": 30,
    "tool": "netherite_pickaxe",
    "drop": "minecraft:bedrock x1",
    "blastResistant": true
  },
  "minecraft:spawner": {
    "breakSeconds": 15,
    "tool": "netherite_pickaxe",
    "drop": "minecraft:spawner x1",
    "preserveBlockEntity": true,
    "blastResistant": true
  },
  "minecraft:command_block": {
    "breakSeconds": 5,
    "tool": "netherite_pickaxe",
    "drop": "minecraft:command_block x1",
    "blastResistant": true,
    "operatorOnly": true
  }
}

Simple fields

Advanced fields

Advanced fields are still supported for backwards compatibility and fine control.

Notes:

• dropItem, dropCount, and block entity preservation apply to custom mining sessions. Blocks left on VANILLA keep normal loot behavior.
• Invalid entries are skipped and logged. If the file cannot be parsed, the previous valid configuration stays active.
• Block and item IDs must use the full namespace:path format.
• Timers use server ticks. Heavy lag can make real-world completion time longer.

Commands

All commands use the base /blockconfiguration.

Block IDs in commands must include the namespace, for example minecraft:bedrock.

Server behavior

• The target block must still match the block that started the session.
• The player must stay alive, connected, in the same dimension, and within 8 blocks.
• Releasing or aborting the mining action cancels the session.
• Switching targets clears the previous cracking animation.
• Drops spawn on the server only after the full duration completes.
• Explosion-protected positions are removed before the explosion destroys blocks.
• Operator-only blocks are checked before tool checks begin.

Version support

Fabric API is required on the server. Clients do not need the mod.

License

All Rights Reserved.