[1.7 - 26.1.*] EzMine - Boost the mine experience on your Minecraft server

EzMine - Rank-Based Mining Perks, Auto-Smelt & Custom Tools for Minecraft 1.7-26.1+

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.

Searching for a prison server that wants to partner with EzMine to make EzMine better. Please contact me in the Discord server.





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, vein mining, ore searcher hints, and forced auto-smelt, all driven from configuration.
• Vein miner: Mine an entire connected ore vein in one swing. A BFS flood-fill finds all face-adjacent same-material blocks up to a configurable max-blocks limit (default 64).
• Pickaxe shop: Let players browse a GUI shop and purchase tools using optional Vault costs.
  
• EzSkills/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> [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.actions.vein-miner — Configure the vein miner action (enabled, max-blocks).
• 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 EzSkills 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 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.<name> nodes.
• LuckPerms integration: Optionally integrate with LuckPerms 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


LuckPerms setup example

If you want EzMine to use LuckPerms groups for rank assignment, enable the integration in your config:

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:
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.
Custom tools
Define custom mining tools in config.yml to bundle metadata and scripted actions:
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.
• vein-miner — Mine the entire connected ore vein (face-adjacent same-material blocks, BFS).

Configuration validation
When EzMine loads `custom-tools` it performs sanity checks and reports problems in the server log. Fatal errors (such as a missing or unknown `material`, or duplicate tool IDs after normalization) will disable `custom-tools` until you fix them.

Watch for these common messages and how to fix them:
- "Missing material for custom tool <id>": add a valid Spigot `Material` name (e.g. `NETHERITE_PICKAXE`).
- "Unknown material <name> for custom tool <id>": correct the material name or use a supported material.
- "Duplicate custom tool id after normalization: <id>": ensure tool keys are unique when lowercased.
- "Unknown action '<action>' for custom tool <id>": use a built-in action (e.g. `3x3`, `auto-smelt`, `ore-searcher`) or define it in the `actions` section.
- "custom-model-data must be zero or positive for custom tool <id>": use a non-negative integer for `custom-model-data`.
- "shop.slot out of range for custom tool <id>": choose a `slot` between `0` and `rows*9 - 1`.

If you see warnings (non-fatal issues), EzMine will still load the tool but the behaviour may differ. After fixing the YAML, run `/ezmine reload` to re-apply the configuration.

Distribute these tools with /ezmine tool <id> [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 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 for direct support and release updates.