⛏ 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 |
Turn cooldown on or off. |
/veinminer settings cooldown set <seconds> |
Set cooldown time. |
/veinminer settings maxblocks <number> |
Set hard cap per activation. |
/veinminer settings luckperms enable|disable |
Toggle LuckPerms integration. |
/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 |
Toggle vein outline particles. |
/veinminer particles setcolor <r> <g> <b> |
RGB color for outline. |
/veinminer particles setduration <ticks> |
Outline lifetime. |
/veinminer togglemessages permission|disabled|cooldown |
Toggle specific chat tips. |
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.
Project members
SGTSambam
Developer
