Set Up a Whitelist

Configure a whitelist on your Project Zomboid server so only approved players can join.

A whitelist restricts your server to pre-approved players only. This is ideal for private communities, roleplay servers, or events.

Enable the Whitelist

On XGamingServer, go to Files and open:

Zomboid/Server/[servername].ini

[servername].ini

Open=false

When Open is set to false, only whitelisted players can join.

[servername].ini

AutoCreateUserInWhiteList=false
DropOffWhiteListAfterDeath=false

Setting	Default	Description
`Open`	true	`false` = whitelist mode, only approved players can join
`AutoCreateUserInWhiteList`	false	Automatically add new accounts to the whitelist
`DropOffWhiteListAfterDeath`	false	Remove players from whitelist when their character dies

While logged in as admin, use:

/adduser "PlayerName" "password"

This creates an account and adds the player to the whitelist.

Navigate to Zomboid/Server/[servername]_whitelist.txt and add player names, one per line.

/removeuserfromwhitelist "PlayerName"

Edit [servername]_whitelist.txt and remove the player's name.

For hardcore servers, enable DropOffWhiteListAfterDeath:

Open=false
DropOffWhiteListAfterDeath=true

When a player's character dies, they're removed from the whitelist and can't rejoin until an admin re-adds them.

If you need help, join our Discord.