List of server commands

From Vintage Story Wiki

Multiplayer Commands for Players

Land claiming

  • /land [claim|free|info|list]
    Claim an area of the world where only you can build or use blocks in
  • /land list
    Displays a list of the claims that you made so far, you can use displayed index number to modify it, see below
  • /land info
    Display information on the claimant of the current position, if there is any
  • /land free [index]
    Deletes a claim of yours
  • /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 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 shrunkby 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

Groups

  • /group [create|disband|rename|invite|acceptinvite|leave|list|kick|op|deop] 
    Create/manage or destrory 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 groups chat channel:
    • /group invite [playername] Invites a player to this group
    • /group acceptinvite [groupname] Accept an invite to join the group
    • /group leave Leaves this player group
    • /group list Lists all groups you are currently in
    • /group rename newgroupname Renames the group
    • /group kick [playername] Removes a player from the group
    • /group op [playername] Grants operator status to this player, which allows him to invite other players.
    • /group deop [playername] Revokes operator status from this player.
    • /group disband Destroy a player group. Must be owner to perform this command

Other

  • /kill Kill yourself


Commands for Moderators and Admins

  • General
    • /help - List all commands

  • Player Control
    • /giveblock [blockcode] [quantity] [toplayername]
      Creates an itemstack of given block with given stack size to given player name. If player name is not set, the own player is targeted
    • /giveitem [itemcode] [quantity] [toplayername]
      Same as above but for items
    • /gamemode [0..4] 
      Sets your game mode:
      • 0 Guest mode - Cannot place/remove any blocks but can interact with them
      • 1 Survival mode - Can slowly break/place blocks. Can die. Cannot fly. Survival inventory.
      • 2 Creative mode - Access to all blocks through the creative inventory. Instant block breaking. Cannot die. Can fly.
      • 3 Spectator mode - Cannot place/remove blocks and cannot interact with anything. But can fly.
    • /gamemode [guest|creative|survival|spectator] 
      Another method of setting your game mode. You can also abbreviate the mode name to any length.
    • /gamemode [playername] [0..4]
      Sets the gamemode for given player
       
    • /tp [coordinates]
      Teleport yourself to a different position
      • /tp x y z
        Teleports player to given pretty coordinate (visible from the pretty coordinate box when pressing 'C')
      • /tp =x =y =z
        Teleports player to given absolute coordinate (visible from the debug screen on ALT + 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

    • /tp [playername]
      Teleport yourself to given player

    • /ban [reason] Ban a player
    • /unban [playername] Unban a player
    • /kick [reason] Kick a player
    • /clear Removes all items from your inventory

  • Privilege Control
    • /op [playername] Shorthand for /player [playername] role admin

    • /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|landclaimmaxareas|landclaimminsize] [value]
      Shows or sets the role specific land claiming values. 
      • landclaimallowance is 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)
      • landclaimmaxareas the max quantity of non adjacent-areasa a player may claim (default: 3)
      • landclaimminsize [x y z] the smallest cuboid a player may claim (default 6x6x6)

    • /player [playername] [whitelist|privilege|role|entity|stats|gamemode|landclaimallowance|landclaimmaxareas]
      See/Modify player related 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]
        Granks 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)


World Control

  • /seed Shows the world seed

  • /worldconfig Modify current play style
  • /entity [spawn|countbytype|removebytype|countbyclass|removebyclass|listnearest|debug]
    Add, remove, and count entities (item drops, creatures, etc).
    • /entity spawn (entitytype)
      Spawn an entity by type.
      The valid type names (as of 1.5.0.3) are:
      wolf-malewolf-femalesheep-bighorn-malesheep-bighorn-femalesheep-bighorn-lambpig-wild-pigletpig-wild-malepig-wild-femaledrifterstrawdummychicken-henchicken-babychicken-rooster
    • /entity countbytype (entitytype)
      Count how many entities of a given type exist.
    • /entity removebytype (entitytype)
      Remove all entities of a given type.
    • /entity countbyclass (entityclass)
      Count how many entities of a given class (such as entityitem or entityagent) exist.
    • /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 or 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

  • /time [set|get|speed]
    Time related functions
    • /time 
      Shows current time
    • /time set [lunch|day|night|latenight|morning|latemorning|sunrise|sunset|afternoon|midnight|witchinghour]
      Sets the internal clock to the given time of day
    • /time set [time]
      Sets the internal calendar to given time. Examples: /time set 12:00
    • /time add [hours:minutes]
      Adds given hours and minutes to the internal 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)

     

