Ultimine Unchained

Ultimine Unchained patches FTB Ultimine so vein mining breaks every tool-compatible block regardless of hardness, with a configurable durability cost per operation. For Minecraft 1.21.1 through 1.21.11, Fabric and NeoForge.

What It Does

Ultimine Unchained is a Mixin patch for FTB Ultimine, not a standalone vein-mining mod. It adds no shapes, activation keys, or targeting of its own; every vein-mining behavior still comes from FTB Ultimine. It changes three things about how an ultimine operation behaves:

• Respects your shape. FTB Ultimine normally compares every block in the shape against the first block you targeted and skips any block that is harder, even if your tool can mine it fine. With allow_harder_blocks enabled (the default), that check is suppressed, so every block in the shape that your tool is actually capable of mining and getting drops from is broken instead of skipped. Indestructible blocks (bedrock, barriers, anything with a negative destroy speed) are always skipped regardless of this setting.
• Controls durability cost. FTB Ultimine normally costs one point of tool durability per block mined, which can destroy a tool in a single large operation. This mod replaces that with a configurable cost for the whole operation: a flat number of block-break equivalents (durability_flat_blocks, default 1), or a percentage of the blocks actually broken (durability_percentage, default 0/disabled, takes priority over the flat cost once set above 0). Unbreaking is respected in both modes: each point of calculated damage is rolled against the enchantment's chance to ignore durability loss, the same as vanilla tool damage.
• Caps durability loss per operation. Regardless of the flat or percentage setting, the durability actually consumed by a single ultimine operation is capped at durability_cap_percent of the tool's maximum durability (default 25%). A 2000-durability tool can lose at most 500 durability from one operation no matter how many blocks the percentage or flat setting would otherwise charge.

Requirements

Installation

Install Fabric, NeoForge or Forge for your Minecraft version, then the dependencies listed above (Architectury API and FTB Ultimine; on Fabric also Fabric API and Cloth Config), then this mod:

• Modrinth: install with the Modrinth App, or download the version for your loader and Minecraft version and put the jar in your mods folder.
• Manual: put the jar for your loader and Minecraft version in your mods folder next to its dependencies.

Launch the game. Ultimine operations use the new durability rules immediately; no further setup is needed.

Configuration

On Fabric, edit config/ultimineunchained.json. On NeoForge, edit <world>/serverconfig/ultimineunchained-server.toml, which is per world and synced to clients automatically. There is no in-game config screen on either loader.

Fabric enters the percentage as a whole number (50 means 50%); NeoForge enters it as a decimal (0.5 means 50%). Setting durability_flat_blocks to 0 with durability_percentage left at 0 and durability_cap_percent at 0 removes durability cost entirely.

Compatibility

This mod requires FTB Ultimine and does nothing without it. It works with every tool type and every shape FTB Ultimine supports. It does not touch FTB Ultimine's right-click actions (tilling, stripping, harvesting) and does not change how drops are computed; it only decides which blocks in the shape break and what the operation costs. Blocks your tool cannot get drops from are skipped rather than broken. An operation never destroys the tool: the durability cost is capped one point short of breaking it. Players in Creative mode pay no durability. If a future FTB Ultimine build changes the method this mod patches, the game refuses to load rather than running with a silent no-op.

Support

• Modrinth: report bugs and ask questions on the mod's Nexus Mods page, where every report is tracked.

License

License terms are in the Alkeari License Agreement.