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!


