MinerMinion 是一款允许玩家放置自动挖矿的 Minion 的 Minecraft 插件。玩家可以通过商店购买或者合成获取 Minion，Minion 需要食物作为能量来源，并且可以升级以解锁更多能力，例如冶炼和幸运。玩家还可以自定义 Minion 的名称和外观颜色。MinerMinion 易于放置和拾取，并且可以连接到箱子以存储挖到的资源。

MinerMinion

📌 插件特性

• Minion 商店：玩家可以在这里购买 Minion，商店价格可配置，支持物品、经验或货币支付。
• 可配置的合成配方：可以启用或禁用 Minion 的合成。
• 友好的 GUI 界面：方便玩家与 Minion 互动。
• 可定制的等级系统：最多可设置 21 个等级，并为 Minion 赋予冶炼、幸运等能力。
• 食物系统：可以自定义 Minion 的食物以及回复的饥饿值。
• 箱子连接：Minion 可以连接到箱子以存储挖到的方块。
• 世界禁用列表：可以在配置文件中设置禁用 Minion 的世界。
• 黑名单和白名单：可以设置允许 Minion 挖掘的方块类型。
• 控制台命令支持。
• 权限限制：可以通过权限设置玩家可以放置的 Minion 数量。
• 自定义名称：玩家可以使用命名牌自定义 Minion 的名称，支持颜色代码和格式。
• 自定义外观：玩家可以使用染料改变 Minion 的服装颜色。
• 初始配置：Minion 的初始饥饿度、等级、颜色等都可以配置。
• 个性化设置：玩家可以为每个 Minion 单独启用或禁用粒子效果、声音和对话文本。
• 多语言支持：所有消息和菜单都可以轻松翻译。
• 领地插件支持：支持 Vault, Lands, GriefPrevention, Residence 和 Towny。
• 空岛插件支持：BentoBox, ASkyblock, SuperiorSkyblock, FabledSkyBlock 和 IridiumSkyblock。
• WorldGuard 支持：支持 WorldGuard (v7)。(Necessary Flags without being the owner: build and interact.)

⌨️ 命令

Commands:
/aminion - Administrative command that can reload the configuration of the plugin and can also give users a minion.

Aliases: /adminminions

Arguments: <reload | give | get>
● reload: Reloads the configuration and messages of the plugin.
● get: Gives the player using the command a minion.
● give: Allows you to give a minion to another player.

/mstore - Grants access to the minion store.

Aliases: /minionstore, /mshop, /minionshop

🔑 权限

Permissions:
minerminion.minion-store - Grants access to the minion store with the /mstore command.

minerminion.aminion - Grants access to the administrative /aminion command.
minerminion.aminion.reload - Grants access to the reload option of the /aminion command.
minerminion.aminion.get - Grants access to the get option of the /aminion command.
minerminion.aminion.give - Grants access to the give option of the /aminion command.
minerminion.aminion.* - Full access to the /aminion command.

minerminion.admin.interact - Grants access to any main menu of a minion.

minerminion.blacklist-bypass - Allows a player to bypass the world blacklist in the configuration.

minerminion.max-minions.bypass - Allows a player to place minions even if the limit is reached.

minerminion.place - Allows players to place down minions, it is not required but can be negated.

minerminion.no-hunger - This permission will prevent minions to consume hunger.

⚙️ 配置文件 (config.yml)

