Introduction

SoapsAdmin is a Paper and Spigot 26.2 admin plugin (Paper recommended; Folia not supported). One install covers moderation, economy, teleport, spawners, recipes, GUIs, and day-to-day staff tools.

Current version: 1.7.2

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, player info, staff dashboard
Economy	Multi-currency, Vault bridge, shop, cheques, daily rewards, Mythic mob drops (item or direct)
Content tools	Kits (preview), custom recipes, Crucible/Mythic items, item editor, mannequins (presets + equipment). Item editor and mannequins need Paper.
Spawners	Dedicated module: GUI editor, vanilla/Mythic types, FX, kill budget (off = pure vanilla)
Teleportation	Homes, warps, server spawn, world spawn, TPA, RTP (loads unloaded chunks), random player TP, jump, offline TP, world manager
Player utilities	Friends, nicknames/realname, trade, mail, vaults, sit/spin, filter, autopickup, autosell
Messaging	Staff chat, mutechat, chat rooms, PMs, filter, spam, slowmode, join/death messages, announcements
Server ops	Backups, clearlag, unloadchunks, plugin monitor, gamerules GUI, performance scans, mining/xray audit, MOTD (min/max players)
GUIs	Admin dashboard, player dashboard, 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> by default (aliases: /soapsadmin, /sadmin). That keeps permissions centralized and makes /sa help a live reference for what each rank can use.

customcommands.yml can register top-level names (/home, /spawn), wrap or replace built-ins, and disable commands. Interactive binds: /sa interactive.

Key systems (1.7.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 + cheques	Per-MythicMob drop tables; physical cheques
RTP	Async (Paper) / sync (Spigot) chunk preload before teleport
Animated GUIs	Daily rewards, events board, player dashboard

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. Modules to enable what you need
3. Comparison if migrating from EssentialsX / CMI
4. Configuration for file layout
5. Commands Index for the full command list
6. Integrations for Paper vs Spigot and soft bridges