List of server commands: Difference between revisions

From Vintage Story Wiki
(Added /serverconfig allowpvp, as requested in Discord. Order in list may need to be changed in agreement with actual config file order.)
(move large commands to sub pages)
Line 6: Line 6:


=== Land claiming === <!--T:3-->
=== Land claiming === <!--T:3-->
* <code>/land [claim|free|info|list]</code><br />Claim an area of the world where only you can build or use blocks in.
[[List of server commands/land]]
 
* <code>/land list</code><br />Displays a list of the claims that you made so far, you can use displayed index number to modify it, see below.
* <code>/land info</code><br />Display information on the claimant of the current position, if there is any.
* <code>/land free [index]</code><br />Deletes a claim of yours.
 
* <code>/land claim [load|new|grant|revoke|gn|ge|gs|gw|gu|gd|start|end|add|plevel|fullheight|save|cancel]</code><br />Create or modify an existing claim.
** <code>/land claim load [0..999]</code><br />Load an existing claim for modifying. Use index number as shown in /land list to select which claim.
** <code>/land claim new</code><br />Create a new claim, also marks the start position.
** <code>/land claim grant [playername] [use|all]</code><br />Grant given player access to your claim. 'use' for only use/interact rights, 'all' for use and place/break block rights.
** <code>/land claim revoke [playername]</code><br />Revoke a previously granted privilege to given player on your claim.
** <code>/land claim grantgroup [groupname] [use|all]</code><br />Grant given player group access to your claim. 'use' for only use/interact rights, 'all' for use and place/break block rights.
** <code>/land claim revokegroup [groupname]</code><br />Revoke a previously granted privilege to given player group on your claim.
** <code>/land claim allowuseeveryone [true|false]</code><br />Grant or Revoke use access to all players
** <code>/land claim start</code><br />Mark a start position for a cuboidal area to be claimed.
** <code>/land claim end</code><br />Mark an end position for a cuboidal area to be claimed.
** <code>/land claim [gn|ge|gs|gw|gu|gd] [-99..99]</code><br />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.
** <code>/land claim [sn|se|ss|sw|su|sd] [-99..99]</code><br />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.
** <code>/land claim add</code><br />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.
** <code>/land claim fullheight</code><br />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.
** <code>/land claim save [description]</code><br />Save current claim modifications and stop editing the current claim.
** <code>/land claim cancel</code><br />Discard all modifications to this claim.


=== Groups === <!--T:4-->
=== Groups === <!--T:4-->
* <code>/group [create|disband|rename|invite|acceptinvite|leave|list|kick|op|deop]</code><br />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.
[[List of server commands/group]]
** <code>/group create [groupname]</code><br/>Creates a new player group, own chat channel. While in the this group's chat channel:
** <code>/group invite [playername]</code><br/>Invites a player to this group
** <code>/group acceptinvite [groupname]</code><br />Accept an invite to join the group
** <code>/group leave</code><br />Leaves this player group.
** <code>/group list</code><br />Lists all groups you are currently in.
** <code>/group rename newgroupname</code><br />Renames the group.
** <code>/group kick [playername]</code><br />Removes a player from the group.
** <code>/group op [playername]</code><br />Grants operator status to this player, which allows them to invite other players.
** <code>/group deop [playername]</code><br />Revokes operator status from this player.
** <code>/group disband</code><br />Destroy a player group. Must be owner to perform this command.


=== Other === <!--T:5-->
=== Other === <!--T:5-->
Line 53: Line 22:
* <code>/giveitem [itemcode] [quantity] [toplayername]</code><br />Same as above but for items
* <code>/giveitem [itemcode] [quantity] [toplayername]</code><br />Same as above but for items


* <code>/gamemode [0..4|guest|survival|creative|spectator]</code><br />Mode names can be shortened to any length. Sets your game mode:
[[List of server commands/gamemode]]
** <code>0|guest</code> Guest mode - Cannot place/remove any blocks but can interact with them
** <code>1|survival</code> Survival mode - Can slowly break/place blocks. Can die. Cannot fly. Survival inventory.
** <code>2|creative</code> Creative mode - Access to all blocks through the creative inventory. Instant block breaking. Cannot die. Can fly.
** <code>3|spectator</code> Spectator mode - Cannot place/remove blocks and cannot interact with anything, but can fly.
 
