Raffman’s Excavator

Mine one block, get the whole shape: ore veins, 3x3 tunnels, staircases and flat areas with a live preview. Drops go straight into your inventory.
01-tunnel-preview.png

01-tunnel-preview.png

02-tunnel-mined.png

02-tunnel-mined.png

05-menu-shapes.png

05-menu-shapes.png

Description

Raffman's Excavator

Mine one block – get the whole shape. Raffman's Excavator digs entire ore veins, 3×3 tunnels, walkable staircases and flat areas in a single swing. You design the shapes, you see exactly what will be mined before you break the first block, and every drop lands straight in your inventory.

Formerly known as Raffman's VacuumCleaner. Same mod, new name – and now also on Minecraft 26.3 (NeoForge 26.3.0.103+, Java 25). Updating to 26.3? Your shapes, block list and options are taken over automatically.

Install on the server and on every client. Mining happens on the server; preview and controls live on the client.


⛏️ How it works

  • Hold the excavate key (default: the key left of 1) – or switch it to toggle mode in the settings.
  • While the mode is active, a live outline shows exactly which blocks will go, with a block counter right under your crosshair.
  • Mine one block normally – the rest of the shape follows instantly.
  • Mouse wheel makes the shape longer or shorter on the fly. Ctrl + mouse wheel flips through your shapes.

🧱 Shapes you design yourself

Create as many shapes as you like in the menu (default key O, also available from the mod list) – each with its own name and size:

  • Vein – connected blocks of the same kind. Ore variants count together (iron ore + deepslate iron ore), and so do logs and wood of one tree species. Diagonal connections optional.
  • Box / Tunnel – width, height and depth freely adjustable. Aligned to your feet so tunnels are always walkable, or centered / bottom-aligned.
  • Staircase – walkable stairs up or down from your feet, with adjustable width, headroom and number of steps.
  • Everything connected – all connected blocks of any kind within reach (perfect together with the block list).

Boxes and stairs never stop early: every position is checked on its own. Air pockets or a different block in between are simply skipped – the shape keeps going behind them.

📋 Your personal block list

  • Three modes: Off (mine everything breakable), Only these blocks or All except these.
  • Add block ids (stone, minecraft:dirt) or whole tags (#c:ores) with auto-completion – or add the block you are looking at with one click or a hotkey.
  • The list lives on your client; the server applies it when you mine.
  • Unbreakable blocks such as bedrock are never touched.

🍗 Fair costs & built-in safety

  • Every extra block costs a little hunger – mining by hand costs three times as much as with a tool (configurable).
  • Optional cost preview: approximate hunger and durability before you commit.
  • Protect tool (on by default): stops before your favourite pickaxe breaks.
  • Skip blocks without drops (on by default): blocks your tool can't harvest (e.g. diamond ore with a wooden pickaxe) stay put – nothing is ever lost, the rest of the shape is still mined.
  • Skip chests & co. (on by default): blocks with an inventory are never mined by accident.
  • Stops when your hunger bar is empty (server option).

🧲 Straight into your inventory

Drops and experience from the whole shape go directly into your inventory – even items that fall off mined blocks, like torches. Whatever doesn't fit lands at your feet. Fortune, Silk Touch and Mending work exactly as usual.

🛡️ Server-friendly by design

  • The server recalculates every shape itself and enforces its own limits (max. blocks per excavation, max. shape size).
  • Every block goes through the regular player break path, so claim and spawn protection mods apply to every extra block.
  • Server config (26.3): config/raffmansexcavator-server.toml (per world: <world>/syncedconfig/raffmansexcavator-server.toml), synced to every client so the preview always shows the server's limits; on 1.20.1/1.21.1: serverconfig/raffmansvacuum-server.toml. Options: maxBlocks (default 256), maxShapeSize (default 32), hunger per block with tool / by hand, stopWhenStarving, deniedBlocks.
  • Datapack tag #raffmansexcavator:never_excavate (1.20.1/1.21.1: #raffmansvacuum:never_excavate, still honoured on 26.3) for blocks that are never mined (spawners, budding amethyst, suspicious sand/gravel and more by default).

⚙️ Client settings

Activation (hold/toggle), preview through blocks, tinted faces, preview color, crosshair display, cost display and the safety options – all in the in-game menu. Stored in config/raffmansexcavator-client.json (1.20.1/1.21.1: config/raffmansvacuum-client.json).

🌍 Languages

English and German.


Requirements

Versions NeoForge 26.3 (NeoForge 26.3.0.103+, Java 25) · NeoForge 1.21.1 · Forge 1.20.1
Side Server and client
Dependencies none

Bug reports and ideas are very welcome in the comments!

Raffman’s Excavator Team

profile avatar
  • 9
    Projects
  • 3.3K
    Downloads

My wish was always to make my ideas come reality, I always had many ideas for mods but no know how, so I started "vibecoding" and I know people care about it a lot if its Ai made or not, thats why this is my Bio│I'm an honest guy!

More from Raffman180View all

  • Pretty Announcer project image

    Pretty Announcer

    Pretty announcements at the top of the screen: automatic server restart countdowns, repeating announcements, pictures, an in-game design menu and /announce. Players without the mod still see a boss bar.

    • 81
    • November 16, 2026
  • Raffman's Detailed Map project image

    Raffman's Detailed Map

    A detailed diorama-style map and minimap with team-shared fog of war, waypoints, teams, diplomacy and chunk claims.

    • 2.1K
    • November 15, 2026
  • Jurgens Shader project image

    Jurgens Shader

    Colourful, realistic Iris shader: physical sky, volumetric clouds with soft light, a clean night sky, calm water, soft shadows and coloured light - fast on HIGH at 1440p.

    • 75
    • November 15, 2026
  • Monkeytalk project image

    Monkeytalk

    The official modpack for the Monkeytalk Minecraft server: NeoForge 1.21.1 with creatures, bosses, food, building and quality-of-life mods.

    • 53
    • November 8, 2026
  • Pretty Announcer project image

    Pretty Announcer

    Pretty announcements at the top of the screen: automatic server restart countdowns, repeating announcements, pictures, an in-game design menu and /announce. Players without the mod still see a boss bar.

    • 81
    • November 16, 2026
  • Raffman's Detailed Map project image

    Raffman's Detailed Map

    A detailed diorama-style map and minimap with team-shared fog of war, waypoints, teams, diplomacy and chunk claims.

    • 2.1K
    • November 15, 2026
  • Jurgens Shader project image

    Jurgens Shader

    Colourful, realistic Iris shader: physical sky, volumetric clouds with soft light, a clean night sky, calm water, soft shadows and coloured light - fast on HIGH at 1440p.

    • 75
    • November 15, 2026
  • Monkeytalk project image

    Monkeytalk

    The official modpack for the Monkeytalk Minecraft server: NeoForge 1.21.1 with creatures, bosses, food, building and quality-of-life mods.

    • 53
    • November 8, 2026