Summary (short description field)

Skyblock-style minions that mine for you — feed them, chest-link them, buy them in a shop, and build brand-new minion types entirely in game.

---

Description (project body)

Minions

Place a little worker, keep it fed, get rich. Minions are small, invulnerable armor-stand workers that place and mine their own resource field, dropping everything into a linked chest or their internal storage. They keep working while you're away — but they run on energy, so somebody (you, or a Feeder minion) has to keep them fed.

Features

Energy

Every minion has an energy pool and stops working when it hits zero. Refill it by:

• Right-clicking with food — cooked beef, apples, bread (fully configurable, any item can be a food)
• A Feeder minion — feeds every hungry minion in its radius from its own linked chest
• Money — one button in the minion's menu recharges it via your economy (prorated by default)

The floating nametag shows a color-coded bolt: 🟢 above half, 🟡 below half, 🔴 empty. Nametags only appear while you're actually looking at the minion (toggleable).

Feeder minions

A support minion that automates the feeding loop: link it to a chest full of food and it keeps every minion in range topped up, hungriest first. You maintain the feeders, the feeders maintain the miners.

Chest linking

Link any minion to a nearby chest straight from its menu — click an existing chest or just place one down. Miners deposit their output there (internal storage as fallback); feeders pull food from it. Unlink and rotate the minion from the same menu.

⬆ Levels

Three levels per minion (add more in config). Upgrades cost money and raise energy capacity, mining field size (3×3 → 5×5 → 7×7), speed, and storage. Feeders grow their feeding radius instead.

Shop

/minion shop — a GUI where players buy minions with money. Prices per type, editable live from an in-game editor.

Limits built for Skyblock

• Per-player caps per category (miners / feeders), overridable per rank via permissions (minion.limit.miner.5, .unlimited)
• SuperiorSkyblock2 integration: max minions per island
• Radius-based area cap as fallback on non-island servers, plus a per-chunk cap

Create minion types in game

/minion admin → Minion Types opens a full type builder: pick the head (any block works — or a player head for its skin), the output item, work block, tool, speed, amount, category, and shop price. Save and it's live instantly — no restart, no config editing. Existing placed minions re-skin on the spot.

Rearrange the menus themselves

/minion admin → GUI Layouts opens a drag-and-drop layout editor for the plugin's menus: move buttons, paint gray/black filler glass, add/remove rows, rename titles. Stored in guis.yml.

Modules

Drop a Furnace (Auto-Smelt) or Piston (Compactor, 9→1 blocks) into a miner's module slots.

⚙ Configuration

Everything is a knob. config.yml is organized into nine documented sections (energy, foods, prices, levels, limits, sounds, particles, per-type overrides like custom energy costs and disable flags). messages.yml externalizes every player-facing string with & and hex color support — fully translatable. Common settings are also editable live in /minion admin.

Commands

Command	Description
/minion give <player> <type> [level]	Give a placeable minion item (admin)
/minion list	List your placed minions with energy state
/minion info	Plugin info and your minion counts
/minion shop	Buy minions with money
/minion admin	Live settings, type builder, shop prices, GUI layout editor (admin)
/minion reload	Reload all config files (admin)

Permissions

Permission	Default	Grants
minion.use	everyone	Place, open, feed, upgrade, pick up your own minions
minion.shop	everyone	Use /minion shop
minion.admin	op	Everything, including any minion and all editors
minion.limit.<miner|feeder>.<n>	—	Raise a rank's placement cap (highest wins; .unlimited removes it)

Requirements & compatibility

• Paper 1.21+ (built against 1.21.x API, TPS-friendly — no block updates on production, one lightweight scheduler task)
• Optional: Vault + any economy (e.g. EssentialsX) — enables the shop, money refills, and money upgrades. Without it, those features disable gracefully and everything else works.
• Optional: SuperiorSkyblock2 — enables per-island limits. Without it, a radius-based cap takes over.

Drop the jar in plugins/, restart, done — all config files generate themselves.