How to Turn the Whitelist On or Off on Your Vintage Story Server

Published 9 June 2026 · By Host Havoc Technical Support Team

When the whitelist is on, only players on the list can join your Vintage Story server. Bans still apply either way.

  1. Log in to the Game Control Panel and navigate to your server.
  2. Click the HH Server Admin icon, then Bans & whitelist on the left.
  3. Under Whitelist, click Turn it on or Turn it off. It changes straight away.
  4. To let a player in while the whitelist is on, type their Vintage Story account name and click Add to whitelist. Take off removes them.

Your server needs to be running.

Method 2: Console command

Open HH Server Admin and click Console on the left, then run:

/serverconfig whitelistmode off

Use on instead of off to turn it back on.

Method 3: Edit serverconfig.json

  1. Stop the server.
  2. Click Configuration Files and open serverconfig.json in the Config Editor. If it doesn't show the WhitelistMode setting, switch to the Text Editor.
  3. Set WhitelistMode to 1 to turn it off, or 2 to turn it on:
"WhitelistMode": 1,
  1. Click Save & Exit, then start the server.

Note: 0 is the game default, which is on for dedicated servers. The older OnlyWhitelisted setting is ignored, so changing it does nothing.