MinionsPlus
A feature-rich, fully configurable minion companion plugin for Paper & Spigot 1.21
⚡ 11 Minion Types · AI Assistant · Upgrade Shop · Chest Linking · PlaceholderAPI · WorldGuard
✦ Overview
MinionsPlus brings a deep, satisfying minion system to your server. Place minions that mine ores, chop trees, farm crops, fish, sell items, and even fight by your side — all while you're offline. Every minion type is independently configurable, upgradeable through a clean GUI shop, and optionally constrained by WorldGuard regions.
Whether you're running a survival economy server, an SMP, or a custom gamemode, MinionsPlus slots in cleanly with Vault, EssentialsX, and PlaceholderAPI out of the box.
✦ Minion Types
✦ The Assistant — Your AI Companion
The Assistant is a fully animated armor-stand companion that follows you around the world and acts based on its current mode. Switch modes on the fly through the GUI or with /assistant mode <mode>.
The assistant animates leg and arm movements while walking, sits down when idle for too long, faces its current target, and equips the correct tool for whatever mode it's in.
Recall command: If your assistant wanders off while mining, /assistant summon teleports it back to you and resets it to DEFEND mode instantly.
✦ Upgrade Shop
Every minion has access to an in-game upgrade shop (accessible from the minion GUI). Upgrades are per-minion-type and cost economy currency.
Server owners can disable any upgrade, cap its maximum tier, and override costs entirely in upgrades.yml. Disabled upgrades vanish from the GUI automatically.
✦ GUI System
✦ Configuration
MinionsPlus ships with three layered config files:
✦ Permissions
minionsplus.use — Place and interact with minions (default: true)
minionsplus.admin — Admin commands: /minion give|list|reload (default: op)
minionsplus.admin.bypasslimit — Ignore placement limits (default: op)
minionsplus.admin.break — Break any player's minion (default: op)
minionsplus.minion.<type> — Place a specific type (all default: true)
Valid types: miner, slayer, collector, lumberjack, farmer,
feeder, fisher, seller, spawner, spawnerminer, assistant
minionsplus.limit.<n> — Override placement cap (highest wins)
Tiers: 3 (default true), 5, 10, 15, 20, 50
minionsplus.player.linkchest — Link chests to minions (default: true)
minionsplus.player.store — Access the upgrade shop (default: true)
minionsplus.player.rename — Rename minions (default: false)
✦ PlaceholderAPI
%minionsplus_count% — Total minions placed by the player
%minionsplus_max% — Player's effective placement limit
%minionsplus_<type>_count% — Placed count for a specific type
%minionsplus_<type>_limit% — Effective limit for a specific type
Types: miner, slayer, collector, lumberjack, farmer,
feeder, fisher, seller, spawner, spawner_miner, assistant
✦ Dependencies
✦ Commands
/minion give <player> <type> [level] — Give a minion item (admin)
/minion list — List all placed minions (admin)
/minion reload — Reload config.yml (admin)
/assistant summon — Recall assistant & reset to DEFEND
/assistant mode <DEFEND|SLAY|MINE|FARM|FISH> — Switch mode instantly
✦ Technical Details
A feature-rich, fully configurable minion companion plugin for Paper & Spigot 1.21
⚡ 11 Minion Types · AI Assistant · Upgrade Shop · Chest Linking · PlaceholderAPI · WorldGuard
✦ Overview
MinionsPlus brings a deep, satisfying minion system to your server. Place minions that mine ores, chop trees, farm crops, fish, sell items, and even fight by your side — all while you're offline. Every minion type is independently configurable, upgradeable through a clean GUI shop, and optionally constrained by WorldGuard regions.
Whether you're running a survival economy server, an SMP, or a custom gamemode, MinionsPlus slots in cleanly with Vault, EssentialsX, and PlaceholderAPI out of the box.
✦ Minion Types
| ⛏ Miner | Mines ore blocks in a configurable radius. Generates ores when none are nearby so it never sits idle. Supports Fortune and Silk Touch upgrades. |
| ⚔ Slayer | Spawns and kills a captive mob on a timer, collecting all drops into its inventory. Entity type is configurable per-server. |
| Collector | Vacuums dropped item entities from a wide radius into storage. Perfect paired with other minions or player farms. |
| Lumberjack | Chops logs in a radius and replants nothing (raw lumber collector). The Tree Feller upgrade fells entire trees in one swing. |
| Farmer | Harvests fully-grown crops and replants automatically. Features a unique Bonemeal Socket — insert bonemeal to force-grow immature crops and dramatically speed up the cycle. |
| Feeder | Keeps nearby players fed by restoring hunger and saturation. Optional Regeneration upgrade heals players too. |
| Fisher | Fishes adjacent water blocks on a timer. Weighted catch table (configurable). Luck of the Sea upgrade unlocks rare treasure catches. |
| Seller | Automatically sells items from a linked chest using EssentialsX worth prices (falls back to configurable price list). Deposits earnings directly to the owner's Vault balance. |
| Spawner | Periodically spawns configurable mob entities nearby. Max nearby entity cap prevents lag. Reinforced upgrade spawns stronger variant mobs. |
| Spawner Miner | Hunts for and collects SPAWNER blocks within reach — a powerful grinder companion for mob-farm builders. |
| Assistant | The flagship minion. A walking, animated AI companion with 5 switchable modes. See full section below. |
✦ The Assistant — Your AI Companion
The Assistant is a fully animated armor-stand companion that follows you around the world and acts based on its current mode. Switch modes on the fly through the GUI or with /assistant mode <mode>.
- DEFEND — Pursues hostile mobs within a configurable range, walks up to sword distance (≈3 blocks), and attacks them. Equips a diamond sword + shield. Supports Iron Fists (damage), Fire Aspect, Guardian (resistance aura), and Haste Aura upgrades.
- SLAY — Hunts and instantly kills any nearby mob, collecting drops into storage.
- MINE — Walks through the current chunk layer-by-layer, mining every solid block it can reach and collecting drops. Switches to a diamond pickaxe. Supports Fortune and Silk Touch.
- FARM — Follows you and harvests crops in a radius as you move through your fields.
- FISH — Casts at an adjacent water block and deposits catches into its inventory. Equips a fishing rod.
The assistant animates leg and arm movements while walking, sits down when idle for too long, faces its current target, and equips the correct tool for whatever mode it's in.
Recall command: If your assistant wanders off while mining, /assistant summon teleports it back to you and resets it to DEFEND mode instantly.
✦ Upgrade Shop
Every minion has access to an in-game upgrade shop (accessible from the minion GUI). Upgrades are per-minion-type and cost economy currency.
- Speed — Reduces action delay up to 50 % (Tier 3)
- Storage — Adds 9 inventory slots per tier
- Range — Extends action radius
- Fortune / Silk Touch — Mining drops
- Looting / Fire Aspect — Combat drops
- Luck of the Sea / Lure — Better fishing catches, faster bites
- Harvest Plus — Bonus crop drops per harvest
- Supercharge — Force-grows all nearby immature crops every tick
- Tree Feller — Fells entire trees in one chop
- Magnet — Triples Collector vacuum radius
- Regeneration — Feeder heals players with a Regen potion effect
- Reinforced — Spawner produces stronger mob variants
- Iron Fists — Boosts Assistant combat damage (up to +150 %)
- Guardian — Gives owner permanent Resistance II while nearby
- Haste Aura — Gives owner permanent Haste II while nearby
- Night Vision — Gives owner permanent Night Vision while nearby
Server owners can disable any upgrade, cap its maximum tier, and override costs entirely in upgrades.yml. Disabled upgrades vanish from the GUI automatically.
✦ GUI System
- 54-slot chest GUI per minion — shows type, level, mode, storage, and action buttons
- Level-up button with live cost display
- Chest-link button — click to enter linking mode, then click any chest to pair it
- Mode selector for Assistant minions (cycles DEFEND → SLAY → MINE → FARM → FISH)
- Bonemeal socket for Farmer minions — drag bonemeal in to fuel growth acceleration
- Upgrade Shop — paginated, shows current tier, next tier cost, and affordability highlight
- Collect-all button — instantly pulls all stored items into your inventory
✦ Configuration
MinionsPlus ships with three layered config files:
- config.yml — Global settings: placement caps, action delays, economy costs, particles, messages, assistant AI tuning, spawner defaults, fisher catch table, seller fallback prices
- minion-types.yml — Per-type overrides: enable/disable each type, custom display names, per-level delays and level-up costs, type-specific settings
- upgrades.yml — Per-upgrade control: enable/disable, max tier cap (1–3), and per-tier cost overrides
✦ Permissions
Code (Text):
minionsplus.use — Place and interact with minions (default: true)
minionsplus.admin — Admin commands: /minion give|list|reload (default: op)
minionsplus.admin.bypasslimit — Ignore placement limits (default: op)
minionsplus.admin.break — Break any player's minion (default: op)
minionsplus.minion.<type> — Place a specific type (all default: true)
Valid types: miner, slayer, collector, lumberjack, farmer,
feeder, fisher, seller, spawner, spawnerminer, assistant
minionsplus.limit.<n> — Override placement cap (highest wins)
Tiers: 3 (default true), 5, 10, 15, 20, 50
minionsplus.player.linkchest — Link chests to minions (default: true)
minionsplus.player.store — Access the upgrade shop (default: true)
minionsplus.player.rename — Rename minions (default: false)
Code (Text):
%minionsplus_count% — Total minions placed by the player
%minionsplus_max% — Player's effective placement limit
%minionsplus_<type>_count% — Placed count for a specific type
%minionsplus_<type>_limit% — Effective limit for a specific type
Types: miner, slayer, collector, lumberjack, farmer,
feeder, fisher, seller, spawner, spawner_miner, assistant
- Required: Vault — economy backend
- Optional: PlaceholderAPI — placeholders for scoreboards and chat
- Optional: EssentialsX — item worth prices for the Seller minion
- Optional: WorldGuard — prevents minions acting in protected regions
✦ Commands
Code (Text):
/minion give <player> <type> [level] — Give a minion item (admin)
/minion list — List all placed minions (admin)
/minion reload — Reload config.yml (admin)
/assistant summon — Recall assistant & reset to DEFEND
/assistant mode <DEFEND|SLAY|MINE|FARM|FISH> — Switch mode instantly
- Server: Paper / Spigot 1.21.1+
- Java: 21+
- Minion entities: Armor stands (no custom entities, no NMS)
- Persistence: YAML flat file — minion data survives restarts
- Anti-dupe: Per-item UUID stored in PersistentDataContainer — placing a duplicate item is blocked at the server level
- Performance: Batch tick scheduler with configurable period and WorldGuard region caching
- No packet libraries: Pure Bukkit/Paper API only
Found a bug or have a feature request? Open an issue or leave a review!
Thank you for using MinionsPlus!
Thank you for using MinionsPlus!
Resource Information
Author:
----------
Total Downloads: 16
First Release: May 11, 2026
Last Update: May 11, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings