SoulMine

SoulMine
FTB Ultimine-style vein mining for Paper. No client mods, Java + Bedrock.

REQUIRES PAPER 26.2+ (or a Paper fork like Purpur). Does not run on plain Spigot.


What is SoulMine?
If you've played modpacks, you know FTB Ultimine: hold a key, break one block, and the whole vein comes with it. SoulMine brings that to a normal Paper server, with nothing for players to install. Sneak and break to mine the vein, and sneak and scroll to change shape. Before you swing, an outline shows exactly which blocks will break.

It also works for Bedrock players on Geyser, including console players with a controller.


Controls

• Java: hold Shift and break a block to mine the vein. Shift + scroll wheel changes the shape. Shift + right-click uses the bulk farming tools.
• Bedrock controller (Xbox / PlayStation / Switch): crouch and break. Crouch + LB/RB changes the shape. Crouch + LT uses the bulk farming tools.
• Mobile / anyone: /soulmine shape <name> picks a shape without scrolling.

Shape scrolling only takes over while you're crouching, holding a mining tool, and looking at a block. Crouch-bridging, placing blocks while crouched, and number keys all work normally.


Shapes
All six FTB Ultimine shapes, built to match FTB's own code, plus one extra:

• Shapeless: every connected block of the same type, diagonals included. Stone types and ore variants (iron + deepslate iron, etc.) count as one block. On leaves it reaches through the tree's logs, so every branch gets cleared. On crops it skips small gaps in the field.
• Small Tunnel: a 1x1 line straight into the wall.
• Small Square: a single 3x3 face.
• Large Tunnel: a 3x3 tunnel straight in.
• Mining Tunnel: a diagonal going down, away from you.
• Escape Tunnel: a diagonal going up, away from you.
• None: SoulMine off. Crouching with a tool behaves like vanilla. It sits right next to Shapeless, so one scroll switches SoulMine off or back on.

Features

• Live outline preview of every block that will break, plus a "Shape · N blocks" counter above the hotbar.
• Java players see a glowing outline, visible only to them.
• Bedrock players get a particle outline automatically (Bedrock can't render glowing outlines). Players can switch with /soulmine outline.
• Hunger works like FTB Ultimine: each extra block costs a little hunger. You can't start on an empty hunger bar, and it stops when you run out.
• Tool damage applies per block, and SoulMine stops before your tool breaks.
• Drops and XP gather at the block you broke instead of scattering along the vein.
• Bulk farming (sneak + right-click):
• Harvest and auto-replant a whole crop field (wheat, carrots, potatoes, beetroot, nether wart, cocoa). Works in every shape, even None.
• Hoe: till a whole field. Shovel: make paths. Axe: strip a whole tree.
• Plays nice with your other plugins. Every block is broken as the player, so WorldGuard regions, claim plugins, CoreProtect logging, and Fortune / Silk Touch / Unbreaking all work normally.
• Lightweight. Previews are cached and only recomputed when something changes. Unloaded chunks are never loaded.
• Per-rank block limits through permissions, e.g. VIPs get 128 blocks.Every message is configurable with MiniMessage (gradients, hex colors).
• Player choices (on/off, shape, outline style) are saved across restarts.

Configuration Highlights

• Max blocks (default 64, same as FTB) and max range
• Hunger cost, cooldown, and tool-break protection
• Which items activate it (pickaxes, axes, shovels, hoes and shears by default)
• Which shapes are available, and in what scroll order
• Block merge groups and a blacklist (spawners, bedrock, etc. are blocked by default)
• Outline color, style, update speed and particle limits
• Disabled worlds
• Every message

Requirements

• Paper 26.2+ or a Paper fork such as Purpur (not plain Spigot, not Folia)
• Java 25+
• Optional: Geyser + Floodgate on the same server, for Bedrock players
• Goes on your Paper server, not on a BungeeCord or Velocity proxy

SoulMine is inspired by FTB Ultimine. It isn't affiliated with FTB / Feed The Beast.