SoapsAdmin Wiki

Last updated Sep 18, 2026

SoapsAdmin is the main administration plugin for SoapsUniverse servers. It covers moderation, economy, teleportation, kits, GUIs, custom commands, Mythic/Crucible hooks, and player utilities under one /sa command tree.

Version 1.7.2

Quick Links

Page	Description
Introduction	What SoapsAdmin does and what you need to run it
Getting Started	Install, first boot, and verify
Comparison	EssentialsX / CMI / SoapsAdmin feature map
Modules	Enable or disable feature groups
Configuration	How config files fit together
Commands Index	Full command list with categories
Commands: Player	Homes, warps, social, mail, QoL
Commands: Moderation	Ban, mute, warn, jail, audit
Commands: Staff	Vanish, staff mode, playerinfo, spawners
Commands: Economy	Balance, pay, shop
Commands: Admin	Reload, recipes, item editor, diagnostics
GUIs and Menus	Dashboards, custom menus, animations
Moderation	Punishments, reports, escalation
Economy and Shop	Multi-currency, cheques, Mythic drops, shop
Spawners	Spawner editor, MythicMobs filter, kill budget
Recipes and Crucible	Custom recipes + Crucible/Mythic items
Item Editor	Paper item editor GUI and templates
Fake Players	Paper mannequins, presets, equipment editor
Mail and Player Info	Offline mail + staff player info
Chat and Messaging	Filter, PM, staff chat, mutechat, chat rooms
Custom Commands	Aliases, overrides, interactive binds, blocked commands
Player Vaults	Extra storage, vault autopickup, admin tools
Teleportation	Homes, warps, TPA, server vs world spawn, RTP (chunk preload), world manager
Permissions	Permission nodes reference
Placeholders	PlaceholderAPI expansion
Integrations	Paper/Spigot, SoapsCommon, Vault, PAPI, Mythic, Crucible
Default Config Files	Bundled YAML reference
Examples	Common server owner setups
FAQ	Troubleshooting
Changelog	Version history

Requirements

Requirement	Details
Plugins	SoapsCommon
Server	Paper 26.2
Spigot	26.2
Folia	Not supported
Java	21+
Tested on	Paper 26.2, Java 25

Paper recommended for item editor, mannequins, and async RTP. Paper-only modules auto-disable on Spigot. See Integrations.

Optional

Integration	Purpose
Vault	Economy bridge
PlaceholderAPI	Placeholders
MythicMobs	Mythic spawners + mob drops
MythicCrucible	Crucible items in recipes
Citizens	Custom-mob drop detection

Command Aliases

The root command is /sa. Aliases: /soapsadmin, /sadmin.

Many subcommands can be registered as top-level commands when customcommands.yml has register-all-commands: true.