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.