Vein Miner
A rare, modpack-friendly vein-mining enchantment for Minecraft 1.21.1 (NeoForge).
Break one ore with a pickaxe enchanted with Vein Miner and the entire connected vein of the same ore family comes out in a single, server-authoritative, chunk-safe operation. Built for big multiplayer servers and made to drop straight into a modpack. No client mod required.
✨ Highlights
- Tag-driven ore detection — works with vanilla, deepslate, Create Zinc and future modded ores via
#minecraft:*_ores and #c:ores/<material> tags. No hardcoded block lists.
- Same-family only — Iron veins into Iron, never into Copper, Stone, Andesite or Zinc.
- Chunk-safe & lightweight — iterative breadth-first flood fill, primitive
long queue, hard caps with early exits, never loads or scans unloaded chunks.
- True vanilla harvesting — drops, experience, advancements, statistics, Silk Touch, Fortune and modded/global loot modifiers all go through vanilla logic. No manual drops, no dupes.
- Server-authoritative — all gameplay runs on the server.
⛏️ How to get it
Enchanting table, enchanted books, master librarian trades, and structure loot — Strongholds, Mineshafts, Ancient Cities, Woodland Mansions and Trial Chambers. Rarity is similar to Mending.
Grab it for testing:
/enchant @p veinminer:vein_miner 1
or an enchanted book:
/give @p enchanted_book[stored_enchantments={"veinminer:vein_miner":1}]
⚙️ Configuration
A documented config is generated at config/veinminer-common.toml:
| Key |
Default |
Meaning |
enableVeinMiner |
true |
Master switch |
requireSneakToActivate |
true |
Only veins while sneaking |
maxBlocksPerVein |
64 |
Hard cap per vein |
scanRadius |
8 |
Max distance from origin |
durabilityMultiplier |
1.0 |
Tool damage per ore |
allowAncientDebris |
false |
Opt-in Ancient Debris veining |
villagerTradeChance |
0.05 |
Per-librarian book chance |
blockedBlocks / blockedTags |
[] |
Never vein-mined |
📦 Modpack & datapack support
Register custom ore families in data/<namespace>/ore_families/ with a simple JSON of blocks and tags — definitions take priority over the tag heuristics, so any modded ore set (e.g. Create Zinc) can be grouped into its own family.
🔧 Compatibility
- Minecraft: 1.21.1
- Loader: NeoForge 21.1.233+
- Designed for: Create, Terralith, Ecologics, Environmental, BF Biomes, Dungeons & Taverns, Naturalist, Farmer's Delight.
- Dedicated-server and multiplayer safe — all gameplay logic runs on the server.
📜 License
MIT. Free to use in any modpack.
Created by slate.
