⛏ Veinminer

Veinminer is a configurable mining mod that lets you break entire veins of connected blocks by mining a single block. It cuts the grind while keeping server owners in control with clear rules, limits, and permissions.

⚙️ Key Features

🧱 Vein Mining — mines adjacent blocks of the same type.
⚒️ Tool-Only Logic — restrict by tool, defaults to pickaxes.
📦 Block Whitelist — control exactly which blocks are vein-minable.
🔁 Per-Tool Block Rules — different block sets per tool.
🪄 Fortune and Silk Touch — fully respected.
⏲️ Cooldowns — optional, with duration control.
🎛️ Block Limits — set max blocks, or use dynamic limits.
👤 Player Toggle — on or off per player.
✴️ Particles/Preview — server-driven outline with color and duration controls.
🧷 Durability Safety — optional threshold and cap to avoid breaking tools.
🔐 LuckPerms friendly — optional integration for permissions.

Works server-side out of the box. Optional client mod adds a hotkey. Default hotkey: V.

🔧 Configuration & Commands

Command quick reference

Command	Description
`/veinminer help`	List commands.
`/veinminer reload`	Reload config without restart.
`/veinminer toggle`	Toggle Veinminer for yourself.
`/veinminer blocks add/remove/list <block>`	Manage global block whitelist.
`/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/ as 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
- enableParticleOutline true, particleDurationTicks 60, particleRed 255, particleGreen 0, particleBlue 0
- autoLuckPerms false
- blocksPerTool false
AllowedTools.toml
- Defaults: all pickaxes, wooden to 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
✅ Works on dedicated servers and single-player (integrated server)
🔶 NeoForge: builds are listed on Modrinth for select versions. Check the Versions tab for platform on each file.
❌ 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

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

💬 Support

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

🧰 Other Projects

🔨 Hammer Mining — 3×3 breaking via enchant.

Veinminer