Java Edition data pack
OreVeinMiner
Mine one ore normally and the connected remainder enters a bounded, player-owned queue. Every additional block keeps its original loot table, tool context and ore family.
01 / Install
Install the file for your exact range
Use OreVeinMiner-7.0.1+1.16-1.16.5.zip.
Use OreVeinMiner-7.0.1+1.17-1.20.4.zip.
Use OreVeinMiner-7.0.1+1.20.5-1.20.6.zip. This build uses item components for additional-block durability.
Use OreVeinMiner-7.0.1+1.21-1.21.1.zip. Its singular data directories match the 1.21 layout.
Use OreVeinMiner-3.1.0+1.21.2-26.2.zip.
Remove older OreVeinMiner copies from the world's datapacks folder.
Put the selected ZIP in world/datapacks without extracting it.
Run /reload, crouch, then mine a supported ore with a valid pickaxe.
Do not load OreVeinMiner with VeinMiner. VeinMiner already handles ores, so both packs would observe the same first block. TreeVeinMiner handles a different block set and does not replace OreVeinMiner.
02 / Use
The first block is always normal Minecraft mining
- Play in Survival, hold a pickaxe able to harvest the selected ore and crouch under the default activation mode.
- Break the first ore normally. The pack confirms the targeted block disappeared and the matching mined statistic increased.
- Connected blocks of the same ore family are processed through the queue. Stone and deepslate variants can belong to one vein.
/trigger ovl.toggleToggle OreVeinMiner off or on for your player.
/trigger ovm.toggle set 1Enable OreVeinMiner for your player.
/trigger ovm.toggle set 2Disable it and cancel your active operation.
03 / Commands
Operator controls
/function oreveinminer:admin/enableEnable new operations globally.
/function oreveinminer:admin/disableDisable new operations globally.
/function oreveinminer:admin/adjacency_immediateFollow all 26 immediately touching positions. This is the default.
/function oreveinminer:admin/adjacency_facesFollow only the six face-sharing positions.
/function oreveinminer:admin/safety_onStop before an additional block would consume the tool's final durability point.
/function oreveinminer:admin/safety_offAllow normal tool exhaustion. This is the default.
Legacy 7.0.1 controls
/function oreveinminer:admin/preview_onShow the mining preview.
/function oreveinminer:admin/preview_offDisable the preview. This is the default.
/function oreveinminer:admin/resetRestore the default global settings.
/scoreboard players set #value ovl.input 256 /function oreveinminer:admin/set_max /scoreboard players set #value ovl.input 24 /function oreveinminer:admin/set_budget
Maximum additional blocks accepts 1–512. Queue visits per player per tick accepts 1–64. Invalid values restore that setting's default.
OreVeinMiner 3.1.0 controls
/function oreveinminer:admin/crouch_requiredRequire crouching to begin a vein. This is the default.
/function oreveinminer:admin/always_activeAllow a vein to begin without crouching.
/function oreveinminer:admin/durability_onCharge durability for additional blocks. This is the default.
/function oreveinminer:admin/durability_offDisable additional-block durability costs.
/function oreveinminer:admin/debug_onSend operation diagnostics while testing.
/function oreveinminer:admin/debug_offDisable diagnostics. This is the default.
/function oreveinminer:admin/set_max {value:256}
/function oreveinminer:admin/set_budget {value:24}
The macro object is part of the command. Maximum additional blocks accepts 1–512; queue visits per player per tick accepts 1–64.
04 / Supported ores
Eleven separate ore families
Only blocks present in the selected Minecraft version can be mined. Overworld stone and deepslate variants share a family, but different materials do not merge into one operation.
Coal, copper, diamond, emerald, gold, iron, lapis and redstone ore.
Nether gold ore and nether quartz ore remain separate families.
Ancient debris has its own family and still requires a suitable harvest tier.
Same family only. A diamond vein will not cross through iron ore, even when the blocks touch.
05 / Add blocks
Tags extend matching, not first-block detection
OreVeinMiner does not include VeinMiner's arbitrary custom-block configuration. Its starting detector is built from the shipped vanilla mined-stat objectives.
Family tags are under data/oreveinminer/tags/blocks/family/.
Family tags are under data/oreveinminer/tags/block/family/.
- Adding a block to an existing family can let it be followed after a built-in vanilla ore starts that family.
- Adding a modded block to a tag does not create the mined-stat objective needed for that block to start a vein by itself.
- Use VeinMiner when arbitrary mod blocks must start their own operations through its custom-block system.
06 / Loot & durability
Loot uses the held pickaxe against the original block
Every accepted additional block runs its Minecraft loot table with the owner's main hand before becoming air. Fortune and Silk Touch therefore follow the block's normal loot behavior. Ore experience is added only where normal non-Silk mining awards it.
Minecraft 1.16 durability: only the normally mined first block costs durability. This build never reconstructs or replaces the held pickaxe, preventing the legacy item-loss failure.
Each additional accepted block applies one Unbreaking-aware durability attempt. Optional last-use safety stops the queue before the final point is consumed.
Mined entirely by Minecraft before the queue starts.
Generated from each original block with the owner's main-hand tool.
Rechecked before each queued block is accepted.
07 / Performance
Work is capped per player and per operation
The default limit is 128 additional blocks, with 16 queue visits per player per tick. Only matching neighboring blocks enter the modern 3.1.0 frontier; no operation means there is no vein queue to drain.
128 additional blocks after the normally mined first ore.
16 queue visits per active player per tick.
Each operation remains attached to the player who started it.
08 / Troubleshooting
Check the trigger conditions first
- Nothing happens: confirm the selected ZIP matches the server version, run
/reload, crouch and use a pickaxe that can harvest the ore. - Only one block breaks: nearby blocks must belong to the same ore family and touch through the selected six- or 26-neighbor rule.
- The feature stopped for one player: use the version-specific player command shown in the Use section.
- Duplicate drops or competing effects: remove VeinMiner or another ore-mining pack that observes the same block break.
- A modded ore does not start: this is expected from a tag-only edit; use VeinMiner's custom-block system for arbitrary starting blocks.