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.