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.

Vein Miner Enchantment