EzMine

**EzMine** lets you reward dedicated players with smarter ore drops, auto-smelting, and configurable experience boosts. Whether you're running a Skyblock network or a survival SMP, EzMine turns the grind into an engaging progression system without touching vanilla block mechanics. !(https://img.shields.io/badge/Latest%20version-1.3.1-blue) !(https://img.shields.io/badge/Minecraft%20version-1.7%20to%201.21%2B-blue) !(https://img.shields.io/badge/Requires-Java%2017+-brightgreen) ## Feature highlights - **Permission-driven ranks**: Configure any number of mining ranks with distinct drop multipliers, experience boosts, and auto-smelt behavior. Players automatically receive the first rank they have permission for (`settings.rank-order`). - **World/region profiles**: Route different rank perks per world or WorldGuard region using profile mappings. - **World toggles**: Enable or disable EzMine per world so you can keep vanilla mining elsewhere. - **Ore tracking**: Limit EzMine to specific ores and blocks via `settings.tracked-blocks` so regular blocks remain untouched. - **Smart auto-smelt**: Convert ore drops to ingots (or custom outputs) instantly. Merge EzMine's defaults with your own recipes through `settings.auto-smelt-results`. - **Fortune control**: Disable fortune on a per-rank or per-block basis to keep progression balanced. - **Block overrides**: Fine-tune individual materials with custom multipliers or auto-smelt toggles while keeping global rank defaults. - **Custom tools**: Distribute bespoke pickaxes with scripted actions like 3×3 harvesting, ore searcher hints, and forced auto-smelt, all driven from configuration. - **Pickaxe shop**: Let players browse a GUI shop and purchase tools using optional Vault costs. - (https://www.spigotmc.org/resources/1-7-1-21-ezskills-lightweight-rpg-skill-ability-framework.131061/) / mcMMO integration: Use external skills for rank gates and experience, with optional per-world progression overrides. ## Commands & permissions | Command | Description | Permission | |---------|-------------|------------| | `/ezmine` | Show the plugin version and the caller's active rank. | `ezmine.command` (default: `true`) | | `/ezmine reload` | Reload EzMine's configuration from disk. | `ezmine.reload` (default: `op`) | | `/ezmine tool <id> ` | Give a configured custom tool to yourself or another player. | `ezmine.custom-tool` (default: `op`) | | `/pickaxe` | Open the pickaxe shop GUI. | `ezmine.pickaxe` (default: `true`) | Grant miners custom ranks with permission nodes like `ezmine.rank.vip` or `ezmine.rank.elite`. Players without a matching permission fall back to the `default` rank. Need a special pickaxe? Give staff `ezmine.custom-tool` so they can distribute the tools defined under `custom-tools`. ## Configuration cheat sheet - `settings.rank-order` — Evaluate ranks from top to bottom. The first permission a player has wins. - `settings.worlds` — Enable/disable EzMine on specific worlds. - `settings.profiles` — Map worlds or WorldGuard regions to rank profiles. - `settings.actions.ore-searcher` — Configure the ore searcher action particles and targets. - `settings.tracked-blocks` — Material list (Spigot enum names) that EzMine should manage. - `settings.auto-smelt-use-defaults` — Merge or replace EzMine's built-in smelt conversions. - `ranks.<name>.drop-multiplier` — Multiply the quantity of each drop. - `ranks.<name>.experience-multiplier` — Adjust mining XP reward. - `ranks.<name>.auto-smelt` — Toggle instant smelting for the rank. - `ranks.<name>.fortune` — Allow or disable fortune while calculating drops. - `ranks.<name>.block-overrides` — Per-material tweaks (drop, XP, auto-smelt, fortune) that supersede the rank defaults. - `profiles.<name>` — Optional rank profile groupings for world/region-specific perks. - `custom-tools` — Enable bespoke pickaxes with metadata, lore, and a list of actions each time they are activated. - `custom-tools.shop` — Configure the pickaxe shop GUI (title, rows, Vault economy usage). - `ezskills.per-world` — Optional per-world skill overrides for (https://www.spigotmc.org/resources/1-7-1-21-ezskills-lightweight-rpg-skill-ability-framework.131061/) progression. - `mcmmo.per-world` — Optional per-world skill overrides for mcMMO progression. ## Quick start 1. **Drop EzMine.jar** into your server's `plugins` folder and restart. 2. **Assign permissions** using LuckPerms, PermissionsEx, or your favorite manager. 3. **Tweak** `config.yml` with your rank order, tracked blocks, and smelting preferences. 4. **Run** `/ezmine reload` to apply changes live. ## Integration highlights - **Vault economy**: Power the pickaxe shop and tool upgrades with any Vault-compatible economy. Pair with (https://www.spigotmc.org/resources/1-7-1-21-ezeconomy-modern-vault-economy-plugin-for-minecraft-servers.130975/) for a streamlined setup. - **WorldGuard**: Target specific mi