You decide which services we may enable for analytics, personalization, and external content.
We use cookies and similar technologies on our website to personalize content, embed external media, and better understand how individual areas are used.
Necessary cookies
These entries support essential functions such as security, stability, and form processing.
Optional sections
Your data may be processed with your consent or on the basis of legitimate interests. In the cookie settings, you can reject or explicitly allow each optional category.
Some services process personal data in third countries. By consenting, you also agree to this transfer. You can find more information in our Privacy Policy.
You can reopen and change your selection at any time. · 1.0.2
Learn how to enable the whitelist on your Vintage Story server in ZapX, manage players, and protect your server with a password → Learn more
A whitelist is an access list that limits who can join your game server. Vintage Story has a built-in whitelist mode that you can turn on or off, along with a list of players who can join when the mode is enabled.
On your ZapX server, whitelist mode is disabled by default: anyone who knows the address and, if applicable, the password can join. Here, we'll show you how to use the whitelist and what to keep in mind.
FAQ
Feedback
Was this article helpful?
Your feedback helps us prioritize and improve content.
0 of 0 Users found this article helpful.
Personal support
Need more help than the guide provides?
Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.
Zappy knows this guide and answers you right in the chat.
Navigation
Enter the following command in your server's Console or in-game as an admin:
/serverconfig whitelistmode on
You can also use the number 2 instead of on. The command accepts three values: off (1) allows all players to join, on (2) allows only players on the whitelist, and default (0) uses the game's default behavior.
Your ZapX server sets whitelist mode back to off on every startup. Any changes to the serverconfig.json file are also overwritten when the server starts. So after every restart, update, or crash, you must run /serverconfig whitelistmode on again. Your list of allowed players will be preserved.
To allow a player to join, add them to the whitelist with the player command.
/player PlayerName whitelist on
To revoke their access, turn off the whitelist for that player.
/player PlayerName whitelist off
Run /player PlayerName whitelist without a value to check whether a player is on the whitelist. To check the current whitelist mode, run /serverconfig whitelistmode without a value.
Add yourself and all other players to the whitelist first, then switch the mode to on.
Try connecting with a player who isn't on the whitelist. The connection should be rejected. Then connect with a player for whom you've set whitelist on.
If everyone can still join, use /serverconfig whitelistmode to check that the mode is set to on. If your server has restarted in the meantime, the mode will be back to off.
To keep your server protected even after restarts, set a password. In ZapX, enter it in the Server Password field under Startup Parameters in the Configuration tab, save your changes, and restart your server. No one will be able to join without the password. For more information, see our guide Connecting to the server.
You now know how to enable and manage the whitelist on your Vintage Story server, and why you need to enable it again after every restart. For ongoing protection, it's best to use a server password.
If you have any other questions or run into problems, our support team is available every day—feel free to contact us! 🙂
© 2026 ZAP-Hosting GmbH
Preferred source on Google
