Troubleshooting

Common snags and how to clear them.

I didn’t get the verification email

Registration sends a verification link you must click before you can log in.

• Check your spam/junk folder. The sending domain is new, so the first message sometimes lands there.
• Use the Resend email button on the confirmation screen to send a fresh link.
• Make sure the email address you registered is correct — a typo means the link goes nowhere. If so, wait for the unverified account to expire (24 hours) and register again, or pick a different nickname.

Until you click the link, logging in will fail with “Please verify your email before logging in.” That’s expected — verify first, then log in.

”Your session expired — please log in again”

Your saved login eventually expires, or can be invalidated server-side. When that happens the plugin logs you out and shows this message. Just log in again with your nickname and password — you’ll get a fresh session and it’ll persist.

I can’t log in / “invalid nickname or password”

• Double-check the nickname and password (both are case-sensitive).
• If you registered but never verified, see the verification section above — unverified accounts can’t log in.

Missing modules

If you join a session whose patch uses plugins you don’t have installed, those modules can’t fully appear on your side.

• You’re warned before joining and can choose to join anyway.
• If you join, missing modules show as placeholders — they sync position and data but won’t render or make sound for you. A status indicator shows how many are missing.
• The fix: install the same plugins the host is using, then rejoin. The cleanest sessions are ones where everyone has the same modules installed.

Stuck on “connecting” / can’t join

Joining has two stages: the lobby (finding the session) and the peer connection (the actual real-time link to the host). If you get past the lobby but hang on connecting:

• Confirm the host is still hosting and the session is live.
• If the host set a password, an invite code alone won’t connect — you need the password too.
• Transient network issues can stall the peer handshake. Leave and rejoin.

I keep getting disconnected

The plugin auto-reconnects on an unexpected drop, rejoining and pulling a fresh snapshot. If it exhausts its retries you’ll see a manual Reconnect button — click it to try again. Persistent drops usually point at an unstable network on one side.

I left a session and got logged out

Leaving a session should not log you out. If it does, it’s almost always a stale saved login surfacing at that moment — see “Your session expired” above. Log back in and you’re set.

Still stuck?

Open an issue on GitHub with what you were doing and any error text the module showed.