🔨 VeinMiner Plugin
📖 Description:
VeinMiner is a Minecraft plugin for Paper 1.21+ that adds a new enchantment called Vein Miner. This enchantment allows you to automatically mine entire ore veins with a single hit!
How does it work?
When you mine an ore block with a pickaxe enchanted with Vein Miner (while holding Shift), the plugin automatically finds and mines all connected blocks of the same ore type within a radius of up to 64 blocks.
✨ Features
- ⛏️ Automatic vein mining - mine entire veins with one click
- 🎯 Works only on ores - safe for other blocks
- 📚 Custom enchantment - added via datapack
- 🔧 Tool durability - pickaxe loses durability for each mined block
- ⚡ Requires Shift - control when you use the enchantment
🎮 How to Use
Step 1: Get the enchanted book
/veinminer
You will receive an enchanted book with Vein Miner I
Step 2: Apply enchantment to pickaxe
Open an anvil
Place your pickaxe in the first slot
Place the enchanted book in the second slot
Take the enchanted pickaxe
Step 3: Mining veins
Hold the enchanted pickaxe in your hand
Hold Shift (sneak)
Mine an ore block
💥 The entire vein will be mined!
⛏️ Supported Ores
The plugin works on all ore types:
Overworld:
- 🪨 Coal (Coal Ore, Deepslate Coal Ore)
- ⚙️ Iron (Iron Ore, Deepslate Iron Ore)
- 🥇 Gold (Gold Ore, Deepslate Gold Ore)
- 💎 Diamond (Diamond Ore, Deepslate Diamond Ore)
- 💚 Emerald (Emerald Ore, Deepslate Emerald Ore)
- 🔵 Lapis (Lapis Ore, Deepslate Lapis Ore)
- 🔴 Redstone (Redstone Ore, Deepslate Redstone Ore)
- 🟠 Copper (Copper Ore, Deepslate Copper Ore)
Nether:
- 🥇 Nether Gold (Nether Gold Ore)
- s⚪ Quartz (Nether Quartz Ore)
🔧 Installation
Requirements:
- Paper 1.21 or newer
- Java 21
Installation Steps:
- Download VeinMiner-2.0.jar
- Place it in the plugins/ folder
- Start the server
- The plugin will automatically create a datapack in world/datapacks/veinminer/
- Restart the server or use /reload confirm
Verify Installation:
- /datapack list
- You should see [file/veinminer] in the list
🎯 Commands
- CommandDescriptionPermission/veinminerGives an enchanted book with Vein Minerveinminer.use
🔐 Permissions
- PermissionDescriptionDefaultveinminer.useAllows use of /veinminer commandOP
⚙️ Mechanics
Vein Mining:
- The plugin searches for all adjacent blocks of the same ore type
- Maximum 64 blocks at once
- Checks only 6 directions (up, down, left, right, front, back)
Tool Durability:
- The pickaxe loses 1 durability for each mined block
- If the pickaxe breaks, it disappears from your hand
- You hear the item breaking sound
Activation Conditions:
- ✅ Player is holding Shift
- ✅ Holding a pickaxe with Vein Miner enchantment
- ✅ Mining block is an ore
