List of server commands
This is a list of commands that are executed on the server and therefore list/change things that may affect all players. Some of these commands may need coordinates, so make sure you use the right notation.
1. Server commands all start with / 2. Do not type the [ and ] in the command syntax e.g. the correct command is /time set 12 not /time set  3. After a change of server settings, the world needs to be restarted for the changes to take effect.
- 1 Multiplayer Commands for Players
- 2 Commands for Moderators and Admins
- 3 Privilege Control
- 4 World Control
- 5 Server control and configuration
- 6 Utility and Debug Tools
- 7 See also
Multiplayer Commands for Players
Commands for Land Claiming
Claim an area of the world where only you can build or use blocks in.
Displays a list of the claims that you made so far, you can use displayed index number to modify it, see below.
Display information on the claimant of the current position, if there is any.
/land free [index]
Deletes a claim of yours.
Deletes the claim of a player as an admin.
/land claim [load|new|grant|revoke|gn|ge|gs|gw|gu|gd|start|end|add|plevel|fullheight|save|cancel]
Create or modify an existing claim.
/land claim load [0..999]
Load an existing claim for modifying. Use index number as shown in /land list to select which claim.
/land claim new
Create a new claim, also marks the start position.
/land claim grant [playername] [use|all]
Grant given player access to your claim. 'use' for only use/interact rights, 'all' for use and place/break block rights.
/land claim revoke [playername]
Revoke a previously granted privilege to given player on your claim.
/land claim grantgroup [groupname] [use|all]
Grant given player group access to your claim. 'use' for only use/interact rights, 'all' for use and place/break block rights.
/land claim revokegroup [groupname]
Revoke a previously granted privilege to given player group on your claim.
/land claim allowuseeveryone [true|false]
Grant or Revoke use access to all players
/land claim start
Mark a start position for a cuboidal area to be claimed.
/land claim end
Mark an end position for a cuboidal area to be claimed.
/land claim [gn|ge|gs|gw|gu|gd] [-99..99]
Grow the currently selected cuboid towards north/east/south/west/up/down by given length. If no length is supplied then the selection is grown by 1 block.
/land claim [sn|se|ss|sw|su|sd] [-99..99]
Shrink the currently selected cuboid towards north/east/south/west/up/down by given length. If no length is supplied then the selection is shrunk by 1 block.
/land claim add
Adds the currently selected cuboid to the currently edited claim. A claim may exist of multiple cuboids, as long as they are adjacent to eachother.
/land claim fullheight
Vertically grow the currently selected cuboid to encompass the full height from world bottom to world top. Note that with default settings this is not possible because players cannot claim that many chunks.
/land claim save [description]
Save current claim modifications and stop editing the current claim.
/land claim cancel
Discard all modifications to this claim.
Create/manage or destroy a player group. Player groups currently only serve the function of offering a seperate channel to chat in in addition to granting access to claimed areas.
/group create [groupname]
Creates a new player group, own chat channel. While in the this group's chat channel:
/group invite [group] [playername]
Invites a player to this group
/group acceptinvite [groupname]
Accept an invite to join the group
/group leave [group]
Leaves this player group.
Lists all groups you are currently in.
/group info [groupname]
Lists the players of a group.
/group rename [oldgroupname] [newgroupname]
Renames the group.
/group kick [group] [playername]
Removes a player from the group.
/group op [group] [playername]
Grants operator status to this player, which allows them to invite other players.
/group deop [group] [playername]
Revokes operator status from this player.
/group disband [group]
Destroy a player group. Must be owner to perform this command.
These commands affect the players Worldmap and waypoints.
Add and edit your list of waypoints.
/waypoint add [color] [title]
Adds a waypoint with given color and text at your current position. The color may be any named .NET Color or a Hex Code.
/waypoint add red copper
/waypoint addat [coords] [pinned] [color] [title]
Add a waypoint at the given coordinates.
/waypoint addati [icon] [x] [y] [z] [pinned] [color] [title]
Add a waypoint at your current location, including colour and icon info.
Shows a list of all player waypoints by id number.
/waypoint remove [id]
Removes the waypoint id as shown in
Kills the player.
Character does an emote animation.
/pm [playername] [message]
Send a private message to a user (creates a temporary group)
Commands for Moderators and Admins
List all server commands.
/giveblock [blockcode] [quantity] [toplayername] [attributes]
Creates an itemstack of the specified block in the specified quantity, and gives it to the specified player. The player must have an empty inventory slot to receive the itemstack. Quantity, toplayername and attributes are optional. The default quantity is 1. If player name is not set, the command user's own player is targeted. If attributes are specified, they must be written in the same format as in a JSON file (note: spacing is optional in JSONs and it will be easier to omit spaces here)
/giveitem [itemcode] [quantity] [toplayername] [attributes]
Same as above but for items.
Mode names can be shortened to any length. Sets your game mode:
0|guestGuest mode - Cannot place/remove any blocks but can interact with them
1|survivalSurvival mode - Can slowly break/place blocks. Can die. Cannot fly. Survival inventory.
2|creativeCreative mode - Access to all blocks through the creative inventory. Instant block breaking. Cannot die. Can fly.
3|spectatorSpectator mode - Cannot place/remove blocks and cannot interact with anything, but can fly.
/gamemode [playername] [0..4]
Sets the gamemode for given player.
Teleport yourself to the position given.
/tp x y z
Teleports the player to given pretty coordinate visible from the pretty coordinate box.
/tp =x =y =z
Teleports the player to given absolute coordinate visible from the debug screen on CTRL + F3.
/tp ~x ~y ~z
Teleports player by a given relative distance, i.e. teleport ~1 ~0 ~0 will teleport the player one block in x direction.
/tp [playername] [coordinates]
Teleport given player to a different position.
Teleport yourself to given player.
/tpwp [starts with name]
Teleport yourself to a waypoint.
/ban [playername] [reason]
Ban a player.
Unban a player.
/kick [playername] [reason]
Kick a player.
Removes all items from your inventory.
Removes all entities (except playerentities and blockentities) from all loaded chunks.
Tells you the amount of days left until the next temporal storm.
Fast forwards the time so that a temporal storm starts right away.
/player [playername] role admin.
/role [rolename] [roleproperty]
Display or modify
/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] privilege [grant|revoke] [privelegename]
Grant or revoke privileges from given role.
/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] landclaimmaxareas [value]
Set the max quantity of non-adjacent areas a player may claim. (default: 3)
/role [rolename] landclaimminsize [x y z]
Set the smallest cuboid a player may claim. (default: 6 by 6 by 6)
/player [playername] [whitelist|privilege|role|entity|stats|gamemode|landclaimallowance|landclaimmaxareas]
Modify or display player data.
/player [playername] whitelist
See current whitelist mode of given player.
/player [playername] whitelist on
Adds a player to a server whitelist.
/player [playername] privilege
Lists the players current privileges.
/player [playername] privilege [grant|revoke] [privilegename]
Grants or revokes given privilege for this player.
/player [playername] role
Shows the players current privilege role. (default: suplayer)
/player [playername] role [rolename]
Sets the players current privilege role. (default: suplayer)
/player [playername] stats
Shows a summary of the players current privileges.
/player [playername] gamemode [0..4 or partially/fully written game mode name]
Shows or sets the players current game mode.
/player [playername] landclaimallowance [0..9999]
Shows or sets a player specific extra land claim allowance, independent of the allowance set by the role. (default: 0)
/player [playername] landclaimmaxareas [0..9999]
Shows or sets a player specific extra land claim areas allowance, independent of the allowance set by the role. (default: 0)
/player [playername] allowcharselonce
Allows the player to re-select their class after doing so already.
/player [playername] entity
Shows info (position, satiety, health) about the player.
/player [playername] entity temp [value]
Set player's body temperature.
/player [playername] entity health [0.1-1]
Set player's health. (default: 1, making the health by 100% of full health bar)
/player [playername] entity maxhealth [0.1-999]
Set player's max health.
/player [playername] entity satiety [0.1-1]
Set player's satiety. (default: 1, making the satiety by 100% of full satiety bar)
/player [playername] entity maxoxygen [int]
Set player's maximum oxygen. Integer is the length of the oxygen timer in milliseconds. (default: 20000, or 20 seconds)
Shows the world seed
Protip: Do not actually type the [ ] shown in this command syntax, that is intended only to show which values can be changed!
See dedicated page on World Configuration
Spawn, remove, and count entities (item drops, creatures, etc).
/entity spawn [entitytype]
Spawn an entity by type. Valid types can be found in the survival mod assets folder /entities.
/entity countbytype [entitytype]
Count how many entities of a given type exist.
entitytypecan use wildcards, eg
drifter-*counts drifters of any type.
/entity removebytype [entitytype]
Remove all entities of a given type.
entitytypecan use wildcards.
/entity remove [entitytype]
Short hand for /entity removebytype
/entity countbyclass [entityclass]
Count how many entities of a given class, such as
List a summary of all nearby entities, grouped by the first code part (wolf, sheep, etc)
/entity removebyclass [entityclass]
Remove all entities of a given class.
/entity listnearest [x y z] (ver-range) (hor-range)
Show a summary of all nearby entities at given range. If x/y/z coords are not supplied, the current player position is taken
/entity debug [0|1]
Enable entity debug mode, this will send continous debug information to all connected clients, which are displayed above the entity if the client used the command .clientConfig showEntitydebuginfo 1
/entity removebyid [entityid]
Used to remove one specific entity. Find the entity id by using ".clientConfig showEntityDebuginfo". Useful for removing a specific trader permanently, for instance.
Time related functions
Shows current time.
/time set [lunch|day|night|latenight|morning|latemorning|sunrise|sunset|afternoon|midnight|witchinghour]
Sets the clock to the given time of day.
/time set [time]
Sets the clock to the time given in hours, in 24 hour format. E.g. 1.5 is 1:30 AM.
/time setmonth [jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec]
Sets the calendar to the given month of the year
/time add [hours]:[minutes]
Adds given hours and minutes to the calendar.
/time speed [0-9999]
Shows or sets current game time speed (default 60).
/time hoursperday [0-9999]
Shows or sets the current hours per day (default 24).
Shows or set the calendar speed multiplier, changing the overall time speed in game (default 0.5, making the hours pass by 50% of normal speed).
|Time name||Time value|
Controls weather and wind patterns. If
/weatheris run by itself it prints the current weather stats.
/weather setprecip [-1..1|auto]
Running with no arguments returns the current precip. override, if one is set. Including an argument overrides the precipitation intensity and in turn also the rain cloud overlay.
-1removes all rain clouds,
0stops any rain but keeps some rain clouds, while
1causes the heaviest rain and full rain clouds. The server will remain indefinitely in that rain state until reset with
Stops any current rain by forwarding to a time in the future where there is no rain.
Toggles auto-changing weather patterns.
Lists all loaded weather patterns.
Transitions to a random weather pattern.
Quickly transitions to a random weather pattern.
/weather setev [event]
Sets a weather event globally.
/weather setevr [event]
Set a weather event only in the player's region.
/weather setw [lightbreeze|mediumbreeze|still|storm|strongbreeze]
Sets the current wind pattern to the given wind pattern.
/weather [set|seti] [weatherpattern]
Instantly sets the weather pattern to
Instantly sets the weather to a random weather pattern.
/weather setir [weatherpattern]
Instantly sets the weather to
[weatherpattern]only in the current region.
Server control and configuration
Modify or display the server config
/serverconfig maxchunkradius [integer]
Displays the max chunk radius. Sets the max chunk radius to the integer passed, which is the highest chunk radius a player may load.
/serverconfig maxclients [integer]
Displays the max clients. Sets the max number of connected clients to the integer passed.
/serverconfig password [string]
Sets the server password that is required to connect to the server. It may not contain spaces.
Removes the password protection.
/serverconfig antiabuse [Off|Basic|Pedantic]
Sets anti-abuse level, this protects against a range of malicious player operations, but is currently a work in progress.
/serverconfig allowpvp [bool]
Control allowing players to combat each other.
/serverconfig onlywhitelist [bool]
Control allowing only whitelisted players to connect to the server.
/serverconfig entityspawning [bool]
Control global entity spawning. Disabling it will cause no creatures to spawn (default: on).
/serverconfig tickrate [10-100]
Shows or sets the server tick rate. A higher tickrate makes the server more responsive. A lower tick rate has the opposite effect.
Control how many random update ticks per chunk should be executed.
/serverconfig defaultspawn [x y? z]
Shows or sets the default spawn point.
ycan be omitted to automatically use the surface position at given x/z location.
Sets the default spawn point to where the player is currently standing.
/serverconfig passtimewhenempty [bool]
Shows or sets if time should pass when the server has no connected players.
/serverconfig spawncapplayerscaling [0..1]
Helps to evenly distribute mob spawns around each player. A value of 0 means no extra mobs can spawn on increased player count, a value of 1 means a second player doubles the spawn cap, 3 players triple the spawn cap and so on (default: 0.75).
Show current server statistics, tick rate, memory usage, etc..
Announce a server wide message in all chat groups.
Sets the server's welcome message.
Stops the server.
Show various lists of information.
Show current connected clients.
Show current list of banned players.
Show list of all configured privilege roles.
Show list of all configured privileges.
Whether or not to allow external lan connections to the server (temporary runtime setting for non dedicated servers)
Utility and Debug Tools
/moddb [install|remove|list|search] [modid]
ModDB utility. To install and remove mods.
Applies block and item remapping in order to upgrade to a new version of the game
Creates a full copy of the current save game and stores it in the backups folder. Can be run without pausing the server. If no filename is supplied, it will generate one based on the current date and time
Block id remapper tools. Useful to fix broken blocks after removing/updating custom blocks.
/forceloadchunks x1 z1 x2 z2 [sendtoclient]
Tells the server to load given area and prevents unloading. If the Boolean
sendtoclientis added it will also forcefully send all these chunks to the client.
Toggles whether to send any new chunks to the client. Forced chunks are still loaded.
Toggles whether the server should automatically unload chunks that are no longer in range of any players and also send chunk unload commands to the clients.
Reloads all server mods that support reloading.
Current chunk generation info.
Tells when the rain should stop.
Room registration debug tools.
Lists all rooms the player is in.
Highlights the space of rooms with color. Unsuitable rooms are in red, eligible rooms are in green.
Removes room highlighting.
Information about the current save game
Shows the world identifier
Shows the world seed
Shows the game version in which the world was created
Shows the world size
Various debug commands
/debug logticks [milliseconds]
If a server tick required more then supplied milliseconds to process, a breakdown of that tick will be logged to the server-main.txt
Displays a summary of ticking blocks and entities are currently registered.
/debug tickhandlers dump [gtblock|gtentity|dcblock|sdcblock|dcentity]
Dumps a complete list of all tick/callback listeners to the server-debug.txt
Display some information on the current chunk the player is in
Forcefully resends the current chunk the player is in
Forcefully completely relights the chunk the player is in and all of them within one chunk of it
/debug helddurability [value]
Sets the durability of the currently held item
/debug heldtemp [value]
Sets the temperature of the currently held item
/debug heldstattr key [int|bool|string|tree|double|float] [value]
Sets the attribute for the currently held item (e.g.
/debug heldstattr key type normal-genericfor chest-east).
/debug setgen [value]
Set the generation of the currently looked entity
/debug printcl [all|missing]
Print a full list of all/missing collectible codes to the server-debug.txt
Exports a full list of all block codes to the server-main.txt
Lists the blocks that consume most block ids to the server-main.txt
Change privilege debugging mode
Toggles network benchmarking
Print a chunk map
Rebuild land claim partitions
Currently chunks in generation queue
Print octagon points
Compact a large object heap
Main thread state
Kill the main thread
/debug clrplrinv [player]
Clear the player inventory on connect
World generation tools
Change automatic worldgen mode
Generate trees mode
/wgen testmap [climate|forest|wind|gprov|landform|ore]
Generates a sample 512x512 map using a fixed worldseed as a png, saved where the game executables is located. May need to be administrator to work properly.
/wgen testmap climater [hot|warm|cool|icy]
Same as /wgen testmap climate, but you can choose the temperature preset
/wgen testmap oretopdistort
Ore top distort maps
/wgen testmap rockstrata
Rock strata maps
/wgen genmap [climate|forest|wind|gprov|landform|ore]
Same as testmap? (Need more info)
/wgen region [climate|ore|forest|wind|gprov|gprovi|landform|landformi|rockstrata]
Generates a map of the current region (16x16 chunks) using the save game worldseed as a png, saved where the game executables are located. May need to be administrator to work properly.
rockstratais based on the rockstrata JSON file at Vintagestory\assets\survival\worldgen. Limestone is 6, chalk is 8, bauxite is 9, slate is 10.
/wgen regions [radius] [ore] [orename]
Show availability of ore maps for ore in the regions. Radius can only be up to 2 - larger radius doesn't seem to show more. May require increasing viewing range.
/wgen pregen [radius]
Pregenerate chunks around the player
/wgen regen [radius]
Regenerate chunks around the player
/wgen regenr [raduis]
Regenerate chunks around the player with random seed
/wgen regenc [radius]
Regenerate chunks around the world spawn
/wgen regenrc [radius]
Regenerate chunks around the world spawn with random seed
/wgen delrock [radius]
Remove rocks around the player - radius is ignored? Looks like 160x160 box centered on player. Will cause server overload, make take several minutes for server to recover
/wgen delrockc [radius]
Remove rocks around the world spawn - Does not work
/wgen del [radius]
Remove chunks around the player
Spawn tree line
/wgen pos [ymax|coords|latitude|structures|height|cavedistort|gprov|rockstrata|landform|climate]
Shows info at the current position
/wgen testnoise [octaves]
Create a server side macro that can execute one or more commands
/macro addcmd [command]
Add a command to a temporary macro.
/macro setcmd [command]
Override a command to a temporary macro.
Sets the syntax help info displayed when using
Sets the description text displayed when using
Sets the privilege required to execute this command, e.g. controlserver if only for admins or, build for any player with build rights.
Shows the contents of the temporary macro currently being defined by above commands.
/macro save [name]
Saves the temporary macro defined by above command to given command name.
Shows a list of all saved macros.
/macro show [name]
Shows the contents of a saved macro.
/macro delete [name]
Deletes a previously saved macro.
/macro discard [name]
Discards the temporary macro.
Export a list of block and item translations and add placeholders for missing translations.
|Template:Navbox/modding/code require C# coding|
Advanced Blocks | Advanced Items | Item-Block Interactions | Block Behavior | Block Entities | Particle Effects | World Access | Inventory Handling | Chat Commands | GUIs | Server-Client Networking | Monkey patching (Harmony)
|Workflows & Infrastructure|