# \u26cf Veinminer<\/p>\n
**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.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Key Features<\/p>\n
– \ud83e\uddf1 **Vein Mining** \u2014 mines adjacent matching blocks with TPS-aware block caps.
\n– \ud83d\udee0\ufe0f **Activation Choices** \u2014 crouch or hotkey; hold or toggle modes per player.
\n– \ud83d\ude4c **Empty-Hand Support** \u2014 trigger without holding a tool (optional).
\n– \ud83e\uddf0 **Flexible Block Lists** \u2014 global and per-tool lists can be whitelist or blacklist.
\n– \ud83e\ude93 **Per-Tool Rules** \u2014 different block sets per tool; seeded defaults.
\n– \u26a1 **Fortune\/Silk & Durability Safety** \u2014 honors enchants; optional durability guard.
\n– \ud83d\udd01 **Cooldown & Limits** \u2014 optional cooldown; static or dynamic max blocks.
\n– \u2734\ufe0f **Particles\/Outline** \u2014 server-driven outline with color + duration controls.
\n– \ud83d\udd10 **LuckPerms Toggle** \u2014 optional integration for permissions.
\n– \ud83e\uddea **\/veinminer test** \u2014 quick command to verify behavior and responses.
\n– \ud83d\udd04 **Live Reloads** \u2014 `\/veinminer reload` with file\/line reporting on errors.<\/p>\n
> Works server-side out of the box. Optional client mod adds the hotkey (default **V**).<\/p>\n
—<\/p>\n
## \ud83d\udd27 Configuration & Commands<\/p>\n
### Command quick reference<\/p>\n
| Command | Description | —<\/p>\n ### Config files<\/p>\n Written to `config\/Veinminer\/` (TOML) on first run.<\/p>\n – **GeneralConfig.toml** – **AllowedTools.toml** – **AllowedBlocks.toml** – **AllowedBlocksPerTool.toml** —<\/p>\n ## \ud83d\udee1\ufe0f Permissions<\/p>\n ### General ### Blocks ### Tools ### Per-Tool ### Particles —<\/p>\n ## \ud83e\uddf1 Compatibility<\/p>\n – \u2705 Minecraft 1.20.x, 1.21.x —<\/p>\n ## \ud83d\udda5\ufe0f Client Optional<\/p>\n 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.<\/p>\n —<\/p>\n ## \ud83d\udccc Planned<\/p>\n – \ud83c\udf10 Translations —<\/p>\n ## \ud83e\udd14 Considering<\/p>\n – \ud83d\udd79\ufe0f Client-side visual cues —<\/p>\n ## \ud83d\udce5 Installation<\/p>\n 1. Download the latest build for your platform. —<\/p>\n ## \ud83d\udcac Support<\/p>\n Discord: https:\/\/discord.gg\/43nu6wSWRC <\/p>\n —<\/p>\n ## \ud83e\uddf0 Other Projects<\/p>\n – \ud83d\udd28 Hammer Mining \u2014 3\u00d73 breaking via enchant.<\/p>\n","protected":false},"excerpt":{"rendered":" Veinminer\u00a0is 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.<\/p>\n","protected":false},"featured_media":137909,"template":"","meta":{"_minecraft_slug":"sgtveinminer","_minecraft_project_id":"MnavVAzj","_minecraft_author":"SGTSambam","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":359710,"_minecraft_follows":108,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"sgtveinminer.zip","_minecraft_size_bytes":142793704,"_minecraft_version_count":175,"_minecraft_updated_at":"2026-05-16T18:20:52.263649Z","_minecraft_date_created":"2024-09-09T23:40:41.194982Z","_minecraft_date_modified":"2026-02-16T20:46:54.825716Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sgtveinminer","_minecraft_icon_attachment_id":137909,"_minecraft_imported_at":"2026-06-08T03:44:32+00:00","_minecraft_import_hash":"ee5121bb4a295b28d909c45e58735305","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,97,89,158,92],"mod_loader":[99,160],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137908","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-fabric","mod_category-game-mechanics","mod_category-neoforge","mod_category-utility","mod_loader-fabric","mod_loader-neoforge","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| — | — |
\n| `\/veinminer help` | List commands. |
\n| `\/veinminer reload` | Reload config without restart (errors show file\/line). |
\n| `\/veinminer test` | Run a quick behavior check. |
\n| `\/veinminer toggle` | Toggle Veinminer for yourself. |
\n| `\/veinminer blocks add\/remove\/list
\n| `\/veinminer tools add\/remove\/list
\n| `\/veinminer settings blockpertool` | Toggle per-tool block logic. |
\n| `\/veinminer settings cooldown enable|disable` | Turn cooldown on or off. |
\n| `\/veinminer settings cooldown set
\n| `\/veinminer settings maxblocks
\n| `\/veinminer settings luckperms enable|disable` | Toggle LuckPerms integration. |
\n| `\/veinminer blockpertool blocks
\n| `\/veinminer blockpertool tool add\/remove\/list
\n| `\/veinminer particles enable|disable` | Toggle vein outline particles. |
\n| `\/veinminer particles setcolor
\n| `\/veinminer particles setduration
\n| `\/veinminer togglemessages permission|disabled|cooldown` | Toggle specific chat tips. |<\/p>\nSpoiler<\/summary>\n
\n – `veinminerEnabled` true
\n – `requireCrouch` true
\n – `checkToolDurability` true, `durabilityCap` 1, `durabilityThreshold` `ABSOLUTE`
\n – `cooldownEnabled` false, `cooldownSeconds` 5
\n – `dynamicMaxBlocks` false, `maxBlocks` 64, `minBlocks` 16, `maxDynamicBlocks` 64 (TPS-aware)
\n – `enableParticleOutline` true, `particleDurationTicks` 60, `particleRed` 255, `particleGreen` 0, `particleBlue` 0
\n – `autoLuckPerms` false
\n – `blocksPerTool` false
\n – `whitelistMode` true\/false for global and per-tool lists
\n – `activationMode` crouch\/keybind with hold\/toggle options
\n – `emptyHandEnabled` false<\/p>\n
\n – Defaults: all pickaxes (wood \u2192 netherite).<\/p>\n
\n – Defaults: overworld ores, deepslate variants, nether gold\/quartz\/gilded blackstone\/ancient debris.<\/p>\n
\n – Populated when per-tool mode is enabled, seeded from defaults.<\/p>\n<\/details>\nSpoiler<\/summary>\n
\n– `veinminer.use`
\n– `veinminer.reload`
\n– `veinminer.settings.manage`
\n– `veinminer.*`<\/p>\n
\n– `veinminer.blocks.manage`
\n– `veinminer.blocks.add`
\n– `veinminer.blocks.remove`
\n– `veinminer.blocks.list`
\n– `veinminer.blocks.*`<\/p>\n
\n– `veinminer.tools.manage`
\n– `veinminer.tools.add`
\n– `veinminer.tools.remove`
\n– `veinminer.tools.list`
\n– `veinminer.tools.*`<\/p>\n
\n– `veinminer.blockpertool.manage`
\n– `veinminer.blockpertool.blocks.add|remove|list`
\n– `veinminer.blockpertool.tools.add|remove|list`
\n– `veinminer.blockpertool.blocks.*`, `veinminer.blockpertool.tools.*`<\/p>\n
\n– `veinminer.particles.manage`
\n– `veinminer.particles.enable`, `veinminer.particles.disable`
\n– `veinminer.particles.setcolor`, `veinminer.particles.setduration`<\/p>\n<\/details>\n
\n– \u2705 Fabric builds available
\n– \u2705 NeoForge builds available
\n– \u2705 Works on dedicated servers and single-player (integrated server)
\n– \u274c No Forge builds planned. <\/p>\n
\n– \u2728 Veinminer enchantment <\/p>\n
\n– \ud83d\udcca Mining stats <\/p>\n
\n2. Drop the jar in `\/mods`.
\n3. Restart the server or client.
\n4. Configure with commands or edit the TOML files. <\/p>\n