MinerMinion - 矿工助手

矿工助手（MinerMinion）是一款帮助玩家自动采集资源的插件。这些助手可以自行挖掘方块，玩家可以通过商店购买或合成（若配置允许）来获得它们。助手以食物为能量来源，可升级至多21个等级，并解锁诸如自动熔炼、时运等能力。玩家还能自定义助手的名字和服装颜色，操作简单直观。

💡核心特性

矿工助手具备以下主要功能

• 一个可供玩家购买助手的商店。
• 可配置的价格系统，支持收取物品、经验或游戏货币。
• 可启用或禁用的合成配方。
• 易于理解和操作的GUI界面，用于与助手交互。
• 完全可自定义的等级系统，最多支持21级，并可启用熔炼、时运等能力。
• 可自定义助手食用的食物及其恢复的饱食度。
• 可将助手链接到箱子，以便存储挖掘到的方块。
• 可配置世界黑名单，以禁止在特定世界使用助手。
• 可配置方块黑名单/白名单，以限制或允许助手挖掘特定方块。
• 支持控制台命令。
• 可通过权限设置玩家可放置的助手数量上限。
• 玩家可使用命名牌自定义助手名字（支持颜色代码和格式），只需潜行并右键点击助手即可。
• 玩家可使用染料改变助手的服装颜色，只需潜行并右键点击助手。
• 助手的初始饱食度、等级、颜色等所有方面均可配置。
• 可按助手配置设置，玩家可单独启用或禁用粒子效果、声音和对话文本。
• 所有消息和菜单均可轻松翻译。

🎮依赖与兼容性

必要依赖

• Vault (当商店或升级需要收费时必需)

领地保护兼容

插件与以下领地保护插件兼容

• Lands
• GriefPrevention
• Residence
• Towny
• WorldGuard (v7) (需要区域所有者或拥有 build 和 interact 权限)

空岛插件兼容

插件支持以下空岛插件

• BentoBox
• ASkyblock
• SuperiorSkyblock
• FabledSkyBlock
• IridiumSkyblock

🔧命令

/aminion

管理员命令，可重载插件配置或给予玩家助手。

• 别名: /adminminions
• 参数: <reload | give | get>

- `reload`: 重载插件的配置和消息文件。

- `get`: 给使用命令的玩家一个助手。

- `give`: 给其他玩家一个助手。

/mstore

打开矿工助手商店。

• 别名: /minionstore, /mshop, /minionshop

✨权限

• minerminion.minion-store - 允许使用 /mstore 命令访问助手商店。
• minerminion.aminion - 允许使用管理员命令 /aminion。
• minerminion.aminion.reload - 允许使用 /aminion 命令的 reload 选项。
• minerminion.aminion.get - 允许使用 /aminion 命令的 get 选项。
• minerminion.aminion.give - 允许使用 /aminion 命令的 give 选项。
• minerminion.aminion.* - 授予 /aminion 命令的所有权限。
• minerminion.admin.interact - 允许访问任何助手的主菜单。
• minerminion.blacklist-bypass - 允许玩家绕过配置中的世界黑名单。
• minerminion.max-minions.bypass - 允许玩家在达到放置上限后继续放置助手。
• minerminion.place - 允许玩家放置助手（非必需，但可被否定）。
• minerminion.no-hunger - 拥有此权限的玩家的助手将不会消耗饱食度。

⭐配置文件摘要

主要配置文件为 config.yml、messages.yml 和 levels.yml。

config.yml 要点

• Minions: 配置助手的基础属性，如初始等级、饱食度、颜色、手持物品、声音、粒子效果、对话、工作半径、是否需要箱子、食物列表等。
• Store: 配置商店是否启用，以及支付方式（货币、物品、经验）。
• GUI & Minion Sounds: 配置各种GUI和助手动作的音效与粒子效果。
• Recipe: 配置合成配方是否启用及合成表。
• Player.max-minions: 配置玩家可放置助手的默认上限及通过权限增加的额度。
• Worlds.blacklist: 列出禁止放置助手的世界。
• Blocks: 配置方块的黑名单或白名单，控制助手可挖掘的方块。

levels.yml 要点

• 最多可创建21个等级。
• 每个等级可配置：等级数字、挖掘一个方块所需时间（秒）、升级价格、以及是否解锁时运(Fortune)、熔炼(Smelting)、精准采集(Silktouch)、连锁挖掘(Drilling) 能力。

messages.yml 要点

• 包含插件所有GUI界面文本、提示消息、对话的翻译与自定义设置。
• 支持修改前缀、助手物品描述、各种状态信息等。

❓使用与提示

如何获得助手？

• 在配置启用商店的情况下，使用 /mstore 命令购买。
• 在配置启用合成的情况下，使用指定配方合成。

如何与助手交互？

• 放置与拾取：手持助手物品右键放置；潜行右键助手可拾起。
• 打开菜单：右键点击已放置的助手。
• 链接箱子：在助手菜单中点击链接，或潜行状态下右键点击箱子。
• 重命名：潜行状态下，手持命名牌右键点击助手。
• 更换颜色：潜行状态下，手持染料右键点击助手。

注意事项

• 确保在需要经济系统时安装 Vault 和经济插件。
• 使用 WorldGuard 时，请注意在非本人领地内需要 build 和 interact 权限。
• 配置 levels.yml 时，高级别将继承低级别已开启的能力。
• 连锁挖掘(Drilling)的长度不宜设置过大（建议最大10），以免造成服务器卡顿。

---

作者留言：此插件旨在为最新版Minecraft提供一个功能完善、高度可自定义的免费助手插件。如果您有任何功能建议、需要其他插件支持或发现了问题，欢迎反馈。感谢使用！

支持与反馈：如有需要，可通过Discord获取支持。

服务器展示：如果您使用了本插件并希望您的服务器在此展示，请私信作者。

示例服务器：catbugempire.apexmc.co