Vintage Story Server Quick Start Guide

Whitelist (Enabled by Default)

As of Vintage Story 1.20, new servers are whitelisted by default. This means nobody can join, including you, until you either add yourself to the whitelist or disable it. All whitelist commands must be run from the server console in the Game Panel (not in-game chat, since you can’t join yet).

Add yourself to the whitelist

1. Open your server in the Game Panel
2. Go to the Console tab
3. Run: /whitelist add <your-username>
4. Connect to your server from the Minecraft client

Repeat /whitelist add <username> for each player you want to allow in.

Disable the whitelist entirely

If you want any player to be able to join without being added manually:

1. In the server console, run: /whitelist off
2. Try to connect from the Vintage Story client to confirm it worked

Your server is now open to anyone with the IP and port. You can re-enable it at any time with /whitelist on.

If /whitelist off doesn’t disable the whitelist

In some Vintage Story 1.20 builds the /whitelist off command runs but the whitelist stays enforced. If you (or your players) still see “only whitelisted players can join” after running it, edit the config file directly:

1. Stop the server
2. In the Game Control Panel sidebar, click File Manager
3. Open data/serverconfig.json
4. Find the WhitelistMode line (press CTRL+F to search)
5. Set the value to 1 to disable the whitelist, or 2 to enforce it
6. Click Save
7. Start the server

"WhitelistMode": 1,

Next Steps

• Connecting to your Server
• Installing Mods
• Common Commands