* <code>/gamemode [playername] [0..4]</code><br />Sets the gamemode for given player.


* <code>/tp [coordinates]</code><br />Teleport yourself to a different position.
[[List of server commands/tp]]
** <code>/tp x y z</code><br />Teleports the player to given pretty coordinate visible from the pretty coordinate box.
** <code>/tp =x =y =z</code><br />Teleports the player to given absolute coordinate visible from the debug screen on ALT + F3.
** <code>/tp ~x ~y ~z</code><br />Teleports player by a given relative distance, i.e. teleport ~1 ~0 ~0 will teleport the player one block in x direction.
 
* <code>/tp [playername] [coordinates]</code><br />Teleport given player to a different position.
 
* <code>/tp [playername]</code><br/ >Teleport yourself to given player.


* <code>/ban [reason]</code><br />Ban a player.
* <code>/ban [reason]</code><br />Ban a player.
Line 81: Line 37:
*<code>/op [playername]</code> Shorthand for <code>/player [playername] role admin</code>
*<code>/op [playername]</code> Shorthand for <code>/player [playername] role admin</code>


*<code>/role [rolename] [roleproperty]</code><br /> Display or modify <code>[roleproperty]</code> on role <code>[rolename]</code>.
[[List of server commands/role]]
**<code>/role [rolename] spawnpoint [x] [y?] [z]</code> <br />Configure a role specific spawn point. Any player that has this role will spawn at this location.
[[List of server commands/player]]
**<code>/role [rolename] privilege [grant|revoke] [privelegename]</code><br />Grant or revoke privileges from given role.
**<code>/role [rolename] landclaimallowance [value]</code><br />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)
**<code>/role [rolename] landclaimmaxareas [value]</code><br /> Set the max quantity of non-adjacent areas a player may claim. (default: 3)
**<code>/role [rolename] landclaimminsize [x y z]</code><br /> Set the smallest cuboid a player may claim. (default: 6 by 6 by 6)
 
*<code>/player [playername] [whitelist|privilege|role|entity|stats|gamemode|landclaimallowance|landclaimmaxareas]</code><br />Modify or display player data.
**<code>/player [playername] whitelist</code><br>See current whitelist mode of given player.
**<code>/player [playername] whitelist on</code><br /> Adds a player to a server whitelist.
**<code>/player [playername] privilege</code><br />Lists the players current privileges.
**<code>/player [playername] privilege [grant|revoke] [privilegename]</code><br />Grants or revokes given privilege for this player.
**<code>/player [playername] role</code><br />Shows the players current privilege role. (default: suplayer)
**<code>/player [playername] role [rolename]</code><br />Sets the players current privilege role. (default: suplayer)
**<code>/player [playername] stats</code><br />Shows a summary of the players current privileges.
**<code>/player [playername] gamemode [0..4 or partially/fully written game mode name]</code><br />Shows or sets the players current game mode.
**<code>/player [playername] landclaimallowance [0..9999]</code><br />Shows or sets a player specific extra land claim allowance, independent of the allowance set by the role. (default: 0)
**<code>/player [playername] landclaimmaxareas [0..9999]</code><br /><span>Shows or sets a player specific extra land claim areas allowance<span>, independent of the allowance set by the role. (default: 0)


==World Control== <!--T:7-->
==World Control== <!--T:7-->
Line 104: Line 44:


