Hype Minions
Skyblock-style placeable minions that automatically gather resources for you. Inspired by classic minion mechanics. Give yourself a minion item, right-click a block to place it, and the minion sits there producing its resource into its own storage on a timer - faster and with more capacity as you upgrade it.
What it does
- A minion is a small, invulnerable, clickable ArmorStand wearing a themed head with a floating name like
Iron Minion V.
- On a per-tier interval it produces its configured item into an internal storage, with a little arm swing and particle each time.
- When its storage fills up it stops producing, and resumes as soon as you empty it.
- It keeps working while you are away: production is time-based, so when the chunk loads again (or the server comes back up) the minion is credited for the elapsed time, capped by how much storage it had free.
Server-safe by design
By default minions do not dig or place real blocks. They produce the output item straight into storage (place-blocks: false). This is a deliberate simplification of the original idea so the plugin stays TPS-friendly and never touches the world, your protections, or your terrain.
Placing, using, and picking up
- Get a minion item with
/minion give <player> <type> [tier] (admin).
- Right-click a block with the minion item to place it on top. One item is consumed (not in creative).
- Right-click the minion to open its management GUI.
- Sneak + right-click the minion to pick it up - you get back the item (with its tier), its fuel, its modules, and everything in storage.
The GUI
| Element |
What it does |
| Storage area |
Mirrors the minion's storage. Click a stack to collect it. Locked panes are capacity not yet unlocked. |
| Collect All (hopper) |
Moves everything that fits into your inventory. |
| Fuel slot |
Drop in the configured fuel item for a speed boost while it lasts. |
| Module slots x2 |
Install Auto-Smelt (smelts ore/raw output) or Compactor (packs output into blocks). |
| Upgrade (anvil) |
Pay the listed cost to raise the tier (faster + more storage). |
| Info (paper) |
Shows type, tier, slots, interval, fuel state, owner. |
Commands
All under /minion (alias /minions).
| Command |
Description |
/minion give <player> <type> [tier] |
Give a placeable minion item. (admin) |
/minion list |
List your placed minions and where they are. |
/minion info |
Plugin info, type/tier list, and your minion count. |
/minion reload |
Reload config.yml. (admin) |
Tab completion is provided for subcommands, online players, types, and tiers.
Permissions
| Permission |
Default |
Grants |
minion.use |
everyone |
Place, open, upgrade, and pick up your own minions. |
minion.admin |
op |
give and reload, plus open/pick up any minion. |
With owner-only: true (default), only the owner, an op, or minion.admin may open or pick up a given minion.
Types and tiers
Shipped types: Cobblestone, Coal, Iron, Gold, Diamond, Redstone, Lapis, Emerald, Wheat. Each defines its output item, amount, base interval, and head skin.
Tiers I through XI. Higher tiers act faster (lower interval) and hold more. Each tier has an upgrade cost; XI is the cap. All configurable in config.yml.
Configuration
Everything is tunable in config.yml: production interval and storage per tier, upgrade costs, fuel (item, speed boost, run-time per unit), the Auto-Smelt and Compactor module maps, per-chunk and per-player caps, owner-only, particles, and the full list of minion types. Invalid entries are logged and skipped rather than aborting the load.
Known gaps
place-blocks is a stub. Terrain editing is intentionally not implemented; minions produce into storage (server-safe, never touches your world or protections).
- Head skins use the Bukkit SkullMeta API; on offline-mode servers without skin resolution, heads may render as the default skin (the minion still works).
- The storage grid is collection-only - you take items out (click a stack or Collect All); you cannot deposit items into a minion.
Compatibility
Paper / Spigot / Bukkit / Purpur, Minecraft 1.21.1-1.21.11. One jar, built against the 1.21.1 API (Java 21, class 65), load-tested on Paper 1.21.11; no Paper-only classes, no NMS, no dependencies.
Original concept by u/hykeemssecondphone on Reddit (r/Minecraft). Built by BeansNToast.