Troubleshooting

Short fixes by symptom. Full install: Getting Started.

Won’t enable / red plugin

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

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

Pattern	Likely cause
Arena red, SoapsCommon green	Arena jar still zipped, wrong Common version, or load error in log
Both red	Jars still zipped or missing

Core loop broken

• Need two players in the same queue (or /sar duel), or /sar forcejoin for solo tests
• Room still disabled → /sar enable <room>
• Wand session open → finish or cancel before joining
• Prepare cancelled by death → queue.prepare-cancel-on-death (Configuration)

GUIs stay chat-only

All three must be true: gui.enabled, gui.gui-enabled in config.yml, and settings.enabled in gui.yml. Then /sar reload. GUI Menus

Destructible does not reset

WorldEdit/FAWE installed? Destructible on? worldedit.auto-restore: true? Want destructible · WorldEdit Setup

Death chat / keepinv / back weird in fights

Update Arena (and Admin if used). Soft-hook details: Match Soft Hooks.

After update

• Jar upgrade needs a full restart, not only /sar reload
• Live YAML is not overwritten by the jar → Config Reference
• See Upgrading to 1.0.1

/sar reload from console fails

/sar is player-only. Reload in-game, or restart the server after a jar change.