=== World Config ===
=== World Config ===
*<code>/worldconfig [config]</code><br />Modify current play style. Most of these settings require a restart of the server to take effect.
[[List of server commands/worldconfig]]
**<code>/worldconfig worldEdge [blocked|traversable]</code><br />Wether you can fall off the world edge (default: traversable)
**<code>/worldconfig globalTemperature [0-5]</code><br />Sets the global temperature multiplier for world generation. Does not affect already generated chunks. Useful values are between 0.1 and 5, where 0.1 is super cold, and 5 is super hot. (default: 1)
**<code>/worldconfig globalPrecipitation [0-5]</code><br /> Sets the global rainfall multiplier for world generation. Does not affect already generated chunks. Useful values are between 0.1 and 5, where 0.1 is super dry and 5 is super wet (default: 1)
**<code>/worldconfig microblockChiseling [true|false]</code><br /> Whether to allow microblock chiseling (default: false)
**<code>/worldconfig temporalStorms [off|veryrare|rare|somtimes|often|veryoften]</code><br /> How frequent temporal storms should be (default: sometimes)
**<code>/worldconfig temporalStability [false|true]</code><br /> Whether or not the temporal stability mechanic should apply (default: true)
**<code>/worldconfig deathPunishment [drop|keep]</code><br /> Whether to drop your inventory upon death (default: drop)
**<code>/worldconfig graceTimer [0-9999]</code><br /> How many days it takes for monster to appear (default: 5)
**<code>/worldconfig creatureHostility [aggressive|passive|off]</code><br /> Set default creature hostility (default: aggressive)
**<code>/worldconfig creatureStrength [0-99]</code><br /> Sets the creature damage multiplier (default: 1)
**<code>/worldconfig playerHealthPoints [1-999]</code><br /> Set the players base health points (default: 15)
**<code>/worldconfig playerHungerSpeed [0-10]</code><br /> Set the players hunger rate multiplier (default: 1)
**<code>/worldconfig playerMoveSpeed [0-10]</code><br /> Set the players move speed multiplier (default: 1.5)
**<code>/worldconfig blockGravity [sandgravel|sandgravelsoil]</code><br /> Set the block gravity behavior for either just sand and gravel or additionally also soil (default: sandgravel)
**<code>/worldconfig foodSpoilSpeed [0-10]</code><br /> Set the spoilage rate multiplier of all perishable foods, e.g. 0.5 means all food lasts twice as long (default: 1)
**<code>/worldconfig saplingGrowthDays [0-999]</code><br /> Set the amount of days a tree takes to grow on average (default: 8)
**<code>/worldconfig toolDurability [0-99]</code><br /> Set the tool durability multiplier, e.g. 2 means all tools have double durability. (default: 1)
**<code>/worldconfig toolMiningSpeed [0-99]</code><br /> Set the tool mining speed multiplier, e.g. 2 means all tools have break blocks twice as fast. (default: 1)
**<code>/worldconfig allowCoordinateHud [true|false]</code><br /> Whether or not players are allowed to used the coordinate hud. (default: true)
**<code>/worldconfig allowMap [true|false]</code><br /> Whether or not players are allowed to used the world map. (default: true)
**<code>/worldconfig allowLandClaiming [true|false]</code><br /> Whether or not players are allowed to use the land claiming system. (default: true)
**<code>/worldconfig surfaceCopperDeposits [0-5]</code><br /> Set chance of surface copper spawning for each chunk column (default: 0.1)
**<code>/worldconfig surfaceTinDeposits [0-5]</code><br /> Set chance of surface tin spawning for each chunk column (default: 0.07)


