Sueta

MinerMinion [1.8.8 - 1.21.10]

2.0

The miner minions collect resources by mining on their own.

·Plugin


The miner minions help players to collect resources by mining on their own. They can be obtained by visiting the minion store or by crafting them if enabled on the configuration. These minions can mine certain blocks or any of them, you decide. Minions use food as their energy resource, foods can be completely customized. They can also be upgraded, they follow a level system which can be totally configured, you can also create up to 21 levels and enable abilities such as smelting and fortune. Players can also customize their minion, they can change the name with a tag or change the color of their clothes with dyes. Minions are easy to place down and pick up, and they can also be linked to chests for storing.

  • A minion store where players can buy their minions.
  • Configurable price, you can charge items, XP or money.
  • Configurable crafting recipe which can be enabled or disabled.
  • Easy and understandable GUI to interact with minions.
  • A total customizable level system which can contain up to 21 levels and enable abilities such as smelting and fortune.
  • You are able to customize the food along with the hunger value that they restore.
  • You can link minions to a chest so they can store the mined blocks.
  • Configurable world name list to disable the usage of minions in certain worlds.
  • Configurable blacklist and whitelist of blocks to allow minions to mine certain blocks or any of them.
  • Console commands supported.
  • You can set the limit of minions placed with permissions.
  • Players can customize the name of their minion with name tags. Color codes and formats are supported. They just have to shift and right-click the minion with the tag to change it.
  • The player can change the minion's clothes color with dyes, they just have to shift and right-click the minion.
  • Initial hunger, level, color, and any aspect of the minion can be configured.
  • Configurable settings per minion, players can enable or disable particles, sounds, and dialog texts that minions have.
  • All messages and menus can be easily translated.
  • Vault, Lands, GriefPrevention, Residence and Towny support.
  • BentoBox, ASkyblock, SuperiorSkyblock, FabledSkyBlock and IridiumSkyblock support.
  • Supports WorldGuard (v7). (Necessary Flags without being the owner: build and interact.)

Commands
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
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

Similar projects

Plugin →