VeinMiner is a lightweight and high-performance plugin for Minecraft that allows players to mine entire ore veins with a single action. Simply hold Shift and break a block - the entire connected vein will be mined automatically!
✨ Key Features
- Smart vein mining - automatically finds all connected blocks
- ⚡ High performance - optimized search algorithm
- ️ All tools supported - from iron to netherite
- All ore types - including new deepslate ores
- Tree felling - chop down entire trees!
- ⚙️ Flexible configuration - full control via config.yml
- Durability tracking - tools wear properly
- ✨ Enchantment support - Unbreaking works as expected
- Simple controls - toggle on/off with one command
- Customizable messages - configure all plugin messages
Installation
- Download the latest version of the plugin
- Place the JAR file in your server's plugins folder
- Restart the server
- The plugin will create a VeinMiner folder with configuration file
- Customize the plugin to your needs (optional)
How to Use
For Players:
- Enable VeinMiner with /veinminer or /vm command
- Take an appropriate tool (pickaxe, axe, or shovel)
- Hold Shift and break an ore or log block
- The entire vein will be mined automatically!
Important Notes:
- ✅ Works only in Survival and Adventure modes
- ✅ Must hold Shift while breaking the block
- ✅ Tool must be appropriate for the block
- ✅ Tool durability is considered
Commands
Command
Description
Permission
/veinminer or /vm Toggle VeinMiner on/off for yourself veinminer.use
/veinminer reload Reload configuration veinminer.reload
Permissions
Permission
Description
Default
veinminer.use Permission to use VeinMiner All players
veinminer.reload Permission to reload configuration Operators
⚙️ Configuration
Code (Text):
# Maximum vein size (number of blocks)
max-vein-size: 64
# Tools that can be used with VeinMiner
tools:
- IRON_PICKAXE
- GOLDEN_PICKAXE
- DIAMOND_PICKAXE
- NETHERITE_PICKAXE
- IRON_AXE
- GOLDEN_AXE
- DIAMOND_AXE
- NETHERITE_AXE
- IRON_SHOVEL
- GOLDEN_SHOVEL
- DIAMOND_SHOVEL
- NETHERITE_SHOVEL
# Blocks that can be mined with VeinMiner
veinable-blocks:
# Ores
- COAL_ORE
- DEEPSLATE_COAL_ORE
- IRON_ORE
- DEEPSLATE_IRON_ORE
# ... and others
# Messages (supports color codes with &)
messages:
enabled: "&aVeinMiner enabled!"
disabled: "&cVeinMiner disabled!"
reloaded: "&aVeinMiner configuration reloaded!"
no-permission: "&cYou don't have permission!"
players-only: "&cThis command can only be used by players!"
not-enough-durability: "&cNot enough tool durability!"
blocks-mined: "&7Blocks mined: %amount%"
Supported Blocks
Ores:
- Coal (regular and deepslate)
- Iron (regular and deepslate)
- Copper (regular and deepslate)
- Gold (regular, deepslate, and nether)
- Redstone (regular and deepslate)
- Emerald (regular and deepslate)
- Lapis (regular and deepslate)
- Diamond (regular and deepslate)
- Nether Quartz
- Ancient Debris
Logs:
- All log types (oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, pale oak)
Other blocks:
How It Works
Durability Calculation:
- Tool loses durability for each mined block
- Unbreaking enchantment reduces tool wear
- If durability is insufficient, mining is cancelled
Search Algorithm:
- Search checks all 26 adjacent blocks (3x3x3 cube)
- Maximum vein size is limited by configuration
- Search stops when limit is reached
Performance
- Minimal impact on server TPS
- Optimized recursive algorithm
- Vein size limit prevents lag
- Suitable for servers of any size
Compatibility
- ✅ Spigot 1.21.5+
- ✅ Paper 1.21.5+
- ✅ Purpur 1.21.5+
- ✅ Java 21+
Usage Statistics
The plugin shows the number of mined blocks after each use:
Blocks mined: 47
Message Customization
All plugin messages can be customized in the configuration file. Use standard color codes with &:
- &a - Green
- &c - Red
- &7 - Gray
- &e - Yellow
- &b - Aqua
- And more!
Example:
Code (Text):
messages:
enabled: "&b&l[VeinMiner] &aSuccessfully enabled!"
blocks-mined: "&e⛏ &7Mined &f%amount% &7blocks"
License
This plugin is distributed under the MIT License. You are free to use, modify, and distribute it.