
VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun!
Screenshots



About this Mod
⛏️ Veinminer
Mine a single block to mine the whole vein!
Highly configurable and works everywhere, even on your vanilla server.
Make the tedious mining experience to something satisfying and fun!
Veinminer works server side, so all clients are supported. Even cross loaders & versions for addons!
Client Hotkey & Highlighting
Add the Hotkey Addon to only veinmine when pressing a hotkey & get a mining preview
Use as Enchantment?
Add the Veinminer Enchantment Addon to limit veinmining to only enchanted tools!
⚙️ Customization & Settings

Veinminer comes in two different versions
• Version 2.x -> Full customizable mod & plugin
• Version 1.x -> Light DataPack with vanilla & snapshot support
Both comes with preconfigured for ores and pickaxes. Read below how to extend it.
Mod/Plugin Version (2.x)
The advanced (V2) version is a more powerful version that is only usable with Fabric/Quilt, Paper/PurPur/Folia & NeoForge servers.
| Command | Permission | Short Description |
|---|---|---|
| /veinminer blocks | veinminer.blocks |
Edit blocks that are veinmineable with every tool |
| /veinminer groups | veinminer.groups |
Edit blocks & tools with precise rules |
| /veinminer toggle | veinminer.toggle |
Toggle Veinminer (server wide) |
| /veinminer settings | veinminer.settings |
Change settings like cooldown, max chain and more |
| /veinminer presets | veinminer.groups |
Quick setup some useful groups & settings |
General Settings
To change a setting, enter /veinminer settings ... [<new-value>].
To check the current state, leave out the new value argument.
| Setting | Description | Default |
|---|---|---|
mustSneak |
Players must sneak to veinmine | false |
cooldown |
Time between players are able to veinmine (in ticks) | 20 |
delay |
Time between each automated block breaking (in ticks) | 1 |
maxChain |
Max amount of blocks that can break from one source block | 100 |
needCorrectTool |
If blocks have a required tool, this must be used | true |
searchRadius |
Amount of blocks around connected blocks to search (max 5) | 1 |
permissionRestricted |
Only players with veinminer.use permission can veinmine |
false |
mergeItemDrops |
All item drops are merged to the source block | false |
autoUpdate |
Check for updates and download new version if available | true |
durabilityDecrease |
If each mined block should reduce durability | true |
miningSpeedModifier |
Increase block mining duration based on vein size | 0.0 |
Block Groups - Advanced Settings
Block groups can hold multiple blocks together that will be treated like the same block./veinminer groups create <name> [<block1>] [<block2>]
All blocks inside one group will be mined together.
A block can be in multiple groups. New blocks can be added or removed from groups with the following commands:/veinminer groups edit <name> add-block <block>/veinminer groups edit <name> remove-block <block>
Groups can be limited to certain tools, for example group wood can only be mined by axes.
If no tool is added to a group, all tools are allowed. If a block is in multiple groups, all tools from those groups are allowed.
(If a block is in one unlimited tool group and one limited to axes, only axes work for this block)/veinminer groups edit <name> add-tool <item>/veinminer groups edit <name> remove-tool <item>
Example (Logs)
1. /veinminer groups create Logs
2. /veinminer groups edit Logs add-block #minecraft:logs
3. /veinminer groups edit Logs add-tool #minecraft:axes
Block and item inputs allow block and item tags for easier editing.
For example, to add all logs enter #minecraft:logs into any block input.
Visit the wiki for a full list or look at a block with F3 under "looking at".
You can also modify the group file directly inside .../veinminer/default_groups.json (config/... for mods, plugins/... for plugins)
Setting Overrides - Too Advanced Settings
Overrides are optional settings, that will override the normal setting if the player is effected by it.
See examples underneath for a better understanding, I don't blame you if you think "why...".
Client Overrides
Those settings will be applied to all users that use the client addon (hotkey).
E.g. you want to have mustSneak enabled in general, but disabled for hotkey users:
/veinminer settings mustSneak true- True for all/veinminer settings client override mustSneak false- False override for hotkey users
Group Overrides
Those settings will be applied to all users that mine a block from this specific group.
Each group can have a different override, if a block is in multiple groups, only the override from the oldest group count (this behavior may see improvement later).
E.g. you dont want that your sand & dirt group consumes durability:
/veinminer settings decreaseDurability true- True for all blocks/veinminer groups shovel edit override decreaseDurability false- False override for this group
If both, client and group overrides, collide the group override takes priority (normal < client < group).
You can remove overrides with /veinminer ... override unset <setting>.
OP players will have all permissions. To manually grant permissions see Luckperms (NeoForge not supported yet).
DataPack Version (1.x)
The DataPack (V1) version is a simple version that is usable on every server and world.
Enter the config command to open an interactive chat menu to edit all settings.
| Command | Permission | Description |
|---|---|---|
| /function veinminer:_config | OP/Cheats |
Access the full settings menu in chat |
If you get prompted something like {category:"pickaxe", namespace:"", id:""}, you need to fill in the item/block namespace & ID (press F3+H to see them), e.g. {category:"pickaxe", namespace:"minecraft", id:"sand"} for minecraft:sand
Some Advice
- To veinmine, your tool must be able to mine the block in normal conditions (unless disabled in V2)
- While Veinminer is running very lightweight, mining unnatural big veins can lag the client and the server through the amount of items
If you need any help or want to share some ideas to add, just hop on our Discord (dc.mutils.net)
Available Versions
How to Install VeinMiner on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set bukkit Loader
In the panel under "Egg", select the bukkit loader and matching Minecraft version (26.2).
Install Mod
Open the mod browser in the dashboard and search for "VeinMiner". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.1.2, 26.1.1 (+30 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
VeinMiner server crashes on startup – what to do?
Most common cause: wrong bukkit version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.
Is VeinMiner compatible with bukkit and datapack and fabric and folia and forge and neoforge and paper and purpur and quilt and spigot?
VeinMiner officially supports bukkit, datapack, fabric, folia, forge, neoforge, paper, purpur, quilt, spigot for Minecraft 26.2, 26.1.2, 26.1.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with VeinMiner – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if VeinMiner consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install VeinMiner with just one click on your server.

