Vintage Story Admin Commands (1.22): Full List with Examples
Updated June 2026 - verified against Vintage Story 1.22.1, the current stable release (29 April 2026).
Modern Vintage Story server administration is handled through a granular privilege and role system. Unlike many survival games with a simple "all or nothing" admin status, Vintage Story lets you grant specific players the ability to moderate chat, teleport, or manage time without giving them full world-editing powers. This page covers every essential server and console command, with examples, server-vs-client behaviour, and the privilege levels that control who can run what.
1. The Command Types
Server Commands (/) affect the world and other players and are checked against your privileges. Client Commands (.) only affect your own game instance (for example UI tweaks or the in-game command handbook, .chb).
2. Operator Status
To use administrative commands, a player must be an operator or sit in a role that holds the right privileges. Run /op [username] from the server console - this is shorthand for /player [username] role admin. Use /deop [username] to revoke it.
3. Permission Hierarchy
Vintage Story ships with default roles ordered by privilege level: suvisitor (level -1), suplayer (level 0), sumod (level 200), and admin (level 99999, all privileges). Higher levels override lower ones, and you can build custom roles to delegate work to moderators.
Essential Player Management
| Command | Effect | Example |
|---|---|---|
/op [player] | Grants admin status (alias for /player [player] role admin). | /op Sven |
/deop [player] | Removes admin status by returning the player to the default role. | /deop Sven |
/kick [player] [reason] | Disconnects a player with an optional message. | /kick Sven AFK too long |
/ban [player] [reason] [hours] | Blocks a player from joining; omit hours for a permanent ban. | /ban Griefer Stealing 168 |
/unban [player] | Lifts an existing ban so the player can reconnect. | /unban Sven |
/player [player] role [role] | Moves a player into a permission role (for example suplayer, sumod, admin). | /player Sven role sumod |
/player [player] gamemode [0..4] | Sets game mode: 0 guest, 1 survival, 2 creative, 3 spectator (names also accepted). | /player Sven gamemode creative |
/player [player] whitelist on|off | Adds or removes a player from the server whitelist. | /player Sven whitelist on |
/kill [player] | Instantly slays a player (useful for stuck characters). | /kill Sven |
Whitelist mode itself is toggled with /serverconfig whitelistmode [off|on|default]; once on, only whitelisted players may join. The same command group sets /serverconfig maxclients [n] and /serverconfig password [text] for a private server.
World and Environment Control
- Time:
/time set [time]accepts named values such asday,night,noonandmidnight;/time add [hours]fast-forwards. Advancing time affects crop growth and food rot, so use it sparingly. - Weather:
/weather setprecip [-1..1]sets precipitation (-1 clears clouds, 0 stops rain, 1 is the heaviest downpour)./weather stoprainends current rain, and/weather setprecipahands control back to automatic weather. - Temporal Stability:
/worldconfig temporalStability [true/false]turns the rift mechanic on or off for a more relaxed experience. - Items and Entities:
/giveitem [code] [quantity]and/giveblock [code] [quantity]distribute content;/entity spawn [code]places creatures for events or testing. - Announcements:
/announce [message]sends a gold-coloured system message to every active player.
Advanced: Privileges and Land Claims
Vintage Story uses a land-claiming system to prevent griefing, plus a per-privilege grant model so you can hand out exactly one capability at a time. Manage both from the console:
/land claim [start/end]and/land free- mark out or release a protected claim area./player [player] privilege grant [privilege]and/player [player] privilege revoke [privilege]- add or remove a single ability without changing the player's whole role.- Common privileges:
build(place and break blocks),useblock(open chests and doors),tp(teleport),gamemode(switch own mode),give(spawn items) andcontrolserver(server-level admin actions). /role [rolename] [property]- tune a role's spawn point and land-claim allowance when building a custom moderator tier.
For the authoritative, version-specific syntax of any command, see the official Vintage Story server commands wiki.
Pro Tip: Use the Command Handbook by typing .chb in-game. It provides a searchable, categorized database of every command available on your specific server version, including those added by mods.
Govern your world with absolute precision. Host your Vintage Story server with Supercraft and enjoy a dedicated web console that makes moderation tasks fast and efficient.