EzMine 让您可以奖励忠实玩家,提供更智能的矿石掉落、自动熔炼以及可配置的经验值加成。无论您运营的是空岛网络服还是生存 SMP,EzMine 都能在不改动原版方块机制的前提下,将枯燥的挖矿过程转化为引人入胜的进阶系统。
功能亮点
- 基于权限的等级:配置任意数量的挖矿等级,每个等级拥有独立的掉落倍率、经验加成和自动熔炼行为。玩家会自动获得其拥有权限的第一个等级(
settings.rank-order)。
- 世界/区域档案:通过档案映射,在不同世界或 WorldGuard 区域中路由不同的等级福利。
- 世界开关:按世界启用或禁用 EzMine,以便在其他地方保留原版挖矿体验。
- 矿石追踪:通过
settings.tracked-blocks 将 EzMine 限制在特定的矿石和方块上,确保普通方块不受影响。
- 智能自动熔炼:即时将矿石掉落物转换为锭(或自定义输出)。通过
settings.auto-smelt-results 将 EzMine 的默认设置与您自己的配方合并。
- 时运控制:可按等级或按方块禁用时运,以保持进阶系统的平衡。
- 方块覆盖:微调单个材料的自定义倍率或自动熔炼开关,同时保持全局等级默认设置。
- 自定义工具:分发具有脚本动作的特制镐子,如 3×3 采集、矿石搜索提示和强制自动熔炼,所有功能均由配置文件驱动。
- 镐子商店:让玩家浏览 GUI 商店并使用可选的 Vault 费用购买工具。
- EzSkills / mcMMO 集成:使用外部技能作为等级门槛和经验来源,并支持可选的按世界进度覆盖。
命令与权限
| 命令 |
描述 |
权限 |
/ezmine |
显示插件版本及调用者当前激活的等级。 |
ezmine.command (默认: true) |
/ezmine reload |
从磁盘重新加载 EzMine 的配置。 |
ezmine.reload (默认: op) |
/ezmine tool <id> [player] |
给自己或其他玩家发放已配置的自定义工具。 |
ezmine.custom-tool (默认: op) |
/pickaxe |
打开镐子商店 GUI。 |
ezmine.pickaxe (默认: true) |
授予矿工自定义等级权限节点,例如 ezmine.rank.vip 或 ezmine.rank.elite。没有匹配权限的玩家将回退到 default 等级。
需要特殊的镐子?给工作人员分配 ezmine.custom-tool 权限,以便他们分发在 custom-tools 下定义的工具。
配置速查表
settings.rank-order — 从上到下评估等级。玩家拥有的第一个权限即生效。
settings.worlds — 在特定世界上启用/禁用 EzMine。
settings.profiles — 将世界或 WorldGuard 区域映射到等级档案。
settings.actions.ore-searcher — 配置矿石搜索动作的粒子效果和目标。
settings.tracked-blocks — EzMine 应管理的材料列表(Spigot 枚举名称)。
settings.auto-smelt-use-defaults — 合并或替换 EzMine 内置的熔炼转换。
ranks.<name>.drop-multiplier — 乘数,用于增加每次掉落的数量。
ranks.<name>.experience-multiplier — 调整挖矿经验奖励。
ranks.<name>.auto-smelt — 切换该等级的即时熔炼功能。
ranks.<name>.fortune — 在计算掉落时允许或禁用时运。
ranks.<name>.block-overrides — 按材料细分的调整项(掉落、XP、自动熔炼、时运),优先级高于等级默认设置。
profiles.<name> — 可选的等级档案分组,用于针对特定世界/区域的福利。
custom-tools — 启用带有元数据、lore 和激活时执行的一系列动作列表的特制镐子。
custom-tools.shop — 配置镐子商店 GUI(标题、行数、Vault 经济系统使用情况)。
ezskills.per-world — 可选的按世界技能覆盖,用于 EzSkills 进阶。
mcmmo.per-world — 可选的按世界技能覆盖,用于 mcMMO 进阶。
快速开始
- 将 EzMine.jar 放入服务器的
plugins 文件夹并重启。
- 使用 LuckPerms、PermissionsEx 或您喜欢的管理插件 分配权限。
- 根据您的等级顺序、追踪方块和熔炼偏好 调整
config.yml。
- 运行
/ezmine reload 以实时应用更改。
集成亮点
- Vault 经济系统:利用任何兼容 Vault 的经济系统为镐子商店和工具升级提供支持。搭配 EzEconomy 可实现 streamlined setup(简化设置)。
- WorldGuard:通过
settings.profiles 映射,针对具有独特福利档案的特定矿场或区域进行定位。
- EzSkills:将等级绑定在技能等级之后,并应用按世界的进度规则。在
ezskills.per-world 下配置覆盖选项。
- mcMMO:使用 mcMMO 挖矿等级作为等级要求,并可选择通过
mcmmo.yml 奖励 mcMMO 经验值。
- 权限管理器:LuckPerms、PermissionsEx 及其他管理器通过
ezmine.rank.<name> 节点控制等级访问权限。
- LuckPerms 集成:可选地集成 LuckPerms 以实现基于组的复杂等级分配。当在
settings.luckperms 中启用时,EzMine 可以使用玩家的 LuckPerms 主组(或自定义组权限前缀)来确定其挖矿等级。这允许服务器的组系统与 EzMine 的等级进阶实现无缝同步。请参阅配置文件中的 settings.luckperms 部分,查看 enabled、use-primary-group 和 group-permission-prefix 等选项。
监狱服务器设置指南
使用 EzMine 作为你的监狱矿坑进度系统的核心,无需重写整个经济系统。
- 定义矿坑世界和区域:通过
settings.profiles.worlds 或 settings.profiles.regions 将每个矿坑映射到对应的配置文件中,以便每个矿坑都能拥有独立的权限加成和倍率。
- 创建等级阶梯:设置
settings.rank-order 以匹配你的监狱等级(A → Z 等)。分配相应的权限,如 ezmine.rank.block_a、ezmine.rank.block_b 等。
- 调整收益:使用
drop-multiplier 和 experience-multiplier 来控制矿石产出和经验值。结合自动熔炼功能,使掉落物与你的经济定价相匹配。
- 控制幸运值:在低级阶段禁用幸运附魔以减缓进度,然后在更高等级时启用它。
- 提供高级工具:通过 Vault 定价配置
custom-tools.shop,让玩家购买 3×3 范围或带自动熔炼功能的镐子作为升级道具。
- 保护原版世界:在非监狱世界中禁用 EzMine(使用
settings.worlds),以确保生存模式区域不受影响。
示例等级设置
三级采矿进度
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 设置示例
如果你希望 EzMine 使用 LuckPerms 组来进行等级分配,请在配置中启用集成:
settings:
luckperms:
enabled: true
use-primary-group: true # 使用玩家的主要 LuckPerms 组
group-permission-prefix: "group." # 组权限的默认前缀
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
在此设置下,玩家将根据其 LuckPerms 主要组(例如 default、vip 或 elite)被分配采矿等级。如果你的服务器使用不同的组节点格式,你可以自定义 group-permission-prefix。
世界与区域配置文件
使用配置文件在不同世界或 WorldGuard 区域运行不同的采矿加成:
# settings.yml
settings:
profiles:
default: default
worlds:
world_nether: nether
regions:
world:
vip_mine: vip
# 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 集成
启用 mcmmo.yml 以使用 mcMMO 采矿等级作为等级要求,并(可选地)发放 mcMMO 经验值。如果同时启用了 EzSkills 和 mcMMO,EzSkills 将具有优先权。
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
自定义工具
在 config.yml 中定义自定义采矿工具,以捆绑元数据和脚本化动作:
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
玩家右键点击配置好的物品即可激活其功能,直到切换工具为止。支持的动作包括:
3x3 — 破坏以目标方块为中心的 3×3 区域(水平平面)。
auto-smelt — 强制熔炼,即使玩家的等级原本会掉落原矿。
ore-searcher — 在挖掘时显示指向附近矿石的提示粒子。
可以通过 /ezmine tool <id> [player] 命令分发这些工具,或将它们打包进新手套件中。
配置验证
当 EzMine 加载 custom-tools 时,它会执行健全性检查并在服务器日志中报告问题。致命错误(例如缺少或未知的 material,或在规范化后出现重复的工具 ID)将导致 custom-tools 被禁用,直到你修复这些问题为止。
留意以下常见消息及其修复方法:
Missing material for custom tool <id> — 添加有效的 Spigot Material 名称(例如 NETHERITE_PICKAXE)。
Unknown material <name> for custom tool <id> — 更正材料名称或使用受支持的材料。
Duplicate custom tool id after normalization: <id> — 确保工具键在转换为小写后是唯一的。
Unknown action '<action>' for custom tool <id> — 使用内置动作(例如 3x3、auto-smelt、ore-searcher)或在 actions 部分中定义它。
custom-model-data must be zero or positive for custom tool <id> — 为 custom-model-data 使用非负整数。
shop.slot out of range for custom tool <id> — 选择介于 0 和 rows*9 - 1 之间的 slot 值。
如果看到警告(非致命问题),EzMine 仍会加载该工具,但行为可能有所不同。修复 YAML 后,运行 /ezmine reload 以重新应用配置。
为什么管理员喜爱 EzMine
- 极简设置:内置针对所有主要矿石的合理默认值及自动熔炼转换。
- 经济兼容:可将特定等级的倍数与你的经济插件结合,用于定价升级。搭配 EzEconomy 或任何兼容 Vault 的经济系统即可。
- 极低开销:仅追踪已注册的方块,其余部分保持原样,确保原版行为不受影响。
准备好为你的世界带来声望采矿体验了吗?安装 EzMine,让玩家在几分钟内从石镐成长为精英矿工。
需要帮助?
有问题或反馈?加入 EzPlugins Discord 服务器 获取直接支持与版本更新。

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.
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 / 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.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
- Drop EzMine.jar into your server's
plugins folder and restart.
- Assign permissions using LuckPerms, PermissionsEx, or your favorite manager.
- Tweak
config.yml with your rank order, tracked blocks, and smelting preferences.
- 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.
- 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.
- 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.
- 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.
- Control fortune: Disable fortune for early ranks to slow progression, then enable it later for higher tiers.
- Offer premium tools: Configure
custom-tools.shop with Vault pricing so players can buy 3×3 or auto-smelt pickaxes as upgrades.
- Protect vanilla worlds: Disable EzMine in non-prison worlds using
settings.worlds to keep survival areas untouched.
Sample rank setup
Three-tier mining progression
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:
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:
# settings.yml
settings:
profiles:
default: default
worlds:
world_nether: nether
regions:
world:
vip_mine: vip
# 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.
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:
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 <id> [player] or bundle them into starter kits.
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.
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? Join the EzPlugins Discord server for direct support and release updates.

评论 0
登录后参与评分
还没有评论,来抢沙发吧