FAQ
Last updated Sep 18, 2026
FAQ
| Problem | Fix |
|---|---|
| Plugin will not enable; SoapsCommon missing | Install SoapsCommon in plugins/ before SoapsAdmin. It is a hard dependency, so SoapsAdmin disables without it. See Getting Started. |
| Coming from EssentialsX or CMI | See Comparison. |
| Does Spigot work? | Yes on Spigot 26.2 for almost everything. Paper-only: item editor + fake players/mannequins. RTP and teleports work on Spigot with sync chunk load (Paper async is smoother). Folia is not supported. See Integrations. |
| Item editor or fake players fail on Spigot | Paper-only features. Use Paper 26.2, or keep those modules off on Spigot. See Integrations, Item Editor, Fake Players. |
RTP stuck at ~13% / CHUNK_NOT_READY / chunksLoaded=0 |
Fixed in 1.7.0: search now loads unloaded chunks. Confirm settings.load-chunks: true in plugins/SoapsAdmin/rtp.yml. See Teleportation. |
| Void world grows normal land / chunk walls | Generator was not persisted across restart. Update plugin, run /sa world fixgenerator <world>, then delete region/ if old terrain should be wiped. See Teleportation. |
| 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. Missing close/nav? Delete system-gui.yml and reload to restore jar defaults, or merge new menu keys from the jar. 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.). |
| Which spawn command do I use? | /sa spawn / /sa setspawn = server spawn in data/server/spawns.yml (lobby / death when spawn-respawn is on). /sa worldspawn / /sa setworldspawn = Bukkit spawn for the world you are in. See Teleportation. |
| Cheque withdraw says disabled | Enable per currency: economies.<id>.cheque.enabled: true in economy.yml. Defaults are off except the example vouchers currency. See Economy and Shop. |
| Interactive bind does nothing | Custom command name must exist; look at the block within 5 blocks; players need soapsadmin.interactive.use. Data: interactive.yml. See Custom Commands. |
| Waypoint name plate is empty / tracking has no HUD | Update to 1.7.2+. Right-click track shows a boss bar at the top (meters away; bar shrinks as you close in). See Teleportation. |
| Waypoint markers gone after restart (still in list) | Markers are recreated on startup/join. Update to latest 1.7.2 build. Confirm display is ON in the edit GUI. |
Disabled module still overrides Essentials (/money etc.) |
Fixed in 1.7.2: top-level aliases release when the owning module is off. /sa reload modules after changing modules.yml. |
| Staff lookup prompt appears in public chat | Fixed in 1.7.2 (clears chat viewers; loadbefore ChatControl). Update jar and restart. |