PerfMinions - 9 Minions, Skins, Shop GUI v1.0.23

PerfMinions
Armor-stand minions that farm, mine, craft, sell, and more. GUIs, optional fuel, linked chests, permission limits, and staff tools. Paper and Folia 1.21 - 26.x

Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa

Features
• Folia support – Runs on Folia-supported Paper builds; scheduling follows region-safe patterns where applicable
• Nine minion types – Farmer, fisher, miner, lumber, slayer, collector, crafter, seller, and smelter (each configurable under minions/*.yml)
• Placement and limits – Per-player caps (default + perfminions.limit.number), optional per-type place permissions, per-chunk caps, and world whitelist/blacklist modes
• GUIs and hub – Main menu, per-minion inventory, optional minion list GUI, and configurable shops for minions, skins, and boosts (Vault, PlayerPoints, or ExcellentEconomy per shop)
• Fuel and upgrades – Optional charge system with configurable items and economy cost; level upgrades with action requirements and sounds
• Tools and storage – Per-type tools, optional durability and chest-fed tool refill, enchant capping for drops, and chest linking within a configurable range
• Holograms – Vanilla TextDisplay above minions (style: none, warnings, or always) with LOD and update tuning
• Performance controls – Batch saves, tick sharding, optional global work-action cap, TPS-based safe-mode range penalty, and optional “player nearby” idle gating
• Owner and bypass – Optional owner-only GUI and pickup; bypass permissions for staff break, GUI, and SuperiorSkyblock checks
• WorldGuard – Optional StateFlag gate so minions only work where regions allow (configurable flag name, fail-open option)
• SuperiorSkyblock2 – Optional island privilege checks for minion work, placement, chest linking, and pickup (configurable privilege, wilderness behavior, fail-open)
• Seller economy – Vault payouts with optional tax to a bank UUID; sell prices can pull from ShopGUI+, EconomyShopGUI, or YAML fallbacks
• Migrations and backups – Import from AxMinions (H2) or JetsMinions; copy SQLite to MySQL; export/import player minions and full-server CSV backups
• Logging and admin tools – In-memory minion action logs, /perfminions timings sampling, and per-world pause/resume for minion work

Placeholders
%perfminions_count% – Number of minions the player has placed (alias: minions_count)
%perfminions_limit% – Effective minion cap for an online player (alias: minions_limit)
%perfminions_actions% – Sum of total actions across the player’s minions (alias: total_actions)
%perfminions_total% – Total minions loaded on the server (also when the offline context has no player)
%perfminions_ticking% – Minions currently ticking on the server (also when the offline context has no player)

Commands
/minions – Open the minions hub menu (perfminions.use)
/minions list – Open your placed minions list (when enabled in config) (perfminions.use)
/perfminions reload – Reload configs, messages, GUIs, and cached settings (perfminions.admin.reload)
/perfminions give (player) (type) [level] – Give a minion item of (type) at [level] to an online player (perfminions.admin.give)
/perfminions give (player) skin (skin_key) [amount] – Give skin applicator items (perfminions.admin.give)
/perfminions reset (player) – Remove all placed minions for an online player (perfminions.admin.reset.others)
/perfminions stats – Show total, ticking, and idle minion counts (perfminions.admin.stats)
/perfminions logs [player] [limit] – Print recent minion logs, optional player filter and limit (perfminions.admin.logs)
/perfminions export (player|all) – Export one player’s minions or a full CSV backup (perfminions.admin.export)
/perfminions import (player) – Import from that player’s export file (perfminions.admin.import)
/perfminions import all [filename] – Import a full backup CSV (optional filename) (perfminions.admin.import)
/perfminions minions list (player) – Open admin minion list for a player (player-only sender) (perfminions.admin.minions)
/perfminions migrate axminions [tools] – Import from AxMinions data or sync tools only with [tools] (perfminions.admin.migrate)
/perfminions migrate sqlite-mysql [replace] – Copy SQLite rows into MySQL (optional replace) (perfminions.admin.migrate)
/perfminions migrate jetsminions – Import from JetsMinions player data (perfminions.admin.migrate)
/perfminions timings [ticks] – Sample minion tick cost for [ticks] server ticks (perfminions.admin.timings)
/perfminions world list – List worlds where minion work is paused (perfminions.admin.world)
/perfminions world pause (world) – Pause minion work in (world) (perfminions.admin.world)
/perfminions world resume (world) – Resume minion work in (world) (perfminions.admin.world)
/perfminions help – Show command usage (perfminions.admin.help)

Database
• SQLite
• MySQL