What are you searching for?

Veinminer

Veinminer

Veinminer is a configurable mining mod that lets you break entire veins with a single block break. It keeps the grind down while giving server owners clear controls, limits, and permissions.

download 283.3K Downloads · favorite 94 Followers · Updated 1 week ago
Equipment Fabric Game-mechanics Neoforge Utility 1.20 1.20.1 1.20.2 1.20.3 1.20.4 +13 more

Versions

inventory_2
Veinminer 1.21.10 (fabric)

3.1.0+1.21.10 · 1 week ago · 1.03 MB

Beta download
Fabric 1.21.10
inventory_2
Veinminer 1.21.9 (fabric)

3.1.0+1.21.9 · 1 week ago · 1.03 MB

Beta download
Fabric 1.21.9
inventory_2
Veinminer 1.21.8 (fabric)

3.1.0+1.21.8 · 1 week ago · 1.03 MB

Beta download
Fabric 1.21.8
inventory_2
Veinminer 1.21.7 (fabric)

3.1.0+1.21.7 · 1 week ago · 1.03 MB

Beta download
Fabric 1.21.7
inventory_2
Veinminer 1.21.6 (fabric)

3.1.0+1.21.6 · 1 week ago · 1.03 MB

Beta download
Fabric 1.21.6

About

⛏ Veinminer

Veinminer is a configurable mining mod that lets you break entire veins with a single block break. It keeps the grind down while giving server owners clear controls, limits, and permissions.

⚙️ Key Features

  • 🧱 Vein Mining — mines adjacent matching blocks with TPS-aware block caps.
  • 🛠️ Activation Choices — crouch or hotkey; hold or toggle modes per player.
  • 🙌 Empty-Hand Support — trigger without holding a tool (optional).
  • 🧰 Flexible Block Lists — global and per-tool lists can be whitelist or blacklist.
  • 🪓 Per-Tool Rules — different block sets per tool; seeded defaults.
  • ⚡ Fortune/Silk & Durability Safety — honors enchants; optional durability guard.
  • 🔁 Cooldown & Limits — optional cooldown; static or dynamic max blocks.
  • ✴️ Particles/Outline — server-driven outline with color + duration controls.
  • 🔐 LuckPerms Toggle — optional integration for permissions.
  • 🧪 /veinminer test — quick command to verify behavior and responses.
  • 🔄 Live Reloads — /veinminer reload with file/line reporting on errors.

Works server-side out of the box. Optional client mod adds the hotkey (default V).

🔧 Configuration & Commands

Command quick reference

Command Description
/veinminer help List commands.
/veinminer reload Reload config without restart (errors show file/line).
/veinminer test Run a quick behavior check.
/veinminer toggle Toggle Veinminer for yourself.
/veinminer blocks add/remove/list <block> Manage global block list (whitelist/blacklist).
/veinminer tools add/remove/list <item> Manage allowed tools.
/veinminer settings blockpertool Toggle per-tool block logic.
`/veinminer settings cooldown enable disable`
/veinminer settings cooldown set <seconds> Set cooldown time.
/veinminer settings maxblocks <number> Set hard cap per activation.
`/veinminer settings luckperms enable disable`
/veinminer blockpertool blocks <tool> add/remove/list <block> Per-tool block lists.
/veinminer blockpertool tool add/remove/list <tool> Manage tools in per-tool mode.
`/veinminer particles enable disable`
/veinminer particles setcolor <r> <g> <b> RGB color for outline.
/veinminer particles setduration <ticks> Outline lifetime.
`/veinminer togglemessages permission disabled

Config files

Written to config/Veinminer/ (TOML) on first run.

Spoiler

  • GeneralConfig.toml

    • veinminerEnabled true
    • requireCrouch true
    • checkToolDurability true, durabilityCap 1, durabilityThreshold ABSOLUTE
    • cooldownEnabled false, cooldownSeconds 5
    • dynamicMaxBlocks false, maxBlocks 64, minBlocks 16, maxDynamicBlocks 64 (TPS-aware)
    • enableParticleOutline true, particleDurationTicks 60, particleRed 255, particleGreen 0, particleBlue 0
    • autoLuckPerms false
    • blocksPerTool false
    • whitelistMode true/false for global and per-tool lists
    • activationMode crouch/keybind with hold/toggle options
    • emptyHandEnabled false

  • AllowedTools.toml

    • Defaults: all pickaxes (wood → netherite).

  • AllowedBlocks.toml

    • Defaults: overworld ores, deepslate variants, nether gold/quartz/gilded blackstone/ancient debris.

  • AllowedBlocksPerTool.toml

    • Populated when per-tool mode is enabled, seeded from defaults.

🛡️ Permissions

Spoiler

General

  • veinminer.use
  • veinminer.reload
  • veinminer.settings.manage
  • veinminer.*

Blocks

  • veinminer.blocks.manage
  • veinminer.blocks.add
  • veinminer.blocks.remove
  • veinminer.blocks.list
  • veinminer.blocks.*

Tools

  • veinminer.tools.manage
  • veinminer.tools.add
  • veinminer.tools.remove
  • veinminer.tools.list
  • veinminer.tools.*

Per-Tool

  • veinminer.blockpertool.manage
  • veinminer.blockpertool.blocks.add|remove|list
  • veinminer.blockpertool.tools.add|remove|list
  • veinminer.blockpertool.blocks.*, veinminer.blockpertool.tools.*

Particles

  • veinminer.particles.manage
  • veinminer.particles.enable, veinminer.particles.disable
  • veinminer.particles.setcolor, veinminer.particles.setduration

🧱 Compatibility

  • ✅ Minecraft 1.20.x, 1.21.x
  • ✅ Fabric builds available
  • ✅ NeoForge builds available
  • ✅ Works on dedicated servers and single-player (integrated server)
  • ❌ No Forge builds planned.

🖥️ Client Optional

Installing the client build enables the hotkey and sends key state to the server. Default key: V. Without the client, crouch-to-activate is available via requireCrouch for a vanilla-only experience.

📌 Planned

  • 🌐 Translations
  • ✨ Veinminer enchantment

🤔 Considering

  • 🕹️ Client-side visual cues
  • 📊 Mining stats

📥 Installation

  1. Download the latest build for your platform.
  2. Drop the jar in /mods.
  3. Restart the server or client.
  4. Configure with commands or edit the TOML files.

💬 Support

Discord: https://discord.gg/43nu6wSWRC

🧰 Other Projects

open_in_new View on Modrinth
Categories
Equipment Game mechanics Utility
Compatibility
Client: Optional Server: Optional
Links
Source Code ↗ Discord ↗
gavel LicenseRef-All-Rights-Reserved

Conversation

What are your thoughts?

Related projects

Optimization Utility
FerriteCore
FerriteCore

by malte0811

Memory usage optimizations

download 84.3M
favorite 12,712
Utility
Mod Menu
Mod Menu

by Prospector

Adds a mod menu to view the list of mods you have installed.

download 77.7M
favorite 22,127
Library Management Utility
YetAnotherConfigLib (YACL)
YetAnotherConfigLib (YACL)

by isxander

A builder-based configuration library for Minecraft!

download 66.1M
favorite 7,607
Adventure Transportation Utility
Xaero's Minimap
Xaero's Minimap

by thexaero

Displays a map of the nearby world terrain, players, mobs, entities in the corner of your screen. Lets you create waypoints which help you find the locations you've marked.

download 60.9M
favorite 13,668
lock Cookie consent

SkinMC uses cookies to provide functionality and features.

Customise cookies
Essential data

Essential data cookies are required to run the site you are visiting technically. You can not deactivate them.

Functional cookies

These cookies allow the provision of enhanced functionality such as videos. They may be set by us or by third-party providers whose services we have added to our pages. If you do not allow these cookies, then some or all of these functionalities may not function properly.

These cookies allow functionality from Sign in with Google to quickly sign in or create an account with Google. Data from Sign in with Google is only used for security purposes.

Analytical cookies

These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. If you do not allow these cookies, information from these cookies will not be used to help site performance.