# Settings for MinerMinion - v1.7
#
# Minions.current-id: Do not change this number, helps to keep track of each minion on the server.
#
# Minions.initial-level: The initial level that a minion will obtain when placed.
#
# Minions.initial-hunger: The initial level of hunger that a minion will obtain when placed.
#
# Minions.max-hunger: The maximum level of hunger that a minion can have.
#
# Minions.initial-color: Initial color that a minion will have, use the names of minecraft's dyes colors.
#
# Minions.item: The item that will represent the minion when picking it up.
#
# Minions.initial-holding-item: The item that the minion will hold while working. (Note: This is just for visualization, does not affect the minion performance.)
#
# Minions.sounds: Whether minions can make sounds or not. (Note: Players can also disable sounds for a specific minion if this option is set to true.)
#
# Minions.particles: Whether minions can display particles or not. (Note: Players can also disable particles for a specific minion if this option is set to true.)
#
# Minions.talk: Whether minions can talk or not. (Note: Players can also disable talking for a specific minion if this option is set to true.)
#
# Minions.radius: Players inside this radius will be able to hear the minion.
#
# Minions.needs-chest: Whether minions need to be linked to a chest or not to start working. (Note: If false, players can still link a chest if they want to but it is not necessary.)
#
# Minions.hunger-actions: This represents the number of blocks that the minion needs to mine so his hunger can decrease by 1.
#
# Minions.food: List of foods that a minion can eat along with the amount of hunger that they can restore. (Format: material_name:hunger | Note: You can find all material names on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
#
#
# Store.enable: Whether players can access the store to buy minions or not.
#
# Store.payment.currency.enable: If the minion store and upgrades charge money or not. (If true, Vault and an Economy plugin are necessary.
#
# Store.payment.currency.amount: Currency cost of each minion on the store.
#
# Store.payment.item.enable: If the minion store and upgrades charge a specific item or not.
#
# Store.payment.item.material: The material being charged at the store. (Note: You can find all material names on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
#
# Store.payment.item.amount: Amount of materials being charged at the store.
#
# Store.payment.xp.enable: If the minion store and upgrades charge xp.
#
# Store.payment.xp.amount: Amount of xp being charged at the store.
#
#
# GUI.open.sound: Name of the sound that is played when opening a menu. (Note: You can find all valid name sounds on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)
#
# GUI.open.volume: The volumen of the sound that is played when opening a menu.
#
# GUI.open.pitch: Pitch of the sound that is played when opening a menu.
#
#
# Minion.spawn.sound: Name of the sound that is played when placing a minion. (Note: You can find all valid name sounds on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)
#
# Minion.spawn.volume: The volume of the sound that is played when placing a minion.
#
# Minion.spawn.pitch: Pitch of the sound that is played when placing a minion.
#
#
# Minion.eat.sound: Name of the sound that is played when a minion eats. (Note: You can find all valid name sounds on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)
#
# Minion.eat.volume: The volume of the sound that is played when a minion eats.
#
# Minion.eat.pitch: Pitch of the sound that is played when a minion eats.
#
#
# Minion.upgrade.sound: Name of the sound that is played when a minion levels up. (Note: You can find all valid name sounds on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)
#
# Minion.upgrade.volume: The volume of the sound that is played when a minion levels up.
#
# Minion.upgrade.pitch: Pitch of the sound that is played when a minion levels up.
#
#
# Minion.working.sound: Name of the sound that is played sometimes when a minion is working. (Note: You can find all valid name sounds on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html)
#
# Minion.working.volume: Volume of the sound that is played when a minion is working.
#
# Minion.working.pitch: Pitch of the sound that is played when a minion is working.
#
#
# Recipe.enabled: Whether players can craft minions or not.
#
# Recipe.materials: List of materials used on the recipe along with their representative character. (Format: character:material_name | Note: You can find all material names on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
#
# Recipe.top: The three columns on the first row of a crafting table.
#
# Recipe.middle: The three columns on the second row of a crafting table.
#
# Recipe.bottom: The three columns on the third row of a crafting table.
#
#
# Player.max-minions.default: The default amount of minions that a player can place down.
#
# Player.max-minions.list: Permissions along with the maximum amount of minions it allows. (Format: permission:max_amount)
#
#
# Worlds.blacklist: List of worlds where players can not place minions.
#
#
# Ability.drilling.length: Length of blocks that a minion with the drilling ability can mine at once. (Caution: Big numbers will generate lag, Max recommended: 10)
#
#
# Blocks.blacklist.enabled: Whether the blacklist for blocks is enabled or not.
#
# Blocks.blacklist.contents: If the blacklist is enabled, all the blocks inside this list cannot be mined by the minion. (Note: You can find all material names on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
#
# Blocks.whitelist.enabled:  Whether the whitelist for blocks is enabled or not.
#
# Blocks.whitelist.contents: If the whitelist is enabled, all the blocks inside this list will be the only ones that a minion can mine. (Note: You can find all material names on here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html)
Ability:
  drilling:
    length: 5
Minions:
  current-id: 1
  initial-level: 1
  initial-hunger: 100
  max-hunger: 100
  initial-color: blue
  item: DRAGON_BREATH
  initial-holding-item: GOLDEN_PICKAXE
  sounds: true
  radius: 10
  particles: true
  talk: true
  needs-chest: true
  hunger-actions: 64
  food:
  - APPLE:5
  - GOLDEN_APPLE:10
  - ENCHANTED_GOLDEN_APPLE:100
Store:
  enable: true
  payment:
    currency:
      enable: true
      amount: 7000
    item:
      enable: false
      material: DIAMOND
      amount: 12
    xp:
      enable: false
      amount: 100
GUI:
  open:
    sound: BLOCK_NOTE_BLOCK_PLING
    volume: 1
    pitch: 1