=== Entities ===
=== Entities ===
<!--T:11-->
<!--T:11-->
*<code>/entity [spawn|countbytype|removebytype|countbyclass|removebyclass|listnearest|debug]</code><br /> Spawn, remove, and count entities (item drops, creatures, etc).
[[List of server commands/entity]]
**<code>/entity spawn [entitytype]</code><br /> Spawn an entity by type. Valid types can be found in the survival mod assets folder /entities.
**<code>/entity countbytype [entitytype]</code><br /> Count how many entities of a given type exist. <code>entitytype</code> can use wildcards, eg <code>drifter-*</code> counts drifters of any type.
**<code>/entity removebytype [entitytype]</code><br /> Remove all entities of a given type. <code>entitytype</code> can use wildcards.
**<code>/entity countbyclass [entityclass]</code><br /> Count how many entities of a given class, such as <code>EntityItem</code> or <code>EntityAgent</code>, exist.
**<code>/entity removebyclass [entityclass]</code><br /> Remove all entities of a given class.
**<code>/entity listnearest [x y z] (ver-range) (hor-range)</code><br /> Show a summary of all nearby entities at given range. If x/y/z coords are not supplied, the current player position is taken
**<code>/entity debug [0|1]</code><br /> 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 ===
=== Time ===
*<code>/time [set|get|speed]</code><br /> Time related functions
[[List of server commands/time]]
**<code>/time</code><br /> Shows current time.
**<code>/time set [lunch|day|night|latenight|morning|latemorning|sunrise|sunset|afternoon|midnight|witchinghour]</code><br /> Sets the clock to the given time of day.
**<code>/time set [time]</code><br /> Sets the internal calendar to given time.
**<code>/time add [hours:minutes]</code><br /> Adds given hours and minutes to the internal calendar.
**<code>/time speed [0-9999]</code><br /> Shows or sets current game time speed (default 60).
**<code>/time hoursperday [0-9999]</code><br /> Shows or sets the current hours per day (default 24).


=== Weather ===
=== Weather ===
*<code>/weather [acp|lp|t|c|setw|set|seti|setirandom|setir]</code><br /> Controls weather and wind patterns. If <code>/weather</code> is run by itself it prints the current weather stats.
[[List of server commands/weather]]
**<code>/weather acp</code><br /> Toggles autochanging weather patterns.
**<code>/weather lp</code><br /> Lists all loaded weather patterns.
**<code>/weather t</code><br /> Transitions to a random weather pattern.
**<code>/weather c</code><br /> Quickly transitions to a random weather pattern.
**<code>/weather setw [lightbreeze|mediumbreeze|still|storm|strongbreeze]</code><br /> Sets the current wind pattern to the given wind pattern.
**<code>/weather [set|seti] [weatherpattern]</code><br /> Instantly sets the weather pattern to <code>weatherpattern</code>.
**<code>/weather setirandom</code><br /> Instantly sets the weather to a random weather pattern.
**<code>/weather setir [weatherpattern]</code><br /> Instantly sets the weather to <code>[weatherpattern]</code> only in the current region.


==Server control/configuration== <!--T:12-->
==Server control/configuration== <!--T:12-->
Line 175: Line 71:
**<code>/list privileges</code><br /> Show list of all configured privileges</li>
**<code>/list privileges</code><br /> Show list of all configured privileges</li>


 
[[List of server commands/serverconfig]]
*<code>/serverconfig [config]</code><br />Modify or display the server config <code>[config]</code>
**<code>/serverconfig maxchunkradius [integer]</code><br />Displays the max chunk radius. Sets the max chunk radius to the integer passed, which is the highest chunk radius a player may load.
**<code>/serverconfig maxclients [integer]</code><br /> Displays the max clients. Sets the max number of connected clients to the integer passed.
**<code>/serverconfig password [string]</code><br />Sets the server password that is required to connect to the server. It may not contain spaces.
**<code>/serverconfig nopassword</code><br />Removes the password protection.
**<code>/serverconfig antiabuse [Off|Basic|Pedantic]</code><br />Sets anti-abuse level, this protects against a range of malicious player operations, but is currently a work in progress.
**<code>/serverconfig allowpvp [bool]</code><br />Control allowing players to combat each other.
**<code>/serverconfig onlywhitelist [bool]</code><br />Control allowing only whitelisted players to connect to the server.
**<code>/serverconfig entityspawning [bool]</code><br />Control global entity spawning. Disabling it will cause no creatures to spawn (default: on)
**<code>/serverconfig tickrate [10-100]</code><br />Shows or sets the server tick rate. A higher tickrate makes the server more responsive. A lower tick rate has the opposite effect.
**<code>/serverconfig blockTickSamplesPerChunk</code><br />Control how many random update ticks per chunk should be executed.
**<code>/serverconfig defaultSpawn [x y? z]</code><br />Shows or sets the default spawn point. <code>y</code> can be omitted to automatically use the surface position at given x/z location.
**<code>/serverconfig setspawnhere</code><br />Sets the default spawn point to where the player is currently standing


