Introduction

SoapsAdmin is a Paper 1.21+ admin plugin. One install covers moderation, economy, teleport, spawners, recipes, GUIs, and day-to-day staff tools.

Current version: 1.7.0

What It Covers

Area	Included features
Moderation	Kick, ban, mute, warn, freeze, jail, reports, tickets, quick punish, audit/rollback, alts
Staff tools	Vanish, staff mode, spectate, command/social spy, playerinfo hub, staff dashboard
Economy	Multi-currency, Vault bridge, shop, daily rewards, Mythic mob drops (item or direct)
Content tools	Kits (preview), custom recipes, Crucible/Mythic items, item editor, mannequins (presets + equipment)
Spawners	Dedicated module: GUI editor, vanilla/Mythic types, FX, kill budget (off = pure vanilla)
Teleportation	Homes, warps, spawn, TPA (cancel/auto), RTP, jump, offline TP, world manager
Player utilities	Friends, nicknames/realname, trade, mail, vaults, sit/spin, filter, autopickup, autosell
Messaging	Staff chat, PMs, filter, spam, slowmode, join/death messages, announcements
Server ops	Backups, clearlag, plugin monitor, performance scans, mining/xray audit, MOTD
GUIs	Admin dashboard, player hub, system-gui skins, animated daily boards

Architecture

SoapsAdmin depends on SoapsCommon for shared GUI rendering, MiniMessage helpers, and startup checks. Feature code is split into modules defined in modules.yml (including the dedicated spawner module). Disabled modules skip their commands and listeners.

Optional soft bridges (no hard compile dependency):

• MythicMobs — Mythic spawner types, mob identity for economy drops
• MythicCrucible — crucible:ItemId in the recipe system
• Citizens — treated as custom mobs for drop rules
• Vault / PlaceholderAPI — economy bridge and placeholders

Player data, punishments, economy balances, homes, warps, and audit entries are stored through a unified storage layer (flatfile, sqlite, or mysql) configured in config.yml.

Single Command Tree

Almost everything runs through /sa <subcommand>. This keeps permissions centralized and makes /sa help a live reference for what each rank can use.

Custom commands in customcommands.yml can add new aliases or override built-in subcommands with scripted behavior.

Key systems (1.6.x)

System	What it does
Item editor + mannequins	Create and display custom items (Paper)
Spawner editor	Vanilla/Mythic types, FX, kill budgets
Recipe wizard	Custom crafts including Crucible items
Playerinfo + audit/rollback	Staff inspection and case undo
Multi-currency economy	Per-MythicMob drop tables (item or direct)
Animated GUIs	Daily rewards, events board, player hub

What SoapsAdmin Is Not

• It is not a permissions plugin. Use LuckPerms or similar for rank setup.
• It is not a region protection plugin. Use WorldGuard or similar for build protection.
• Planned commands listed in internal roadmaps are not shipped until they appear in /sa help and this wiki.

Next Steps

1. Getting Started for install steps
2. Comparison if you are coming from EssentialsX or CMI
3. Modules for enabling or disabling feature modules
4. Configuration for file layout
5. Commands Index for the full command list
6. Integrations for soft bridges (Vault, PAPI, Mythic, Crucible)