Troubleshooting

Short fixes by symptom. Full install steps: Getting Started.

Won’t enable / red plugin

1. Extract the .jar from the ZIP (do not leave the ZIP in plugins/).
2. Install SoapsCommon.
3. Full server restart (not /reload).
4. Search logs/latest.log for SoapsFloor / SoapsCommon.

No plugins/SoapsFloor/ folder means the plugin never enabled.

Pattern	Likely cause
Floor red, SoapsCommon green	Bad jar extract or Paper version mismatch
Both red	Soaps jars still zipped or missing

Core loop broken (join / start / clear)

• Room unfinished: /sf wand status (starter, entry/exit, floors).
• auto-start-enabled: false and nobody ran /sf start.
• Min players not met (min-players in room settings).
• Wrong Direction / flood for the play style you expect → Want drop · Want climb clear · Want climb flood.

Schematics / packs / WorldEdit

• .schem files must sit in plugins/SoapsFloor/schematics/, then /sf reload.
• Paste and wand need WorldEdit (or FAWE).
• Stair pack seams: Direction & climb → Stairs check (OK / MISSING).
• Templates vs stairs vs schematics filters: /sf schematics cycle button.

Weaknesses / rewards weird

• Voting Off on the room → Room Settings → Weakness voting.
• Old weaknesses.yml missing climb/drop pools → merge from Default weaknesses.yml.
• No payout: table not assigned, or only global victory.reward-commands empty → Rewards.
• Fog / vision looks broken: Night Vision cancels Darkness; 1.2.4 strips/blocks it → Changelog.

Soft deps / death chat / /back

• Vault / SoapsAdmin / SoapsQuest only for locked-floor pay → Locked Floors.
• Essentials / CMI / SoapsAdmin death and god/fly hooks → Integrations.
• Mythic mobs not spawning → MythicMobs Setup.

After update

• Jar upgrade needs full restart, not only /sf reload.
• New YAML keys are not forced into customized live files. Compare Config Reference.
• See Upgrading to 1.2.4.

GUI does nothing

Needs gui.enabled: true and the right admin permission. See Admin GUI.