Minion:
  spawn:
    sound: ENTITY_VILLAGER_HURT
    volume: 10
    pitch: 10
    particles: VILLAGER_ANGRY
  eat:
    sound: ENTITY_HORSE_EAT
    volume: 1
    pitch: 1
    particles: HEART
  upgrade:
    sound: ENTITY_HORSE_EAT
    volume: 9
    pitch: 9
    particles: VILLAGER_HAPPY
  working:
    sound: ENTITY_VILLAGER_HURT
    volume: 10
    pitch: 10
    particles: VILLAGER_ANGRY
Recipe:
  enabled: false
  top: awa
  middle: ang
  bottom: aba
  materials:
  - w:WITHER_SKELETON_SKULL
  - n:NETHER_STAR
  - g:GOLDEN_PICKAXE
  - b:GLASS_BOTTLE
  - a:AIR
Player:
  max-minions:
    default: 3
    list:
    - minerminion.place.vip:4
    - minerminion.place.donor:6
    - minerminion.place.staff:8
Worlds:
  blacklist:
  - myworld
  - myworld_nether
  - myworld_the_end
Blocks:
  blacklist:
    enabled: false
    contents:
    - BEDROCK
  whitelist:
    enabled: true
    contents:
    - COBBLESTONE
    - STONE
    - COAL_ORE
    - IRON_ORE
    - LAPIS_ORE
    - REDSTONE_ORE
    - GOLD_ORE
    - EMERALD_ORE
    - DIAMOND_ORE
    - COPPER_ORE
    - DEEPSLATE
    - DEEPSLATE_COAL_ORE
    - DEEPSLATE_COPPER_ORE
    - DEEPSLATE_DIAMOND_ORE
    - DEEPSLATE_EMERALD_ORE
    - DEEPSLATE_GOLD_ORE
    - DEEPSLATE_IRON_ORE
    - DEEPSLATE_LAPIS_ORE
    - DEEPSLATE_REDSTONE_ORE

💬 消息文件 (messages.yml)

# Messages:
Prefix: '&7[&8Miner&eMinion&7] '
Minions:
  item:
    name: '&8Miner &eMinion'
    description:
    - '&7Place this minion on'
    - '&7the ground and it will'
    - '&7start mining the block'
    - '&7in front of him.'
  minion:
    initial-name: '&eMiner Minion'
Commands:
  reload: '&7Plugin configuration and messages were reloaded.'
  user-only: '&7Only players inside the game can use this.'
  correct-usage: '&7Correct usage:'
  minion-added: '&7The minion was added to your inventory.'
  player-not-found: '&7Player not found.'
  not-enough-space-others: '&7That player does not have enough space in his inventory.'
  added-others: '&7A miner minion was added to their inventory.'
  received: '&7You have received a miner minion and was added to your inventory.'
  no-permissions: '&7You do not have permissions to use this command.'
