Skip to content
Client area Order

Vintage Story server

Managed from: GamePanel. 7 answers, updated 14 November 2026.

Essentials 1

How do I connect to my Vintage Story server?

In Vintage Story, open Multiplayer, choose "Add New Server" and enter the IP address and port shown at the top of the GamePanel console. The server is ready when the console shows "Dedicated Server now running on Port".

  1. Start the server and wait for the line "Dedicated Server now running on Port" in the console (about 30 seconds for a new world, longer with mods).

  2. Note the server address and port, at the top of the console.

  3. In the game, open Multiplayer then "Add New Server": put the address and port in "Host / IP Address" (as address:port), then the server password if you set one.

Common errors

  • Players must run the same game version as the server: after a game update, restart the server so it updates too.
  • "Whitelist" set to 1 in GamePanelServer Options: only players added to the list can join.

Guides 6

How do I become an admin on my server?

In GamePanelConsole, type /op followed by your Vintage Story player name: you then have full rights in game.

  1. GamePanelConsole: type /op YourName (the exact name of your Vintage Story account) and press Enter.

  2. Admin commands are then available in game, in the chat.

Common errors

  • "No player with name or uid … exists": the name is misspelled. The server checks the account with Vintage Story, the player does not need to have joined before.
How do I change the name, password, player count or PvP?

GamePanelServer Options: "Server name", "Server password", "Max players", "Player combat (PvP)" and "Public server list". They apply on the next start.

  1. Stop the server.

  2. GamePanelServer Options: change the settings you want.

  3. Start it: name, password, public list, whitelist and PvP are rewritten in data/serverconfig.json on every start.

  4. Other settings (welcome message, roles, maximum view distance) are in data/serverconfig.json: edit it with the server stopped, from GamePanelFiles.

Common errors

  • ServerName, Password, AdvertiseServer, WhitelistMode or AllowPvP changed by hand in serverconfig.json: the panel setting replaces them on start.
  • "Public server list" set to 1 with no password and no whitelist: any player of the game can join.
How do I keep my server to my players (whitelist)?

Set "Whitelist" to 1 in GamePanelServer Options, restart, then add each player in GamePanelConsole with /player Name whitelist add.

  1. GamePanelServer Options: "Whitelist" = 1.

  2. Restart the server.

  3. GamePanelConsole: /player Name whitelist add for each player, /player Name whitelist remove to take one off.

Common errors

  • With "Whitelist" at 0 (the HelloServ default), any player who has the address, and the password if there is one, can join.
  • "No player with name or uid … exists": the name is misspelled. A player can be added before their first visit.
How do I install mods?

Open GamePanelMods, search for the mod by name and click "Install". The server downloads it at its next start, in the version made for its own, and updates it on every start. Your players have nothing to install by hand: when they join the server, the game offers to download the mods they are missing.

  1. In your server's menu, open "Mods".

  2. Search for a mod by name (Carry On, Primitive Survival…), then click "Install". The search only shows mods that have a version for your server's game version.

  3. Click "Restart now": the console shows "[HelloServ] Mod … installé" for each mod, then the game loads them.

  4. "Remove" takes a mod out: its file is removed from data/Mods on the next start.

  5. A mod that is not on the ModDB: drop its .zip file into data/Mods from GamePanelFiles or over SFTP, then restart. The server never removes those files.

Common errors

  • "no version for game …" under a mod in the window (in the console: "introuvable sur le ModDB ou sans version pour ce serveur"): the mod is not out yet for this game version. The file already installed is kept; you can also stay on a game version ("Game version").
  • A mod that needs another one (a library, for example configlib): install both. The mod's ModDB page names the ones it needs.
  • The window keeps the list of the "ModDB mods" setting in GamePanelServer Options: you can also type the IDs there by hand, separated by commas (for example carryon,primitivesurvival).
How do I choose the game version or stay on one?

By default, the server installs the latest stable version on every start ("Automatic updates" = 1). To keep a specific version, put it in "Game version" (for example 1.21.6): it is installed on the next start.

  1. GamePanelServer Options: "Game version" = latest (latest version) or a version number released by the developer.

  2. "Game branch": stable (recommended) or unstable (developer test versions).

  3. Restart: the console shows "[HelloServ] Installation de Vintage Story …" then "… installé".

Common errors

  • Going back to a version older than the one that opened the world: the game may refuse map parts saved by the newer version. Make a backup first.
  • "Version … introuvable" (version not found): that number does not exist at the developer; the server starts with the version already installed.
How do I change the play style or create a new world?

The play style is chosen when the world is created: change PlayStyle in data/serverconfig.json, move the current world aside (data/Saves/default.vcdbs), then restart. Other world settings are changed with /worldconfig in the console.

  1. Stop the server, and make a backup if you want to keep the old world.

  2. GamePanelFiles: in data/serverconfig.json, WorldConfig section, set PlayStyle and PlayStyleLangCode to the same value: exploration, wildernesssurvival, homosapiens or creativebuilding.

  3. Rename data/Saves/default.vcdbs (for example to old-world.vcdbs).

  4. Start it: the console shows "Create new save game data. Playstyle: …" and the new world is created in that style.

Common errors

  • PlayStyle changed without moving the world aside: the existing world keeps its style.

Can't find it? Open a ticket from your client area. Terms and conditions: helloserv.fr/en/legal