VeinMiner: Ultimate Mining Enhancement

VeinMiner is the ultimate mining enhancement for your Minecraft server! This plugin allows players to mine entire veins of ores, logs, or other blocks simply by holding shift while breaking a block. Perfect for survival servers, Skyblock, or any server looking to enhance the mining experience.

✨ Features Instant Vein Mining - Break entire ore veins, log clusters, or other block groups with a single block break

Advanced Progression System - Players level up as they mine, unlocking the ability to mine larger veins

New Skill System - Upgrade mining efficiency via the in-game GUI

WorldGuard Integration - Fully compatible with protected regions

Achievement System - Earn achievements for mining specific blocks, reaching certain levels, and more

Update Checker - Get notified when a new plugin update is available

User-Friendly GUI - Intuitive menu system for managing settings and viewing achievements

Tool Support - Works with all mining tools - pickaxes, axes, shovels, and hoes

Enchantment Compatible - Full support for Fortune and Silk Touch enchantments

Balanced Gameplay - Configurable durability impact and hunger cost to maintain game balance

Discord Integration - Track mining activity with detailed Discord webhook notifications

Multi-Server Support - Seamless synchronization of player data across multiple servers

Visual Indicators - Clear visual feedback when VeinMiner is active or inactive

User-Friendly Commands - Simple commands with tab completion for easy management

Flexible Permission System - Control who can use the plugin with detailed permission nodes and configurable requirements

Global permission toggle for easy setup

Tool-specific permission control

Command-based permission management

Configurable permission requirements per feature

Economy Integration - Reward players with in-game currency for achievements

Commands

• /veinminer or /vm - Open the main VeinMiner GUI
• /veinminer on - Enable VeinMiner
• /veinminer off - Disable VeinMiner
• /veinminer toggle - Toggle VeinMiner on/off
• /veinminer tool <tooltype> - Toggle for specific tools
• /vmtoggle - Toggle VeinMiner on/off
• /vmlevel - Check your current level and progress
• /vmsetlevel <player> <level> - Set a player's VeinMiner level (Admin)
• /vmsync - Synchronize VeinMiner data across servers (Admin)
• /veinminerreload - Reload the configuration (Admin)
• /veinminerabout - Show plugin information
• /veinminerhelp - Display help information
• /vmskill - Open the skill menu
• /vmadmin [debug|reload|sync|stats|bstats] - Admin commands for managing the plugin (Admin)

Permissions

• veinminer.use - Allows the player to use VeinMiner
• veinminer.tool.pickaxe - Allows the player to use VeinMiner with pickaxes
• veinminer.tool.axe - Allows the player to use VeinMiner with axes
• veinminer.tool.shovel - Allows the player to use VeinMiner with shovels
• veinminer.tool.hoe - Allows the player to use VeinMiner with hoes
• veinminer.admin - Allows access to all VeinMiner admin commands (Default: op)

Placeholders

• %veinminer_level% - Shows player's current level
• %veinminer_experience% - Shows player's current XP
• %veinminer_blocks_mined% - Shows total blocks mined
• %veinminer_achievements_completed% - Shows completed achievements
• %veinminer_top_level_X% - Shows top players by level (X = position 1-10)
• %veinminer_top_achievements_X% - Shows top players by achievements (X = position 1-10)
• %veinminer_top_blocks_X% - Shows top players by blocks mined (X = position 1-10)

⚙️ Configuration

VeinMiner is highly configurable:

• Set the maximum number of blocks that can be mined at once
• Configure durability impact on tools
• Adjust hunger cost for balance
• Define which blocks can be mined
• Customize the leveling system
• Set up achievements with custom rewards
• Enable/disable Discord logging
• Configure economy integration
• Toggle WorldGuard compatibility
• Enable the update checker for new versions
• Configure permission requirements:
• Enable/disable permission requirements globally
• Set up tool-specific permissions
• Configure command permissions
• Customize permission nodes for different features

⚙️ Automatic Config Updater Never worry about missing or outdated config options again!

Whenever the plugin starts, VeinMiner automatically checks your config.yml for all important options. If any required option is missing (for example, after an update or if something was accidentally deleted), it will be added back with a safe default value—without overwriting your existing settings.

Works with all supported and legacy config versions Only missing options are added; your customizations remain untouched All changes are clearly shown in the server log with prominent warnings and a summary Ensures maximum compatibility and prevents plugin errors due to incomplete configs Example log output:

[WARNING] [CONFIG UPDATER] Added missing config option: settings.hybrid-mode = false
[WARNING] [CONFIG UPDATER] Added missing config option: settings.hybrid-blacklist with default tree/leaves blocks
[SEVERE] ------------------------------------------------------------
[SEVERE] !!! CONFIG UPDATER: Configuration has been updated !!!
[SEVERE] !!! Missing options have been added with default values. !!!
[SEVERE] !!! Please review your config.yml file for the new settings. !!!
[SEVERE] !!! Check the logs above for details on what was added. !!!
[SEVERE] ------------------------------------------------------------

If your config is already complete, you'll see:

[INFO] [CONFIG UPDATER] All configuration options are present and up to date.

This makes updating and maintaining your server configuration effortless and safe!

️ WorldGuard Integration

VeinMiner offers seamless integration with WorldGuard:

• Activate Veinminer in Worldguard protected areas or deactivate

Achievement & Skill System

• Earn rewards for mining specific blocks
• Gain recognition for reaching milestone levels
• Claim in-game currency and item rewards
• Track progress through an intuitive GUI
• Upgrade skills directly in the GUI
• Compete with other players for achievements

Getting Started

1. Download and install the plugin
2. Configure the settings in config.yml
3. Set up MySQL for the progression and achievement systems
4. Enable WorldGuard support if needed
5. Hold shift while mining to activate VeinMiner!

❓ Support

If you encounter any issues or have suggestions, please visit our Github, contact us through Spigot or ask your question on the Discord.