GUI:
  close:
    title: '&7&lClose'
    description: '&7&oClick here to close the menu.'
  back:
    title: '&7&lGo Back'
    description: '&7&oClick here to go back to the main menu.'
  minion:
    title: '&5&lMinion Menu'
    stats:
      title: '&2Minion Statistics'
      description:
      - '&7Name: %MINION_NAME%'
      - '&7Owner: &c%MINION_OWNER%'
      - '&7Level: &e%MINION_LEVEL%'
      - '&7Total Blocks: &e%MINION_STATS%'
      - '&7Hunger: &e%MINION_HUNGER%/%MINION_MAX_HUNGER%'
      - '&7Color: &e%MINION_COLOR%'
    chest:
      title: '&eLinked Chest'
      description:
      - '&7Linked Chest: %MINION_CHEST_LINKED%'
      - '&7Location: &a%MINION_CHEST_LOC%'
      - ''
      - '&eClick here to link a chest.'
    upgrade:
      title: '&aUpgrade Minion'
      description:
      - '&7Current Level: &a%MINION_LEVEL%'
      - ''
      - '&eClick here to upgrade minion.'
      menu:
        title: '&a&lUpgrades Menu'
    pickup:
      title: '&9Pickup Minion'
      description:
      - '&eClick here to'
      - '&epick up this minion.'
    settings:
      title: '&d&lSettings'
      description:
      - '&eClick here to change'
      - 'ðe settings of this minion.'
      menu:
        title: '&5&lSettings Menu'
        particles:
          title: '&5&lDisplay Particles'
          description:
          - '&7&oMinion can display particles.'
          - ''
          - '&7State: &5%MINION_PARTICLES_STATE%'
          - ''
          - '&eClick here to %MINION_PARTICLES_STATE_ACTION%!'
        sounds:
          title: '&5&lMake Sounds'
          description:
          - '&7&oMinion can make sounds.'
          - ''
          - '&7State: &5%MINION_SOUNDS_STATE%'
          - ''
          - '&eClick here to %MINION_SOUNDS_STATE_ACTION%!'
        talk:
          title: '&eTalk to Players'
          description:
          - '&7&oMinion can talk to'
          - '&7&onearby players.'
          - ''
          - '&7State: &5%MINION_TALK_STATE%'
          - ''
          - '&eClick here to %MINION_TALK_STATE_ACTION%!'
        fortune:
          title: '&eFortune Ability'
          description:
          - '&7&oUse fortune ability.'
          - ''
          - '&7State: &5%MINION_FORTUNE_STATE%'
          - ''
          - '&eClick here to %MINION_FORTUNE_STATE_ACTION%!'
        smelting:
          title: '&eSmelting Ability'
          description:
          - '&7&oUse smelting ability.'
          - ''
          - '&7State: &5%MINION_SMELTING_STATE%'
          - ''
          - '&eClick here to %MINION_SMELTING_STATE_ACTION%!'
        silktouch:
          title: '&eSilktouch Ability'
          description:
          - '&7&oUse silktouch ability.'
          - ''
          - '&7State: &5%MINION_SILKTOUCH_STATE%'
          - ''
          - '&eClick here to %MINION_SILKTOUCH_STATE_ACTION%!'
        drilling:
          title: '&eDrilling Ability'
          description:
          - '&7&oUse drilling ability,'
          - '&7&owill mine %DRILLING_LENGTH% blocks at once.'
          - ''
          - '&7State: &5%MINION_DRILLING_STATE%'
          - ''
          - '&eClick here to %MINION_DRILLING_STATE_ACTION%!'
    upgrade-stats:
      title: '&2Minion Statistics'
      description:
      - '&7Name: %MINION_NAME%'
      - '&7Level: &e%MINION_LEVEL%'
      - '&7Speed: &c&e%MINION_SPEED% %MINION_SECONDS%'
      - ''
      - '&eAbilities:'
      - '&7Smelting: &e%MINION_SMELTING%'
      - '&7Fortune: &e%MINION_FORTUNE%'
      - '&7SilkTouch: &e%MINION_SILKTOUCH%'
      - '&7Drilling: &e%MINION_DRILLING%'
    level:
      title: '&6&lLevel: &a&l%LEVEL_LEVEL%'
      description:
      - '&7&m--------------'
      - '&5Details'
      - '&7Price: &a%LEVEL_PRICE%'
      - '&7Speed: &e%LEVEL_SPEED% %LEVEL_SECONDS%'
      - '&7&m--------------'
      - ''
      - '&7&m--------------'
      - '&5Abilities'
      - '&7Smelting: &e%LEVEL_SMELTING%'
      - '&7Fortune: &e%LEVEL_FORTUNE%'
      - '&7Silktouch: &e%LEVEL_SILKTOUCH%'
      - '&7Drilling: &e%LEVEL_DRILLING%'
      - '&7&m--------------'
      - ''
      - '%LEVEL_STATE%'
  store:
    title: '&6&lMinion Shop'
    miner:
      title: '&9&lMiner Minion'
      description:
      - '&7The miner minion will'
      - '&7mine any block that'
      - '&7is in front of him.'
      - ''
      - '&7Cost: &a%BUY_PRICE%'
      - '&7Level: &e%INITIAL_LEVEL%'
      - ''
      - '&bClick here to buy this minion!'
    buy: '&7You bought a minion for &e%BUY_PRICE%&7, the minion was added to your
      inventory.'
    no-money: '&7You don''t have enough money to buy that minion.'
    no-items: '&7You need &c%BUY_PRICE% &7in your inventory to buy that.'
    no-xp: '&7You need &c%BUY_PRICE% &7on you in order to buy that.'
    disabled: '&7The minion store is disabled.'
Player:
  not-enough-space: '&7You do not have enough space in your inventory.'
  max-minions: '&7You have reached the limit of minions that you can place.'
  no-permissions: '&7You do not have permissions to place minions.'
  place-minion: '&7You have placed the minion on the floor.'
  place-occupied: '&7You can not place this minion in this position since it is already
    occupied.'
  color-minion:
    dye: '&7You have dyed the clothes of this minion.'
    same-color: '&This minion already has that color on.'
  name-minion:
    change: '&7You have changed the name of this minion.'
    same-name: '&7That minion already has that name.'
  minion-removed: '&7The minion has been save on your inventory.'
  link-chest:
    cannot: '&7This chest is linked to a minion and can not be removed.'
    directions: '&7To link a chest with this minion, hit any chest while shifting.'
    linked: '&7You have successfully linked this chest with the minion.'
  minion-not-hungry: '&7This minion is not hungry at the moment.'
  minion-prohibited-world: '&7You can not place minions in this world.'
  needs-chest: '&7Now link a chest to the minion so he can start working.'
  protected-loc: '&7You cannot place down minion in this protected area.'
