Search

VeinMiner

modrinthmodLicense: AGPL-3.0-only

Miraculixx

103,532,809 downloads · 7,042 followers

Minecraft: Minecraft 1.17 – 26.3

Loaders:datapackfabricforgeneoforgequilt

Runs on: Client & server

Category: bukkit, cursed, equipment, folia, game-mechanics, paper, purpur, spigot, technology, utility

Compatibility by loader

  • neoforge1.21.1 – 1.21.11, 26.1 – 26.3· Latest 2.14.0 (Nov 14, 2026)
  • fabric1.17 – 1.21, 26.1 – 26.3· Latest 2.14.0 (Nov 14, 2026)
  • quilt1.17 – 1.21, 26.1 – 26.3· Latest 2.14.0 (Nov 14, 2026)
  • datapack1.17 – 1.21, 26.1 – 26.3· Latest 1.3.6 (Sep 18, 2026)
  • forge1.17 – 1.20· Latest 1.2.1+mod (Nov 19, 2023)

Overview

banner

Modrinth Ko-fi Curseforge

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.


Affordable Servers? In this time?! Clicking below supports me and saves you 10% + 2 Days free ♥️

#AD - Your support helps to keep this project alive :)


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.

CommandPermissionShort Description
/veinminer blocksveinminer.blocksEdit blocks that are veinmineable with every tool
/veinminer groupsveinminer.groupsEdit blocks & tools with precise rules
/veinminer toggleveinminer.toggleToggle Veinminer (server wide)
/veinminer settingsveinminer.settingsChange settings like cooldown, max chain and more
/veinminer presetsveinminer.groupsQuick setup some useful groups & settings

General Settings

To change a setting, enter /veinminer settings ... []. To check the current state, leave out the new value argument.

SettingDescriptionDefault
mustSneakPlayers must sneak to veinminefalse
cooldownTime between players are able to veinmine (in ticks)20
delayTime between each automated block breaking (in ticks)1
maxChainMax amount of blocks that can break from one source block100
needCorrectToolIf blocks have a required tool, this must be usedtrue
searchRadiusAmount of blocks around connected blocks to search (max 5)1
permissionRestrictedOnly players with veinminer.use permission can veinminefalse
mergeItemDropsAll item drops are merged to the source blockfalse
autoUpdateCheck for updates and download new version if availabletrue
durabilityDecreaseIf each mined block should reduce durabilitytrue
miningSpeedModifierIncrease block mining duration based on vein size0.0
hungerPerBlockDrain saturation per veinmined block (vanilla 0.005)0.0

Block Groups - Advanced Settings

Block groups can hold multiple blocks together that will be treated like the same block.

/veinminer groups create [] []

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 add-block

/veinminer groups edit remove-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 add-tool

/veinminer groups edit remove-tool

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 .

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.

CommandPermissionDescription
/function veinminer:_configOP/CheatsAccess 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)

Platform Notice: No reuploads or forks are allowed on Modrinth & CurseForge

AI-summarized from the mod's own pages · reviewed by our team

Reviewed for 2.13.0

Source: Modrinth project page

Guide

Summary

VeinMiner lets you break a connected vein by mining one block. Both editions start with ore and pickaxe rules, while server settings can change how the mechanic works.

Getting started

  • Try an ore vein — Mine an ore block with a pickaxe that can normally break it. The connected vein should also be mined, subject to the server's settings and block rules.
  • Check the edition — The 1.x edition is a lightweight data pack, while 2.x is the more configurable mod and plugin edition. Their settings are managed differently.
  • Ask about server rules — VeinMiner runs on the server, so players do not need the main mod on their clients. An administrator can change its behavior or disable it across the server.

Key features

  • Connected mining

    Breaking one eligible block can mine its connected blocks. In 2.x, the default chain limit is 100 blocks, with a one-tick delay between automated breaks.

  • Block groups

    In 2.x, administrators can group different blocks so they mine together and restrict groups to particular tools. Groups can also have their own setting overrides.

  • Optional addons

    The Hotkey Addon adds a mining preview and hotkey activation. The separate Enchantment Addon can restrict veinmining to enchanted tools.

Compatibility

datapack, fabric, quilt, neoforge

Tips

  • Use the appropriate tool for the block. The correct-tool requirement can be disabled in the 2.x edition, but it is enabled by default.
  • Watch your tool's durability: in 2.x, each automatically mined block reduces durability by default.
  • Very large veins can cause client or server lag because of the number of dropped items.
  • If veinmining does not trigger, check the server's rules. The 2.x edition can require sneaking or permission, although neither is required by default.

FAQ

How do I change settings?
In 2.x, administrators can use /veinminer settings and check a setting by leaving out its new value. In 1.x, use /function veinminer:_config to open the chat settings menu; this requires operator access or cheats.
Can I add other blocks?
Yes. The 2.x edition has commands for editing blocks and groups, including tool restrictions. The 1.x settings menu also lets you edit its configuration.
Which override wins?
In 2.x, a group override takes priority over a client override, which takes priority over the normal setting. If a block belongs to multiple groups, the oldest group's override applies.

Modrinth modrinth

indexable
Advertisement