Version 1.5.0
Purpose: Password-protected server onboarding
Primary use case: Offline-mode or custom-auth server setups
JoinJail Docs
JoinJail adds a password-gated entry flow for servers that need stronger access control, especially in offline mode environments where whitelist-only setups are unreliable.
What it does
- Adds a password-gated onboarding flow for offline-mode servers where vanilla whitelist checks are unreliable.
- Creates a remote bedrock holding jail that traps unauthorized joins until they enter the correct password.
- Keeps players jailed even after death by re-applying confinement on the first tick after respawn.
- Automatically adds authenticated players to the whitelist file after successful password entry.
- Supports direct moderation with a JoinJail-specific ban command.
Quick start
- Install JoinJail on your server and start once to generate config files.
- Set your password with
/joinjail setPassword. - Share the join command format with trusted players:
/joinjail <password>. - On successful entry, players are whitelisted and can rejoin normally afterward.
- Use
/joinjail ban <player> <reason>for direct moderation when needed.
Command reference
Use Copy to paste commands directly in your server console or game chat.
/joinjail <password>
Authenticates a player currently in jail and whitelists them when the password is correct.
/joinjail setPassword
Sets or replaces the server password required to exit jail.
/joinjail ban <player> <reason>
Bans a player with a reason (can be reversed with vanilla /pardon).
Configuration files
JoinJail/whitelistfile.txt
Stores the list of players approved through JoinJail authentication.
JoinJail/password.txt
Stores the current server password required for jailed players to unlock access.
FAQ
Why use JoinJail instead of vanilla whitelist?
It was built for offline-mode setups where whitelist behavior can be inconsistent. JoinJail enforces its own gate first.
What happens if a jailed player dies?
They may briefly respawn outside, but JoinJail teleports them back into jail on the first tick.
How do players get permanent access?
After running /joinjail <password> successfully once, they are added to the whitelist file and can rejoin normally.