Error:
  food-list: There is an error on your food list, check your configuration file.
Others:
  xp: xp
  currency: $
  item:
    singular: Diamond
    plural: Diamonds
  free: Free
  'true': '&aTrue'
  'false': '&cFalse'
  na: '&4N/A'
  enable: enable
  disable: disable
  enabled: '&aEnabled'
  disabled: '&cDisabled'
  seconds: '&eseconds'
  second: '&esecond'
  'on': '&aOn'
  'off': '&cOff'
  basic-info:
  - '&m------------------'
  - '&7Owner: &c%MINION_OWNER%'
  - '&m------------------'
Color:
  black: Black
  red: Red
  green: Green
  brown: Brown
  blue: Blue
  purple: Purple
  cyan: Cyan
  ligh_gray: Light Gray
  gray: Gray
  pink: Pink
  lime: Lime
  yellow: Yellow
  ligh_bluew: Light Blue
  magenta: Magenta
  orange: Orange
  white: White
Level:
  owned: '&4&oOwned'
  instructions: '&e&oClick here to buy this level.'
  already-owned: '&7This minion already has this level.'
  bought: '&7You have bought level &e%LEVEL_LEVEL%&7.'
  cannot-buy: '&7You cannot buy this level, you need to buy all previous levels first.'
  payment:
    no-money: '&7You do not have enough money to buy this level.'
    no-items: '&7You need &c%LEVEL_PRICE% &7in your inventory to buy that.'
    no-xp: '&7You need &c%LEVEL_PRICE% &7on you in order to buy that.'
Server:
  incompatible: Server version not supported by the plugin.
Minion:
  spawn:
    text:
    - '&7I''m going to mine those blocks but you''ll have to pay me this time!'
    - '&7There''s not a day that I don''t work, give me a break!'
    - '&7Hey! What''s wrong? I was watching TV!'
  eat:
    text:
    - '&7I was very hungry, thank you!'
    - '&7Delicious!'
    - '&7I wanted a banana!'
  upgrade:
    text:
    - '&7Thanks for the upgrade!'
    - '&7Excellent, now I feel more skilled!'
    - '&7With this I will try to do a better job, thank you!'
  working:
    text:
    - '&7The fruits of labor are the sweetest of all pleasures.'
    - '&7The best remedy for all ills is work.'
    - '&7Work and work and more work!'

📈 等级文件 (levels.yml)

# Level Settings for MinerMinion - v1.7
#
# You can create up to 21 levels maximum.
#
# level: Numeric value of the level.
#
# seconds: Time in seconds that will take the minion to mine one block.
#
# Price: Price or amount (Depends on you configuration) that will be charge for buying the level.
#
# Fortune: Whether this level grants the fortune ability to the minion or not. If there are higher levels, they will have this ability.
#
# Smelting: Whether this level grants the smelting ability to the minion or not. If there are higher levels, they will have this ability.
#
# Silktouch: Whether this level grants the silktouch ability to the minion or not. If there are higher levels, they will have this ability.
#
# Drilling: Whether this level grants the drilling ability to the minion or not. If there are higher levels, they will have this ability.
#
# Level: Numeric value of the level.
Levels:
  '1':
    level: 1
    seconds: 6
    price: 0
    fortune: false
    smelting: false
    silktouch: false
    drilling: false
  '2':
    level: 2
    seconds: 4
    price: 5000
    fortune: false
    smelting: true
    silktouch: false
    drilling: false
  '3':
    level: 3
    seconds: 2
    price: 10000
    fortune: true
    smelting: true
    silktouch: false
    drilling: false
  '4':
    level: 4
    seconds: 2
    price: 15000
    fortune: true
    smelting: true
    silktouch: false
    drilling: true

🤝 服务器展示

如果你使用了本插件并希望在此展示你的服务器，请发送私信。

• catbugempire.apexmc.co

🚀 未来计划

• 添加新的 Minion 能力 (v1.3)
• 支持空岛插件 (v1.2)

❤️ 感谢

本插件旨在为最新的 Minecraft 版本提供一个免费且完全可定制的 Minion 插件。欢迎提出任何功能需求或插件兼容性需求。这是一个正在进行中的项目，可能会存在 Bug。欢迎提出任何建议、反馈和报告。感谢你使用我的插件。