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

Commands

All under /minion (alias /minions).

Tab completion is provided for subcommands, online players, types, and tiers.

Permissions

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.