EzMine

插件

· 作者 Shadow48402

奖励玩家挖矿等级、更智能的矿石掉落、经验加成和自定义镐子。

0 本站下载 0 关注 更新于 5 个月前

最新 2.0.1 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

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 进阶。

快速开始

  1. 将 EzMine.jar 放入服务器的 plugins 文件夹并重启。
  2. 使用 LuckPerms、PermissionsEx 或您喜欢的管理插件 分配权限。
  3. 根据您的等级顺序、追踪方块和熔炼偏好 调整 config.yml。
  4. 运行 /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 作为你的监狱矿坑进度系统的核心,无需重写整个经济系统。

  1. 定义矿坑世界和区域:通过 settings.profiles.worlds 或 settings.profiles.regions 将每个矿坑映射到对应的配置文件中,以便每个矿坑都能拥有独立的权限加成和倍率。
  2. 创建等级阶梯:设置 settings.rank-order 以匹配你的监狱等级(A → Z 等)。分配相应的权限,如 ezmine.rank.block_a、ezmine.rank.block_b 等。
  3. 调整收益:使用 drop-multiplier 和 experience-multiplier 来控制矿石产出和经验值。结合自动熔炼功能,使掉落物与你的经济定价相匹配。
  4. 控制幸运值:在低级阶段禁用幸运附魔以减缓进度,然后在更高等级时启用它。
  5. 提供高级工具:通过 Vault 定价配置 custom-tools.shop,让玩家购买 3×3 范围或带自动熔炼功能的镐子作为升级道具。
  6. 保护原版世界:在非监狱世界中禁用 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 服务器 获取直接支持与版本更新。

尝试 EzPlugins 系列中的其他 Minecraft 插件

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源