Vintage Story Server Commands

Becoming admin, and handing out roles

The first admin is made from the server console, which always has full rights:

/op YourName

/op is a shortcut for giving someone the admin role. Roles are how Vintage Story handles permissions: every player has exactly one, and new players get suplayer. To give a role, or see someone's current one:

/player FriendName role sumod
/player FriendName role

It works whether the player is online or not, and needs no restart. There is no /deop: to take admin away, give the player another role, for example /player FriendName role suplayer.

/list roles shows the roles on your server. A single privilege can be granted on top of a role: /player FriendName privilege grant gamemode.

Whitelist: who can join

With the whitelist on, only players you have added can join. A standard Vintage Story dedicated server has it on by default; on HytHost new servers start with it off, so anyone with the address — and the password, if you set one — can join.

/serverconfig whitelistmode on
/player FriendName whitelist on
/whitelist add FriendName
/whitelist remove FriendName

whitelistmode takes on, off or default (on for a dedicated server). Adding and removing players works instantly, online or offline; /player FriendName whitelist on and /whitelist add FriendName do the same thing.

The command list, by task

Moderation

A moderator cannot kick or ban someone with an equal or higher role. There is no mute command in Vintage Story.

Time, weather and the world

Players

Mods

Restart the server after installing or removing a mod. Players are offered the server's mods when they join.

Server

Live, after a restart, or only on a new world

The world generation settings are fixed once the world exists — the server refuses to change the world size at all. To play with different ones, start a new world; the usual way is to set it up in single player first and then put that world on the server, which our world upload guide walks through.

Running commands on a HytHost server

The Console tab of your GamePanel is the server console. Start every command with a slash, exactly as in chat; the console runs with full rights, so it is where you type your first /op.

• The Startup tab owns a few settings. Server name, password, player limit and the whitelist switch are applied from the Startup tab at every start, so change them there. The play style and seed are also set there, before the world is created.
• Mods two ways. List ModDB ids in MODDB_MODS in the Startup tab and reinstall — the server picks the release made for your game version — or use /moddb install and restart.
• Any version. The game version is chosen at checkout, from 1.18.15 to the newest stable release, and can be changed later in the Startup tab. Moving to a newer version keeps your world; moving to an older one starts a new world and keeps the current one in a folder of its own.
• Backups and restarts. Automatic backups are included, and scheduled restarts can run /announce and a save on a timer.

Vintage Story is a PC game for Windows, macOS and Linux, and every player needs their own account from vintagestory.at. Vintage Story hosting has every plan and a Custom server up to 16 GB.