PyroMinions

Bring automated helpers to your Minecraft server with customizable miner, fisher, and feeder minions.

Manage your minions through in-game menus, upgrade their abilities, choose their appearance, and control placement limits for players and islands.

Features

• Miner minions — Break configured blocks in front of them.
• Fisher minions — Produce fishing loot when placed near suitable water.
• Feeder minions — Restore nearby minions' health.
• Interactive menus — Manage feeding, upgrades, direction, chest links, names, skins, and holograms.
• Minion shop — Configure availability, starting levels, and prices for each minion type.
• Chest storage — Link miners and fishers to nearby chests to collect their output.
• 18 included skins — Textured heads and configurable leather armor colors, without a resource pack.
• Lifetime statistics — Track blocks mined, fish produced, and successful feedings.
• Placement limits — Set separate limits per player and per island.
• Permission-based limits — Grant permissions such as minion.max.3 to set a player's allowance. The highest granted numeric limit applies.
• SuperiorSkyblock2 integration — Island ownership and membership checks, shared island limits, and cleanup when an island is disbanded.
• Two languages — English and Turkish messages, menus, and command help.
• Configurable YAML files — Customize settings, prices, messages, menus, and appearances.
• Developer API — Modify or cancel fishing loot through FisherMinionFishEvent.

Compatibility

Supports Paper, Purpur, and Spigot, targeting these Minecraft version families:

| Minecraft | Required Java |
|---|---|
| 1.21.x | Java 21 |
| 26.1.x / 26.2.x | Java 25 |

Runtime checks have passed on Paper 1.21.11, Paper and Purpur 26.1.2 and 26.2, and Spigot 26.2.

Folia is not supported. Each dependency must also support your chosen server version.

Requirements

• Vault or VaultUnlocked
• A Vault-compatible economy provider, such as EssentialsX
• SuperiorSkyblock2 when island integration is enabled

To use PyroMinions without SuperiorSkyblock2, set require-island: false in config.yml. Island limits will then be disabled.

Installation

1. Stop your server.
2. Install the required dependencies.
3. Place PyroMinions-1.1.0.jar in your plugins folder.
4. Start the server to generate the configuration files.
5. Configure the plugin for your server.

When updating, replace the previous JAR while the server is stopped, then restart.

Language Selection

The default language is Turkish. To use English, set:

language: en

Use language: tr for Turkish. Apply language changes with /pma reload.

English translations can be customized in lang_en.yml; Turkish messages are in lang.yml.

Getting Started

1. Open /pm shop and purchase a minion.
2. Hold the minion item in your main hand and right-click the top of a solid block.
3. Right-click the placed minion to open its management menu.
4. Position miners facing suitable blocks and fishers facing suitable water.
5. Link miners and fishers to nearby chests through their menus.

Minions consume health while working. Feed them with cooked beef or use the menu's paid feeding option.

Commands

Player Commands

• /pm help — View player command help.
• /pm shop — Open the minion shop.

Administrator Commands

• /pma get <type> [level] [amount] — Receive minion items.
• /pma give <type> <player> [level] [amount] — Give minion items to an online player.
• /pma minions [player] — Open a minion list.
• /pma info <uuid> — View a minion's saved information.
• /pma remove [uuid] — Delete a minion without returning an item.
• /pma reload — Reload configuration, translations, menus, and minion definitions.
• /pma stats — View registered and loaded minion counts.

Available types: miner, fisher, and feeder.

Permissions

| Permission | Purpose |
|---|---|
| pyrominions.use | Basic minion access; enabled by default |
| pyrominions.shop | Shop access; enabled by default |
| minion.max.<number> | Set a player's personal minion limit |
| pyrominions.admin | Access administrator commands |
| pyrominions.admin.remove | Allow permanent minion removal |

Links

• Source Code
• Report an Issue

Created by pyroBuff.