How to Become an Admin on Your Vintage Story Server

Vintage Story has a proper role system. Admin is a role, granted with one console command, and no file editing or restart is needed.

Grant yourself admin

1. Start the server and join it at least once, so the server knows your player name.
2. In the panel open the Console section.
3. Run:

   /op YourPlayerName

/op is a shortcut for:

/player YourPlayerName role admin

Both do the same thing. The change takes effect immediately.

The default roles

Roles are ordered by privilege level:

• suvisitor, survival visitor, can look but not build.
• suplayer, the normal survival player role most people join as.
• crplayer, creative mode player.
• sumod, moderator, with kick and ban but not full control.
• admin, every privilege.

Change anyone's role the same way:

/player TheirName role sumod

Admin commands worth knowing

• /kick PlayerName reason and /ban PlayerName reason days.
• /unban PlayerName.
• /gamemode PlayerName creative.
• /tp PlayerName and /tpp PlayerName OtherName.
• /time set day.
• /land commands for claim management.
• /autosavenow forces a save. Run it before a manual stop.
• /stop saves and shuts down cleanly.

Whitelisting

To run a private server without a shared password:

/serverconfig whitelistmode on
/player PlayerName whitelist on

With whitelist mode on, only listed players can join. Add everyone before you turn it on, or you will lock yourself out and have to fix it from the panel console.

Privileges

Roles are made of individual privileges such as build, gamemode, kick, ban and controlserver. The role definitions live in serverconfig.json, and you can create your own role with a tailored privilege list. Edit that file with the server stopped, because it is rewritten on shutdown.

If the command is refused

• The player name must match exactly, including capitalisation.
• The player must have joined once so the server has a record of them.
• Run commands from the panel console, which always has full server rights.