Server control/configuration

  • /stats Show current server statistics (tickrate, memory usage, etc.)
  • /announce Announce a server wide message in all chat groups
  • /welcome Sets the servers welcome message
  • /stop Shuts down the server
  • /list [clients|banned|role|privileges] 
    Show various lists of infos
    • /list clients Show current connected clients
    • /list banned Show current list of banned blayers
    • /list role Show list of all configured privilege roles
    • /list privileges Show list of all configured privileges
  • /serverconfig
    Modify the server config
    • /serverconfig maxchunkradius (integer)
      Displays the max chunk radius. If an integer value is passed it will set the max chunk radius, which is the highest view distance a player may have. Higher values require more RAM
    • /serverconfig maxclients (integer)
      Displays the maxclients. If an integer value is passed it will set the maxclients, which is the max concurrent players the server may have. Higher values requires more RAM and CPU
    • /serverconfig password (password without spaces)
      Sets the server password that is required to connect to the server
    • /serverconfig nopassword
      Removes the password protection
    • /serverconfig antiabuse (Off|Basic|Pedantic)
      Sets antiabuse level, this protects against a range of malicious player operations, but is currently pretty glitchy in the current state (v1.7)
    • /serverconfig onlywhitelist (bool)
      Wether or not to only allow whitelisted players to connect to the server
    • /serverconfig entityspawning (bool)
      Toggle on/off global entity spawning. Disabling it will cause no creatures to spawn (default: on)
    • /serverconfig tickrate [10-100]
      Shows or sets the server tickrate. A higher tickrate makes the server more responsive, but also costs more CPU. A lower tickrate has the opposite effect. (default: 30)
    • /serverconfig blockTickSamplesPerChunk
      Shows or sets many random ticks per chunk should be executed. Simply said, a higher value makes grass grow back faster. (default: 16)
    • /serverconfig defaultSpawn [x y? z]
      Shows or sets the default spawn point. y can be omitted to automatically use the surface position at given x/z location. Can supply a non numeric position to clear the default spawn point.


Utility / Debug Tools

  • /bir [getid|getcode|remap] Block id remapper tools. Useful to fix broken blocks after removing/updating custom blocks
  • /forceloadchunks x1 z1 x2 z1 [sendtoclient] Tells the server to load given area and prevents unloading. If "sendtoclient" is added it will also forcefully send all these chunks to the client.
  • /sendchunks [0 or 1] Toggles whether to send any new chunks to the client (force sending chunks are sent anyway)
  • /chunkunload [0 or 1] Toggels whether the server should automatically unload chunks that are no longer in range of any players (and thus also send chunk unload commands to the clients)
  • /reloadmods Reloads all server mods that support reloading
  • /cit Current chunk generation info
  • /debug [logticks|tickhandlers|ci|cs|cr] Various debug commands
    • /debug logticks [milliseconds] If a server tick required more then supplied milliseconds to process, a breakup of that tick will be logged to the server-main.txt
    • /debug tickhandlers Displays a summary of many 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. (gt = gametick, dc = delayed callback)
    • /debug ci Display some information on the current chunk the player resides in
    • /debug cs Forcefully resends the current chunk the player resides in
    • /debug cr Forcefully completely relights the current chunk the player resides in
  • /wgen World generation tools. Some examples
    • /wgen pos climate Shows climate info at the current position
    • /wgen testmap climate Generates a 512x512 example climate map as png, dropped where the game executables resides
    • /macro [addcmd|setcmd|syntax|desc|priv|save|delete|show|list]
      Create a server side macro that can execute one ore multiple commands
      • /macro addcmd [command without /]  Add a command to a temporary macro
      • /macro setcmd[command without /]  Set a command to a temporary macro (removes previously added ones)
      • /macro syntax Sets the syntax help info displayed when using /help
      • /macro desc Sets the description text displayed when using /help
      • /macro priv Sets the privilege required to execute this command, e.g. controlserver if only for admins or build for any player with build rights
      • /macro show Shows the contents temporary macro currently being defined by above commands
      • /macro save [name] Saves the temporary macro defined by above command to given command name
      • /macro list 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