This guide shows how to add admins to your Vintage Story server, how to assign roles and permissions. You can add an admin immediately from the panel console or automatically at server startup by editing the serverconfig.json.

Add an admin from the panel console

The server offers a live console panel for you to monitor the performance and enter commands if needed.

1. Log in to your PingPlayers control panel by going to My Servers > Manage Server.
    

2. Open the server console.
   From the left panel, select the Console option.

   

    

3. Give a player admin permissions by giving them operator status.
   Type on the console /op PLAYERNAME (replace PLAYERNAME with the actual username) and press Enter.
   
   Example:

   /op Pingplayers

   

    

4. The player should now have operator privileges. Ask them to rejoin if they do not see their new permissions immediately.

   

   
   You should see a new tab in your chat after rejoining the server.

   

    

5. After having operator status, you may execute commands in-game as you desire.
   For an in-game command list, use the command /help in chat

Side note:

If you'd like to remove operator status from a player, you may do so from console as well. Type the following command and press Enter.
/player PLAYERNAME role suplayer (replace PLAYERNAME with the actual username)

Example:

/player Pingplayers role suplayer

(suplayer = survival player)

Assign admins during startup

To avoid using the live console, you may edit the server's configuration file for it to give operator status to players automatically upon starting up.

1. Shut down the server before editing any file, to avoid any issues.
   Go to the Actions option on the left panel and click Shutdown.

   

    

2. Click the File Manager option on the left panel to see all server files.
   Look for a file called serverconfig.json

   

    

3. Open the file and locate the line StartupCommands. This particular line controls what gets executed as a command once the server starts.
   If it doesn't have the correct format, the server will fail to boot.
    

4. To give operator status, type the following line:
   “op PLAYERNAME”
   (make sure to use the quotes and replace PLAYERNAME with the actual username)
   
   Example:

   "StartupCommands": “op Pingplayers”,

   In case you want to add multiple admins, separate them with a literal backslash-n sequence (\n).
   
   Example:

   "StartupCommands": “op Pingplayers\n/op Ping”,

   This will run two commands at server start: op Pingplayers and then /op Ping. The first OP user will be Pingplayers, the second will be Ping.
    

   

    

5. Save the file and restart the server by going to Actions > Restart.

   

    

6. If the server starts normally, that means the command worked. You can either check the status in-game, or by using the live Console in our website.

   

    

7. To remove the operators from the server, set the StartupCommands line back to “null”.
    

   "StartupCommands": null,

Managing permissions and roles

Vintage Story uses player roles for normal play modes and uses operator status (OP) to grant server administrative privileges. We suggest you to use commands from the website command, as it executes them right away.

Change a player's role

Use the /player command to change roles. If you enter that specific command on the console, you will be prompted with all available options.
Example:

/player PLAYERNAME role suplayer

This sets the player to the suplayer role.

• suplayer — Survival Player
• crplayer — Creative Player

You can use the /player command to move people between roles. That same command is used to remove players from administrative groups by assigning them a standard role (for example, switching them back to suplayer as mentioned before).

Find here a full list of player commands: https://wiki.vintagestory.at/List_of_server_commands#/player

You can also create groups for different players. On Console, use /group create [groupname] to create a new player group, with its own chat channel in-game.
Once created, you may assign different roles to this groups, instead of doing it individually per player.

/role [rolename] privilege [grant|revoke] [privelegename]: Grant or revoke privileges from given role.

/role [rolename] spawnpoint [x] [y] [z]: Configure a role specific spawn point. Any player that has this role will spawn at this location.

/role [rolename] landclaimallowance [value]: Set the max allowed claimable area in cubic meters for every player that has this role. (default: 4 chunks = 4*32*32*32 cubic meters = 131072)

/role [rolename] landclaimminsize [x y z]: Set the smallest cuboid a player may claim. (default: 6 by 6 by 6)

/role [rolename] landclaimmaxareas [value]: Set the max quantity of non-adjacent areas a player may claim. (default: 3)

Troubleshooting

• It's not giving me admin when doing it from the config file.

  Most often this is caused by wrong syntax in the configuration. The StartupCommands value must be a single-line string with each command separated by the literal sequence \n (backslash n) — not actual new lines. Make sure the entire line is inside straight double quotes (") and that there are no extra spaces around the \n separators.

• Creative mode doesn't work even though I'm OP.

  Being OP gives you administrative commands, but Creative play must be enabled in the game configuration first. Open the game config (the relevant game settings file in your panel), enable Creative mode, save, and restart the server. After restart, the creative role or mode will take effect.

If you have any questions or need assistance, feel free to reach out to our customer care agents through our live chat or email at support@pingplayers.com. Happy gaming!