SoapsAdmin Wiki

Last updated Jul 27, 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.0

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, 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 hub
Chat and Messaging	Filter, PM, staff chat
Custom Commands	Aliases, overrides, blocked commands
Player Vaults	Extra storage, vault autopickup, admin tools
Teleportation	Homes, warps, TPA, RTP, world manager
Permissions	Permission nodes reference
Placeholders	PlaceholderAPI expansion
Integrations	SoapsCommon, Vault, PAPI, Mythic, Crucible
Default Config Files	Bundled YAML reference
Examples	Common server owner setups
FAQ	Troubleshooting
Changelog	Version history

Requirements

Requirement	Version
Paper	1.21+ (26.1+ recommended)
Java	21+ (25+ recommended on latest Paper)
SoapsCommon	Hard dependency

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.