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 SoapsTeleporter / SoapsCommon.

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

Pattern	Likely cause
ST red, SoapsCommon green	Exception on enable — read the stack in the log
Both red	Jars still zipped or missing

Core loop broken (no teleport)

1. /st info <portal> — enabled? connected or RTP configured?
2. Permissions: st.portal.use and st.portal.<name>.use when per-portal permissions are on.
3. Conditions or costs blocking the player.
4. /st debug issues and /st reload self-test.
5. Overlapping regions are rejected on create; move or remove conflicts.

Warmup cancels on move. Bypass: st.portal.bypass.warmup.

Optional systems weird

Symptom	Check
Money cost ignored	Vault + provider, economy.enabled, /st debug economy → Vault Economy Setup
Charged but no refund	payment-timing / refund-on-failure → Economy
Particles missing	particles.enabled, stand within nearby-player-radius (30), client particle setting
Lands in claims	WorldGuard/Lands hooks default off → WorldGuard Setup · Lands Setup
RTP does nothing	Type must be RTP (/st settype) → Want RTP portal
/st manage is chat not GUI	gui.enabled: false → Admin GUI

After update

• Jar upgrade needs a full restart, not only /st reload.
• Live YAML is never overwritten by the jar. Compare: Config Reference.
• Owner checklist: Upgrading to 1.0.7.