FAQ
Last updated Jul 27, 2026
FAQ
| Problem | Fix |
|---|---|
| Plugin will not enable; SoapsCommon missing | Install SoapsCommon in plugins/ before SoapsAdmin. Hard dependency — SoapsAdmin disables without it. See Getting Started. |
| Coming from EssentialsX or CMI | See Comparison. |
| Item editor or fake players fail on Spigot | Paper-only features. Use Paper 1.21+, or keep those modules off on Spigot. See Integrations, Item Editor, Fake Players. |
| Custom commands not updating after YAML edit | Edit plugins/SoapsAdmin/customcommands.yml (server copy), not the jar. Then /sa reload customcommands or /sa reload. In-game create/edit via GUI registers immediately. See Custom Commands. |
| Mannequin / Shopkeeper preset looked invisible | Known mannequin invisible bug; fixed in current 1.7.0 line. Ghost preset still sets invisible on purpose. Use Fake Players editor toggles / Shopkeeper preset. |
Changing system-gui.yml does not change click behavior |
GUIs are cosmetic only in YAML (material, name, lore, slot). Logic stays in Java. /sa reload gui after cosmetic edits. See GUIs and Menus. |
Economy resetall does nothing |
Requires -confirm: /sa economy resetall [economy] -confirm. Permission soapsadmin.economy.reset. |
| Vaults: OP cannot open vault #2+ | Extra vaults need explicit soapsadmin.vault.limit.<n>. Ops / * alone do not unlock higher limits. See Player Vaults. |
| Mythic spawn / drops fail | Soft dep MythicMobs must be loaded; check /sa info. Spigot and Paper both supported for Mythic when present. |
| Placeholders empty | Install PlaceholderAPI; use %soapsadmin_...%. See Placeholders. |
| Config edits ignored | Edit files under plugins/SoapsAdmin/. Jar resources copy only when the file is missing. Reload the matching target (/sa reload config, messages, gui, etc.). |