# EzMine – Rank-Based Mining Perks, Auto-Smelt & Custom Tools for Minecraft 1.7-1.21+ **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. ![Latest version](https://img.shields.io/badge/Latest%20version-1.3.0-blue) ![Minecraft version](https://img.shields.io/badge/Minecraft%20version-1.7%20to%201.21%2B-blue) ![Requires Java 17+](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. - [**EzSkills**](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 [player]` | 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..drop-multiplier` — Multiply the quantity of each drop. - `ranks..experience-multiplier` — Adjust mining XP reward. - `ranks..auto-smelt` — Toggle instant smelting for the rank. - `ranks..fortune` — Allow or disable fortune while calculating drops. - `ranks..block-overrides` — Per-material tweaks (drop, XP, auto-smelt, fortune) that supersede the rank defaults. - `profiles.` — 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 [EzSkills](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 [EzEconomy](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 mines or regions with unique perk profiles through `settings.profiles` mappings. - **EzSkills**: Gate ranks behind skill levels and apply per-world progression rules. Configure overrides under `ezskills.per-world`. - **mcMMO**: Use mcMMO mining levels for rank requirements and optionally award mcMMO XP with `mcmmo.yml`. - **Permissions managers**: LuckPerms, PermissionsEx, and other managers control rank access via `ezmine.rank.` nodes. - **LuckPerms integration**: Optionally integrate with [LuckPerms](https://luckperms.net/) for advanced group-based rank assignment. When enabled in `settings.luckperms`, EzMine can use a player's primary LuckPerms group (or a custom group permission prefix) to determine their mining rank. This allows seamless synchronization between your server's group system and EzMine's rank progression. See the `settings.luckperms` section in your configuration for options like `enabled`, `use-primary-group`, and `group-permission-prefix`. ## Prison server setup guide Use EzMine as the backbone of your prison mine progression without rewriting your entire economy. 1. **Define mine worlds and regions**: Map each mine to a profile with `settings.profiles.worlds` or `settings.profiles.regions` so every mine can have distinct rank perks and multipliers. 2. **Create rank ladders**: Set `settings.rank-order` to match your prison ranks (A → Z, etc.). Assign permissions like `ezmine.rank.block_a`, `ezmine.rank.block_b`, and so on. 3. **Tune payouts**: Use `drop-multiplier` and `experience-multiplier` to control ore output and XP. Combine with auto-smelt to align drops with your economy pricing. 4. **Control fortune**: Disable fortune for early ranks to slow progression, then enable it later for higher tiers. 5. **Offer premium tools**: Configure `custom-tools.shop` with Vault pricing so players can buy 3×3 or auto-smelt pickaxes as upgrades. 6. **Protect vanilla worlds**: Disable EzMine in non-prison worlds using `settings.worlds` to keep survival areas untouched. ## Sample rank setup

Three-tier mining progression

```yaml settings: rank-order: - default - vip - elite tracked-blocks: - COAL_ORE - DEEPSLATE_IRON_ORE - GOLD_ORE - DIAMOND_ORE - ANCIENT_DEBRIS ranks: default: permission: "" drop-multiplier: 1.0 experience-multiplier: 1.0 auto-smelt: false fortune: true vip: permission: ezmine.rank.vip drop-multiplier: 1.5 experience-multiplier: 1.25 auto-smelt: true fortune: true block-overrides: DIAMOND_ORE: drop-multiplier: 2.0 elite: permission: ezmine.rank.elite drop-multiplier: 2.0 experience-multiplier: 1.5 auto-smelt: true fortune: true block-overrides: ANCIENT_DEBRIS: drop-multiplier: 2.0 experience-multiplier: 2.0 ```

### LuckPerms setup example If you want EzMine to use LuckPerms groups for rank assignment, enable the integration in your config: ```yaml settings: luckperms: enabled: true use-primary-group: true # Use the player's primary LuckPerms group group-permission-prefix: "group." # Default prefix for group permissions rank-order: - default - vip - elite ranks: default: permission: "group.default" drop-multiplier: 1.0 experience-multiplier: 1.0 auto-smelt: false fortune: true vip: permission: "group.vip" drop-multiplier: 1.5 experience-multiplier: 1.25 auto-smelt: true fortune: true elite: permission: "group.elite" drop-multiplier: 2.0 experience-multiplier: 1.5 auto-smelt: true fortune: true ``` With this setup, players will be assigned a mining rank based on their LuckPerms primary group (e.g., `default`, `vip`, or `elite`). You can customize the `group-permission-prefix` if your server uses a different group node format. ## World & region profiles Use profiles to run different mining perks per world or WorldGuard region: ```yaml # settings.yml settings: profiles: default: default worlds: world_nether: nether regions: world: vip_mine: vip ``` ```yaml # ranks.yml profiles: default: rank-order: - default - vip ranks: default: permission: "" drop-multiplier: 1.0 experience-multiplier: 1.0 auto-smelt: false fortune: true vip: permission: ezmine.rank.vip drop-multiplier: 1.5 experience-multiplier: 1.25 auto-smelt: true fortune: true nether: rank-order: - default ranks: default: permission: "" drop-multiplier: 1.2 experience-multiplier: 1.2 auto-smelt: true fortune: true ``` ## mcMMO integration Enable `mcmmo.yml` to use mcMMO mining levels for rank requirements and (optionally) award mcMMO experience. If both EzSkills and mcMMO are enabled, EzSkills takes priority. ```yaml mcmmo: enabled: true skill: MINING per-world: enabled: true skill-overrides: world: MINING world_nether: MINING_NETHER experience: base-per-block: 2.0 apply-rank-multiplier: true material-overrides: ANCIENT_DEBRIS: 12.0 ``` ## Custom tools Define custom mining tools in `config.yml` to bundle metadata and scripted actions: ```yaml custom-tools: enabled: true shop: enabled: true title: "&8Pickaxe Shop" rows: 3 currency-name: "coins" vault: enabled: false tools: quarry-hammer: material: NETHERITE_PICKAXE name: "&bQuarry Hammer" lore: - "&7Configured hammer for EzMine." - "&7Right-click to activate its abilities." actions: - "3x3" - "auto-smelt" - "ore-searcher" shop: visible: true slot: 13 cost: 0 ``` Players right-click the configured item to activate its actions until they switch tools. Supported actions include: - `3x3` — Break a 3×3 area centred on the target block (horizontal plane). - `auto-smelt` — Force smelting even if the player's rank would normally drop raw ores. - `ore-searcher` — Show hint particles pointing toward nearby ores while mining. Distribute these tools with `/ezmine tool [player]` or bundle them into starter kits. ## Why admins love EzMine - **Minimal setup**: Ships with sensible defaults for all major ores and auto-smelt conversions. - **Economy friendly**: Combine rank-specific multipliers with your economy plugins to price upgrades. Pair with [EzEconomy](https://www.spigotmc.org/resources/1-7-1-21-ezeconomy-modern-vault-economy-plugin-for-minecraft-servers.130975/) or any Vault-compatible economy. - **Low overhead**: Only hooks tracked blocks and leaves everything else untouched for vanilla behavior. Ready to bring prestige mining to your world? Install EzMine and let your players feel the climb from stone pickaxes to elite miners in minutes. ## Need help? Have questions or feedback? Visit our SpigotMC discussion thread or [join the EzMine Discord server](https://discord.gg/yWP95XfmBS) for direct support and release updates.

Published on	December 24, 2025
Downloads	0

EzMine

Release 1.1.0

Shadow48402 released EzMine version 1.1.0 on December 24, 2025

Information

Platforms

Dependencies

Release
1.1.0