Ultimine Unchained

A companion mod for FTB Ultimine that fixes two long-standing frustrations with vein mining: blocks being skipped because they're slightly harder than your initial target, and your tool taking a full durability hit for every single block in the shape.

Available for Forge and Fabric — Minecraft 1.20.1.

The Problem

FTB Ultimine is a fantastic vein mining mod, but its default behaviour has two pain points:

1. Shape-breaking block skips When you mine with a shape like Mining Tunnel or Small Square, FTB Ultimine compares the hardness of every block in the shape against the first block you targeted. If any block is even slightly harder, it gets skipped — even if your tool can mine it perfectly fine. The result is holes and gaps in your shape that break the whole point of using it.

Example: You target stone with a stone pickaxe. Copper ore in the same shape gets skipped, even though your pickaxe can mine it just as well.

2. Runaway durability drain By default, your tool takes one durability hit per block mined. Mine 64 blocks in a single ultimine operation and your tool takes 64 durability damage. Enchanted tools with Unbreaking? That gets bypassed too. A full Mining Tunnel operation can destroy a freshly-repaired tool in seconds.

What This Mod Does

Ultimine Unchained patches FTB Ultimine via Mixin to fix both issues.

Feature 1 — Respect Your Shape

When enabled, the harder-block check is suppressed. Your ultimine operation now breaks every block in the shape that your tool is actually capable of mining — no arbitrary skips based on relative hardness.

Indestructible blocks (bedrock, barriers, etc.) are always skipped regardless of this setting.

Feature 2 — Durability Control

Your tool's durability cost for an entire ultimine operation is now configurable. Two modes are available:

Flat mode (default) The whole operation costs a fixed number of block-break equivalents, regardless of how many blocks were actually mined. The default is 1 — meaning a 64-block ultimine costs the same as breaking a single block by hand.

Percentage mode The cost scales proportionally with how many blocks were broken. Set it to 0.5 and a 64-block operation costs 32 durability. Set it to 1.0 to restore vanilla behaviour.

Unbreaking enchantments are fully respected in both modes — each point of calculated damage goes through the same chance-based reduction that vanilla Minecraft uses.

Configuration

Configuration is available via the in-game config screen on both loaders. On Forge, you can also edit ultimineunchained-server.toml in your world's serverconfig/ folder.

Option	Forge type	Fabric type	Default	Description
`allow_harder_blocks`	`true` / `false`	`true` / `false`	`true`	Break all tool-compatible blocks in the shape, ignoring relative hardness.
`durability_percentage`	`0.0` – `1.0` (decimal)	`0` – `100` (whole %)	`0`	Fraction of blocks broken that counts toward durability cost. Overrides flat mode when greater than 0.
`durability_flat_blocks`	`0` – `32768`	`0` – `32768`	`1`	Flat durability cost per operation in block-break equivalents. Used when `durability_percentage` is `0`.

Note: On Fabric, durability_percentage is entered as a whole number (e.g. 50 means 50%). On Forge it is a decimal (0.5 means 50%).

Examples:

durability_percentage = 0, durability_flat_blocks = 1 → entire operation costs 1 durability (default)
durability_percentage = 50 (Fabric) / 0.5 (Forge) → mine 40 blocks, lose 20 durability
durability_percentage = 100 (Fabric) / 1.0 (Forge) → full vanilla durability (1 per block)
durability_flat_blocks = 0 → no durability cost at all

Requirements

Forge

Dependency	Version
Minecraft	1.20.1
Forge	47.4.0 or later
FTB Ultimine (Forge)	2001.x or later
Architectury API	9.2.14 or later

Fabric

Dependency	Version
Minecraft	1.20.1
Fabric Loader	0.14.23 or later
Fabric API	Any
Architectury API	9.2.14 or later
Cloth Config	11.1.136 or later

Note: FTB Ultimine is required on Fabric as well. The Fabric build of this mod is listed as a dependency on CurseForge — install both.

Installation

Install FTB Ultimine and Architectury API for your loader.
Download the correct jar for your loader (-FORGE.jar or -FABRIC.jar) from the Releases page.
Drop it into your mods/ folder alongside FTB Ultimine.
Launch the game. On Forge, open the mod config to adjust settings to your liking.

Compatibility

Works with all tool types — pickaxes, axes, shovels, swords, shears, and any modded tools that FTB Ultimine supports.
Compatible with all FTB Ultimine shapes (Shapeless, Small Tunnel, Small Square, Large Tunnel, Mining Tunnel, Escape Tunnel).
Does not affect right-click actions (hoe tilling, axe stripping, shovel flattening, crop harvesting) — those are handled entirely by FTB Ultimine.
Fortune and Silk Touch apply normally — this mod does not touch loot or drop behaviour.

License

Alkeari License Agreement (ALA v2.2)

Issues & Feedback

Found a bug or have a suggestion? Open an issue on the GitHub Issues page.