Back to all guides
Vintage Storywhitelistpublicadminconfig

Vintage Story Whitelist, Public Listing, & Admin Commands

Configuring AdvertiseServer, WhitelistMode, /whitelist add, and /op.

Vintage Story Whitelist, Public Listing, & Admin Commands

By default, dedicated Vintage Story servers may boot in private or whitelisted mode. Follow this guide to make your server publicly visible or manage whitelist permissions and admin roles.

---

1. Making Your Server Public or Private (AdvertiseServer)

To control whether your server appears in the public Vintage Story server browser:

1. Open your server directory and locate serverconfig.json. 2. Find the setting `AdvertiseServer`:

  • Set "AdvertiseServer": true to display your server in the public master list.
  • Set "AdvertiseServer": false to hide your server (direct IP join only).

3. Save the file and restart your server, OR run the following command in the server console:

   /serverconfig AdvertiseServer true

---

2. Managing Whitelist Permissions (/whitelist)

To restrict server access to specific players:

Enabling / Disabling Whitelist

In the server console or in-game chat (as an admin), execute:

  • /serverconfig WhitelistMode on (Enables whitelist mode)
  • /serverconfig WhitelistMode off (Disables whitelist mode)

Adding & Removing Whitelisted Players

  • To add a player:
  /whitelist add PlayerUsername
  • To remove a player:
  /whitelist remove PlayerUsername

---

3. Granting Admin Permissions (/op)

To make a player an Admin with full privileges:

1. In the Server Web Console, execute:

   /op PlayerUsername

*(This assigns the player to the admin role).* 2. To demote an admin back to a standard player:

   /player PlayerUsername role suplayer