==Utility / Debug Tools== <!--T:13-->
==Utility / Debug Tools== <!--T:13-->
Line 203: Line 86:
*<code>/cit</code><br /> Current chunk generation info
*<code>/cit</code><br /> Current chunk generation info


*<code>/debug [logticks|tickhandlers|ci|cs|cr]</code><br />Various debug commands
[[List of server commands/debug]]
**<code>/debug logticks [milliseconds]</code><br />If a server tick required more then supplied milliseconds to process, a breakdown of that tick will be logged to the server-main.txt
**<code>/debug tickhandlers</code><br /> Displays a summary of ticking blocks and entities are currently registered.
**<code>/debug tickhandlers dump [gtblock|gtentity|dcblock|sdcblock|dcentity]</code><br /> Dumps a complete list of all tick/callback listeners to the server-debug.txt.
**<code>/debug ci</code><br /> Display some information on the current chunk the player is in
**<code>/debug cs</code><br /> Forcefully resends the current chunk the player is in
**<code>/debug cr</code><br /> Forcefully completely relights the current chunk the player is in


*<code>/wgen</code> World generation tools. Some examples
[[List of server commands/wgen]]
**<code>/wgen pos climate</code> Shows climate info at the current position
**<code>/wgen testmap climate</code> Generates a 512x512 example climate map as a png, saved where the game executables is.


*<code>/macro [addcmd|setcmd|syntax|desc|priv|save|delete|show|list]</code><br />Create a server side macro that can execute one or more commands
[[List of server commands/macro]]
**<code>/macro addcmd [command]</code><br /> Add a command to a temporary macro.
**<code>/macro setcmd [command]</code><br /> Override a command to a temporary macro.
**<code>/macro [syntax]</code><br /> Sets the syntax help info displayed when using <code>/help [name]</code>.
**<code>/macro [desc]</code><br /> Sets the description text displayed when using <code>/help [name]</code>
**<code>/macro [priv]</code><br /> Sets the privilege required to execute this command, e.g. '''controlserver''' if only for admins or, '''build''' for any player with build rights.
**<code>/macro show</code><br />Shows the contents of the temporary macro currently being defined by above commands.
**<code>/macro save [name]</code><br />Saves the temporary macro defined by above command to given command name.
**<code>/macro list</code><br />Shows a list of all saved macros.
**<code>/macro show [name]</code><br />Shows the contents of a saved macro.
**<code>/macro delete [name]</code><br />Deletes a previously saved macro.
**<code>/macro discard [name]</code><br />Discards the temporary macro.


</translate>
</translate>

Revision as of 14:18, 11 April 2020

Multiplayer Commands for Players

Land claiming

List of server commands/land

Groups

List of server commands/group

Other

  • /kill
    Kills the player.

Commands for Moderators and Admins

  • /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

List of server commands/gamemode

List of server commands/tp

  • /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

List of server commands/role List of server commands/player

World Control

  • /seed
    Shows the world seed

World Config

List of server commands/worldconfig

Entities

List of server commands/entity

Time

List of server commands/time

Weather

List of server commands/weather

Server control/configuration

  • /stats
    Show current server statistics ,tick rate, memory usage, etc..
  • /announce
    Announce a server wide message in all chat groups.
  • /welcome
    Sets the server's welcome message
  • /stop
    Stops 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

List of server commands/serverconfig

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 z2 [sendtoclient]
    Tells the server to load given area and prevents unloading. If the boolean sendtoclient is added it will also forcefully send all these chunks to the client.
  • /sendchunks [0|1]
    Toggles whether to send any new chunks to the client. Forced chunks are still loaded.
  • /chunkunload [0|1]
    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.
  • /reloadmods
    Reloads all server mods that support reloading.
  • /cit
    Current chunk generation info

List of server commands/debug

List of server commands/wgen

List of server commands/macro