VeinMainer

🔨 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