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.
Supports WorldGuard (v7). (Necessary Flags without being the owner: build and interact.)
Code (Text):
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
Code (Text):
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.
Code (Text):
# 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
Code (Text):
# 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!'
Code (Text):
# 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
If you use this plugin and want your server to be showcased here, send me a private message.
catbugempire.apexmc.co
Add new minion abilities. (v1.3)
Support Skyblock plugins. (v1.2)
This plugin was created with the intention of having a working and fully customizable minion plugin for the latest Minecraft versions and for free of course. Please let me know if you want any features, or you need other plugin support to be added to the plugin. This is a work in progress, please expect bugs.
Any kind of suggestions, feedback, and reports are appreciated. Thank you again for using my plugin.