List of client commands: Difference between revisions

From Vintage Story Wiki
mNo edit summary
m (Added game navbox.)
 
(65 intermediate revisions by 15 users not shown)
Line 1: Line 1:
<p>
<languages/>
<span style="font-size:14px;">Commands offer advanced features and configuration abilities for your game. There are really 2 lists of commands - Client and Server. The client is what displays your game on the screen, plays the sounds, takes in your controls and lets you connect to a game server (single or multiplayer). Client commands are those that usually just affect the appearance of your game, while server commands allows you to modify the world or configuration of the game.</span>
</p>


<p>
{{GameVersion|1.15}}
<span style="font-size:14px;">All commands are typed in the chat window in order to execute them. A client command always starts with a dot (.), while a server command always starts with a slash (/).</span>
<translate>
</p>
<!--T:1-->
'''Commands''' offer advanced features and configuration abilities for your game. There are really 2 lists of commands - Client and {{ll|List of server commands|Server}}. The client is what displays your game on the screen, plays the sounds, takes in your controls and lets you connect to a game server (single or multiplayer). Client commands are those that usually just affect the appearance of your game, while server commands allows you to modify the world or configuration of the game.


<p>
<!--T:2-->
<span style="font-size:14px;">Here is a list of the most useful ones.</span>
All commands are typed in the chat window in order to execute them. A client command always starts with a dot <code>.</code>, while a server command always starts with a slash <code>/</code>.
</p>


<!--T:14-->
See also: {{ll|List_of_server_commands|List of server commands}}


== Client Commands ==
</translate>
__FORCETOC__
<translate>
== Client Commands == <!--T:4-->
=== .blockitempngexport ===
*<code>.blockitempngexport [inv|all] [imageSize] [domain]</code><br /> Export all items and blocks as png images


=== .cam === <!--T:16-->
{{:List of client commands/cam{{#translation:}}}}


<p>
=== .c[louds] === <!--T:17-->
<strong><span style="font-size:14px;">Client Commands</span></strong>
*<code>.cdensity</code><br /> Set large and small cloud density
</p>
*<code>.cdensitylarge</code><br /> Set large cloud density
*<code>.cdensitysmall</code><br /> Set small cloud density
*<code>.clight</code><br /> Set Cloud lightness
*<code>.crand</code><br /> Set large and small cloud noise
*<code>.cviewdist</code><br /> Sets the cloud view distance. Will be reset when view distance in graphics settings are changed


<ul>
=== .chatsize === <!--T:18-->
<li>
*<code>.chatsize [width]/default [height]/default</code><br /> Set the chat dialog with custom width and/or height (default 400x160 [Depending on the interface])
<strong>.fog [density] [minfog]</strong><br>
Sets the density of the world fog. Useful&nbsp;<em>density</em> value are in the range of 0 and 0.1, default value is 0.004<br>
The <em>minfog&nbsp;</em>determines a minimum amount of fog that is always applied, default is 0<br>
&nbsp;
</li>
<li>
<strong>.cam [p|rp|start|stop|clear|load|save|alpha|tp]</strong><br>
The cinematic camera tool system.
<ul>
<li>
<strong>.cam p</strong>: Adds the current position to the list of places to visit
</li>
<li>
<strong>.cam rp</strong>: Removes the last added point&nbsp;
</li>
<li>
<strong>.cam clear</strong>: Removea all points
</li>
<li>
<strong>.cam start</strong>: Starts the cinematic camera, i.e. it will smoothly traverse all points
</li>
<li>
<strong>.cam stop</strong>: Stops the cinematic camera
</li>
<li>
<strong>.cam save</strong>: Exports the current list of points into your Clipboard (which you then can paste into any text editor)
</li>
<li>
<strong>.cam load [data]</strong>: Import supplied list of points&nbsp;
</li>
<li>
<strong>.cam tp [0 or 1]:&nbsp;</strong>Toggles whether to teleport you back to your previous position after the camera path has been completed
</li>
<li>
<strong>.cam alpha</strong> <strong>[0..1]</strong>: Modifies how the points are traversed by the camera (more rounded or more straight)<br>
&nbsp;
</li>
</ul>
</li>
<li>
<strong>.clearchat</strong><br>
Clears your chat history<br>
&nbsp;
</li>
<li>
<strong>.clientconfig [parameterName] [parameterValue]</strong><br>
Changes client configuration at runtime. Added at [https://www.vintagestory.at/blog.html/news/the-road-to-the-smithing-system-135-r83/ v1.3.5].<br>
<ul>
<li>
<strong>.clientconfig floatyGuis [1|0]</strong>: Enables/disables the experimental feature where chest dialogs float above the chests. (introduced [https://www.vintagestory.at/blog.html/news/the-vintage-operating-system-v151-r121/ v1.5.1]).
</li>
<li>
<strong>.clientconfig set showentitydebuginfo [0|1]</strong>: Displays arbitrary debug information above entities. (introduced [https://www.vintagestory.at/blog.html/news/smithing-chickens-v136-r86/ v1.3.6]).<br>
May require corresponding server command <strong>/entity debug 1</strong>
</li>
<li>
<strong>.clientconfig set ssaa [0.5|2]</strong>: Controls Sampling Pixel Rate.<br>
<strong>0.5</strong> value enables 0.5x Sampling rate and gives 50% performance gain at the cost of reduced graphics quality for ultra low end hardware.<br>
<strong>2</strong> value enables 2-4x Sampling rate. Very laggy but allows making massive screenshots (e.g. 7680x4320 pixels) and is supposed to be used with <strong>.clientconfig set scaleScreenshot 0</strong><br>
(introduced [https://www.vintagestory.at/blog.html/news/the-road-to-the-smithing-system-135-r83/ v1.3.5]).<br>
</li>
</ul><br>
</li>
<li>
<strong>.reloadmodels</strong><br>
Reloads all json models from assets/blockshapes. Can be used to quickly test new block shapes.<br>
Notice: The chunks are not redrawn, so you'd have to force a redraw e.g. by placing and removing a block<br>
&nbsp;
</li>
<li>
<strong>.viewdistance</strong><br>
Sets the viewing distance. Same as setting the view distance in the graphics settings but with no upper limit<br>
For viewing distances above 1000 blocks you also have to set the .zfar value above that.&nbsp;<br>
&nbsp;
</li>
<li>
<strong>.zfar [value]</strong><br>
Sets the clipping plane distance, everything beyond given value is no longer visible (default value is 1000)<br>
Very high values will cause Z-Fighting glitches<br>
&nbsp;
</li>
</ul>


== Server Commands ==
=== .clearchat === <!--T:19-->
*<code>.clearchat</code><br /> Clears your chat history


<ul>
=== .client+ === <!--T:20-->
        <li>
*<code>.client+</code><br /> Client+ configuration command
<strong>/ci</strong><br/>
Current chunk info<br/>
&nbsp;
</li>
<li>
<strong>/seed</strong><br>
Shows the world seed<br>
&nbsp;
</li>
<li>
<strong>/gamemode [0..4]&nbsp;</strong><br>
Sets your game mode:
<ul>
                        <li>
<strong>0 =&nbsp;Guest mode.</strong>&nbsp;Cannot place/remove any blocks but can interact with them
</li>
<li>
<strong>1 = Survival mode.&nbsp;</strong>Can slowly break/place blocks. Can die. Cannot fly. Survival inventory.
</li>
<li>
<strong>2 = Creative mode. </strong>Access to all blocks through the creative inventory. Instant block breaking. Cannot die. Can fly.
</li>
<li>
<strong>3 =&nbsp;Spectator&nbsp;mode.</strong>&nbsp;Cannot place/remove blocks and cannot interact with anything. But can fly.<br>
&nbsp;
</li>
</ul>
        </li>
<li>
<strong>/gamemode [playername] [0..4]</strong><br>
Sets the gamemode for given player<br>
&nbsp;
</li>
<li>
<strong>/clear</strong><br>
Removes all items from your inventory<br>
&nbsp;
</li>
        <li>
<strong>/kill</strong><br>
Kills&nbsp;yourself<br>
&nbsp;
</li>
        <li>
<strong>/pm (playername) (message)</strong><br/>
                Send a private message to a user (creates a temporary group)<br/>
&nbsp;
</li>
        <li>
<strong>/welcome (message)</strong><br/>
                Set the servers welcome message<br/>
&nbsp;
</li>


<li>
=== .clientconfig === <!--T:6-->
<strong>/clearentities</strong><br/>
{{:List of client commands/clientconfig{{#translation:}}}}
Kills all entities in the loaded chunks (except for players)<br/>
&nbsp;
</li>


<li>
=== .clientconfigcreate === <!--T:21-->
<strong>/entity</strong><br/>
*<code>.clientconfigcreate [name] [datatype] [value]</code><br /> Adds a new client configuration key that did not exist before.
Add, remove, and count entities (item drops, creatures, etc).<br/>
<br />
<ul>
*<code>.clientconfigcreate overheadLookAt bool true</code><br /> Adds a client configuration key that causes the player's seraph to look at the camera when it is in front of the character. Set to false to disable.
                        <li>
<strong>/entity spawn (entitytype)</strong><br/>
Spawn an entity by type.<br/>
The valid type names (as of 1.5.0.3) are:<br/>
<code>wolf-male</code>, <code>wolf-female</code>, <code>sheep-bighorn-male</code>, <code>sheep-bighorn-female</code>, <code>sheep-bighorn-lamb</code>, <code>pig-wild-piglet</code>, <code>pig-wild-male</code>, <code>pig-wild-female</code>, <code>drifter</code>, <code>strawdummy</code>, <code>chicken-hen</code>, <code>chicken-baby</code>, <code>chicken-rooster</code>
</li>
                        <li>
<strong>/entity countbytype (entitytype)</strong><br/>
Count how many entities of a given type exist.
</li>
                        <li>
<strong>/entity removebytype (entitytype)</strong><br/>
Remove all entities of a given type.
</li>
                        <li>
<strong>/entity countbyclass (entityclass)</strong><br/>
Count how many entities of a given class (such as <code>entityitem</code> or <code>entityagent</code>) exist.
</li>
                        <li>
<strong>/entity removebyclass (entityclass)</strong><br/>
Remove all entities of a given class.
</li>
                        <li>
<strong>/entity listnearest [x y z] (ver-range) (hor-range)</strong><br/>
This command exists, but is not completely implemented as of 1.5.0.3
</li>
</ul>
</li>


<li>
=== .clients === <!--T:22-->
<strong>/serverconfig</strong><br>
*<code>.clients</code><br /> List of connected players.
                Modify the server config<br/>
*<code>.clients ping</code><br /> List of connected players with their ping.
<ul>
                        <li>
<strong>/serverconfig maxchunkradius (integer)</strong><br/>
Displays the max chunk radius. If an integer value is passed it will set the max chunk radius.
</li>
                        <li>
<strong>/serverconfig maxclients (integer)</strong><br/>
Displays the maxclients. If an integer value is passed it will set the maxclients.
</li>
                        <li>
<strong>/serverconfig password</strong><br/>
Sets the server password
</li>
                        <li>
<strong>/serverconfig antiabuse (Off|Basic|Pedantic)</strong><br/>
Sets antiabuse level
</li>
                        <li>
<strong>/serverconfig onlywhitelist (bool)</strong><br/>
Sets or shows the onlywhitelist value
</li>
                        <li>
<strong>/serverconfig entityspawning (bool)</strong><br/>
Toggle on/off global entity spawning
</li>


=== .cp === <!--T:23-->
*<code>.cp [posi|aposi|apos|chat]</code><br /> Copy something to your clipboard
** <code>.cp posi</code><br /> The position below the player as an integer.
** <code>.cp aposi</code><br /> The absolute player position as an integer in the format <code>X=1,Y=1,Z=1</code>.
** <code>.cp apos</code><br /> The absolute player position as a float in the format <code>X=1.34,Y=1.34,Z=1.34</code>.
** <code>.cp chat</code><br /> The chat history.


</ul>
=== .debug === <!--T:7-->
* <code>.debug normalview</code><br /> Shows vertex normals instead textures, but does not discard transparent pixels.
* <code>.debug wireframe [value]</code><br /> Running <code>.debug wireframe</code> will give some help info.
** <code>entity</code><br /> Shows entity collision boxes.
** <code>chunk</code><br /> Shows chunk borders.
** <code>serverchunk</code><br /> Shows server chunk borders.
** <code>region</code><br /> Shows region borders.
** <code>blockentity</code><br /> Shows block entity borders e.g. of large gear.
** <code>ambsounds</code><br /> Shows ambient sound borders e.g. of flowing water.
* <code>.debug talk [value]</code><br /> Plays actions with the character's voice. Running <code>.debug talk</code> will give a list of values.
* <code>.debug [perceptioneffect|pc] [value]</code><br /> Applies effect.
** <code>drunk</code><br /> Makes player drunk.
** <code>damagedfreezing</code><br /> Applies a freezing effect to player.
* <code>.debug tofb [true|false]</code><br /> Toggle offscreen buffer.
* <code>.debug cmr</code><br /> Print a full list of color map rectangles to the client-main.txt.
* <code>.debug us</code><br /> Toggle unbind samplers mode.
* <code>.debug gl [true|false]</code><br /> Toggle OpenGL debug mode.
* <code>.debug uiclick</code><br /> Toggle UI Debug print interactions.
* <code>.debug discovery [value]</code><br /> Show a text on the screen as for lore books.
* <code>.debug soundsummary</code><br /> Print a count of loaded sounds.
* <code>.debug meshsummary</code><br /> Print a full list of block mesh sizes in kilobytes to client-debug.txt.
* <code>.debug chunksummary</code><br /> Print a count of total chunks, packed chunks and free pool objects.
* <code>.debug renderers</code><br /> Print a full list of renderers.
* <code>.debug exptexatlas [block|item|entity]</code><br /> Export an atlas(es) of blocks, items or entities.
* <code>.debug liquidselectable</code><br /> Toggle forced liquid selectable.
* <code>.debug relightchunk</code><br /> Recalculate sunlight and queue for redrawing in the chunk.
* <code>.debug fog [value]</code><br /> Sets fog density.
* <code>.debug fov [value]</code><br /> Sets field of view.
* <code>.debug wgen</code><br /> Print a rainfall and adjusted temperature values.
* <code>.debug redrawall</code><br /> Redraw all chunks.
* <code>.debug ci</code><br /> Display some information on the current chunk the player is in
* <code>.debug shake [value]</code><br /> Shake effect. Insert a higher negative value to remove the effect.
* <code>.debug recalctrav</code><br /> Recalculate traversability of all chunks.
* <code>.debug find [blockName]</code><br /> Specify all or part of the name of a block to find its coordinates.
{{ll|List of server commands/debug}} also exists. Use <code>.help debug</code> for more info on debug commands.


</li>
=== .edi === <!--T:24-->
*<code>.edi</code><br /> Show/Hide Extended information on debug screen, e.g. block lighting.


<li>
=== .exponepng === <!--T:25-->
<strong>/time [set|get|speed]</strong><br>
*<code>.exponepng [code|hand] [block|item] [size=100] [code]</code><br /> Export one item as png image.
Time related functions
<ul>
                        <li>
<strong>/time </strong><br>
Shows current time
</li>
<li>
<strong>/time set day</strong>&nbsp;<br>
Sets the internal clock to 9 am
</li>
<li>
<strong>/time set night</strong>&nbsp;<br>
Sets the internal clock to 7 pm
</li>
<li>
<strong>/time set [time]</strong><br>
Sets the internal calendar to given time. Examples: /time set 12:00
</li>
<li>
<strong>/time speed</strong>&nbsp;<br>
Shows current game time speed
</li>
<li>
<strong>/time speed 0-99999</strong>&nbsp;<br>
Sets the game time speed (default 60)<br>
&nbsp;
</li>
</ul>
        </li>
<li>
<strong>/tp [coordinates]</strong><br>
Teleport yourself to a different position
<ul>
<li>
<strong>/tp x y z</strong><br>
Teleports<strong>&nbsp;</strong>player to given pretty coordinate (visible from the pretty coordinate box when pressing 'C')
</li>
<li>
<strong>/tp =x =y =z</strong><br>
Teleports<strong>&nbsp;</strong>player to given absolute coordinate (visible from the debug screen on ALT + F3)
</li>
<li>
<strong>/tp ~x ~y ~z</strong><br>
Teleports player by a given relative distance (i.e. teleport ~1 ~0 ~0 will teleport the player one block in x direction)<br>
&nbsp;
</li>
</ul>
</li>
<li>
<strong>/tp [playername] [coordinates]</strong><br>
Teleport given player to a different position<br>
&nbsp;
</li>
<li>
<strong>/group&nbsp;[create|disband|rename|invite|acceptinvite|leave|list|kick|op|deop]&nbsp;</strong><br>
Create/manage or destrory a player group
<ul>
<li>
<strong>/group create [groupname]</strong>&nbsp;Creates a new player group (=own chat channel)<br>
While in the this groups chat channel:
<ul>
<li>
<strong>/group invite [playername]&nbsp;</strong>Invites a player to this group
</li>
<li>
<strong>/group acceptinvite [groupname]&nbsp;</strong>Accept an invite to join the group
</li>
<li>
<strong>/group leave</strong>&nbsp;Leaves this player group
</li>
<li>
<strong>/group list</strong>&nbsp;Lists all groups you are currently in
</li>
<li>
<strong>/group rename newgroupname</strong>&nbsp;Renames the group
</li>
<li>
<strong>/group kick [playername]</strong>&nbsp;Removes a player from the group
</li>
<li>
<strong>/group op [playername]</strong>&nbsp;Grants operator status to this player, which allows him to invite other players.
</li>
<li>
<strong>/group deop [playername] </strong>Revokes operator status from this player.
</li>
<li>
<strong>/group disband </strong>Destroy a player group. Must be owner to perform this command<br>
&nbsp;
</li>
</ul>
</li>
</ul>
</li>
<li>
<strong>Server Specific Tools</strong>
<ul>
<li>
<strong>/bir&nbsp;[getid|getcode|remap]</strong>&nbsp;Block id remapper tools. Useful to fix broken blocks after removing/updating custom blocks
</li>
<li>
<strong>/forceloadchunks x1 z1 x2 z1 [sendtoclient]&nbsp;</strong>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.
</li>
<li>
<strong>/sendchunks [0 or 1]</strong>&nbsp;Toggles whether to send any new chunks to the client (force sending chunks are sent anyway)
</li>
<li>
<strong>/reloadmods</strong>&nbsp;Reloads all server mods that support reloading<br>
&nbsp;
</li>
</ul>
</li>
<li>
<strong>Multiplayer Specific&nbsp;Tools</strong>
<ul>
<li>
<strong>/welcome</strong>&nbsp;Sets the servers welcome message
</li>
<li>
<strong>/stop</strong> Shuts down the server
</li>
<li>
<strong>/privgrp [playername] [groupname]</strong>&nbsp;Puts a player into a privilege group
</li>
<li>
<strong>/op [playername]</strong>&nbsp;Shorthand for <strong>/privgrp Admin [playername]</strong>
</li>
<li>
<strong>/addarea</strong>&nbsp;Add a build permission area
</li>
<li>
<strong>/delarea </strong>Remove a build permission area
</li>
<li>
<strong>/addpriv&nbsp;</strong>Add a privilege to a permission group
</li>
<li>
<strong>/removepriv </strong>Remove a privilge from a permission group
</li>
<li>
<strong>/ban [reason]</strong>&nbsp;Ban a player
</li>
<li>
<strong>/unband&nbsp;[playername]</strong> Unban&nbsp;a player
</li>
<li>
<strong>/kick[reason]</strong> Kick a player
</li>
</ul>
</li>
</ul>
<p>
&nbsp;
</p>


<ul>
=== .fbdeb === <!--T:26-->
<li>
*<code>.fbdeb</code><br /> Toggle Framebuffer/WOIT Debug mode
<strong>/macro [addcmd|setcmd|syntax|desc|priv|save|delete|show|list]</strong><br>
 
Create a server side macro that can execute one ore multiple commands
=== .fountain === <!--T:27-->
<ul>
*<code>.fountain [quantity] [quad|cube]</code><br /> Toggle Particle fountain.
<li>
 
<strong>/macro addcmd [command without /]</strong>&nbsp; Add a command to a temporary macro
=== .freemove === <!--T:28-->
</li>
*<code>.freemove</code><br /> Toggle Freemove
<li>
 
<strong>/macro setcmd[command without /]</strong>&nbsp; Set a command to a temporary macro (removes previously added ones)
=== .gencraftjson === <!--T:29-->
</li>
*<code>.gencraftjson</code><br /> Copies a snippet of json from your currently held item usable as a crafting recipe ingredient
<li>
 
<strong>/macro syntax</strong>&nbsp;Sets the syntax help info displayed when using /help
=== .gui === <!--T:30-->
</li>
*<code>.gui</code><br /> Hide/Show all GUIs
<li>
 
<strong>/macro desc</strong>&nbsp;Sets the description text displayed when using /help
=== .help === <!--T:31-->
</li>
*<code>.help</code><br /> Display list of available client commands
<li>
 
<strong>/macro priv</strong>&nbsp;Sets the privilege required to execute this command, e.g. <em>controlserver</em> if only for admins or <em>build</em> for any player with build rights
=== .lockfly === <!--T:32-->
</li>
*<code>.lockfly</code><br /> Locks a movement axis during flying/swimming
<li>
*<code>.lockfly 1</code><br /> Locks a movement axis to X
<strong>/macro show</strong>&nbsp;Shows the contents temporary macro currently being defined by above commands
*<code>.lockfly 2</code><br /> Locks a movement axis to Y
</li>
*<code>.lockfly 3</code><br /> Locks a movement axis to Z
<li>
 
<strong>/macro save [name]</strong>&nbsp;Saves the temporary macro defined by above command to given command name
=== .logticks === <!--T:33-->
</li>
*<code>.logticks</code><br /> Toggle Tick profiling. Won't log ticks below the threshold.
<li>
 
<strong>/macro list</strong>&nbsp;Shows a list of all saved macros
=== .map=== <!--T:34-->
</li>
*<code>.purgedb</code><br /> Purges map DB.
<li>
*<code>.redraw</code><br /> Redraws map.
<strong>/macro show [name]&nbsp;</strong>Shows the contents of a saved macro
*<code>.worldmapsize [mapHeight] [mapWidth]</code><br /> Sets world map size.
</li>
 
<li>
=== .moon === <!--T:35-->
<strong>/macro delete [name]</strong>&nbsp;Deletes a previously saved macro
*<code>.moon</code><br /> Prints the current moon phase.
</li>
 
<li>
=== .movespeed === <!--T:36-->
<strong>/macro discard [name]</strong> Discards the temporary macro
*<code>.movespeed</code><br /> Set Movespeed
</li>
 
</ul>
=== .music === <!--T:37-->
</li>
*<code>.music</code><br /> Shows current music track
</ul>
 
<p>
=== .netbenchmark === <!--T:38-->
&nbsp;
*<code>.netbenchmark</code><br /> Toggles network benchmarking
</p>
 
=== .noclip === <!--T:39-->
*<code>.noclip</code><br /> Toggle noclip
 
=== .online === <!--T:40-->
*<code>.online</code><br /> Prints list of online players.
*<code>.online ping</code><br /> Prints list of online players with their ping.
 
=== .pastemode === <!--T:41-->
*<code>.pastemode</code><br /> Set the chats paste mode. If set to multi pasting multiple lines will produce multiple chat lines.
 
=== .recomposechat === <!--T:42-->
*<code>.recomposechat</code><br /> Recompose chat dialogs
 
=== .reconnect === <!--T:43-->
*<code>.reconnect</code><br /> Reconnect to server
 
=== .recordingmode === <!--T:44-->
*<code>.recordingmode</code><br /> Makes the game brighter for recording (Sets gamma level to 1.1 and brightness level to 1.5)
 
=== .reload === <!--T:8-->
*<code>.reload shapes</code><br /> Reloads all JSON models from assets/blockshapes. Can be used to quickly test new block shapes.<br />Notice: The chunks are not redrawn, so you'd have to force a redraw e.g. by placing and removing a block.
*<code>.reload textures</code><br /> Reloads all textures from assets/textures. Can be used to quickly test texture changes.
*<code>.reload lang</code><br /> Reloads all lang files from assets/lang. Can be used to quickly test translation changes.
*<code>.reloadhandbook</code><br /> Reloads handbook entries. Can be used to quickly test translation etc. changes in handbook.
 
=== .resolution === <!--T:45-->
*<code>.resolution</code><br /> Sets the screen size to given width and height
 
=== .serverinfo === <!--T:46-->
*<code>.serverinfo</code><br /> Display information about server info
 
=== .spawndecal === <!--T:47-->
*<code>.spawndecal</code><br /> Spawn a decal at position
 
=== .tfedit === <!--T:48-->
*<code>.tfedit</code><br /> Opens the Transform Editor
 
=== .time === <!--T:49-->
*<code>.time</code><br /> Read local game time or speed
 
=== .viewdistance === <!--T:9-->
*<code>.viewdistance</code><br /> Sets the viewing distance. Same as setting the view distance in the graphics settings but with no upper limit. For viewing distances above 1000 blocks you also have to set the <code>.zfar</code> value above that.
 
=== .vrec === <!--T:50-->
*<code>.vrec</code><br /> Video Recorder Tools
 
=== .we === <!--T:51-->
*<code>.we</code><br /> World edit toolbar, see more in {{ll|How_to_use_WorldEdit|How to use WorldEdit}}
 
=== .zfar === <!--T:10-->
*<code>.zfar [value]</code><br /> Sets the clipping plane distance, everything beyond given value is no longer visible (default value is 1000). Very high values will cause Z-fighting.
 
</translate>
{{Game navbox}}
{{Navbox/modding|Vintage Story}}

Latest revision as of 17:32, 10 March 2024

Other languages:

This page was last verified for Vintage Story version 1.15.

Commands offer advanced features and configuration abilities for your game. There are really 2 lists of commands - Client and Server . The client is what displays your game on the screen, plays the sounds, takes in your controls and lets you connect to a game server (single or multiplayer). Client commands are those that usually just affect the appearance of your game, while server commands allows you to modify the world or configuration of the game.

All commands are typed in the chat window in order to execute them. A client command always starts with a dot ., while a server command always starts with a slash /.

See also: List of server commands


Client Commands

.blockitempngexport

  • .blockitempngexport [inv|all] [imageSize] [domain]
    Export all items and blocks as png images

.cam

  • .cam [p|rp|cp|up|goto|start|loop|stop|clear|load|save|alpha|tp]
    The cinematic camera tool system.
    • .cam p
      Adds the current position to the list of places to visit.
    • .cam rp
      Removes the last added point.
    • .cam cp
      "Close path". Connects the path to the first position in the list. Useful in combination with .cam loop to create a looping camera path.
    • .cam up [num]
      Update the position and viewing angle of point num to the current location.
    • .cam goto [num]
      Go to point num by teleport.
    • .cam clear
      Clears the list of all points.
    • .cam start [time]
      Starts the cinematic camera, the camera will complete the path in the given number of seconds.
    • .cam rec [real seconds] [video seconds]
      Play path and record to .avi file.
    • .cam stop
      Stops the cinematic camera.
    • .cam save
      Exports the current list of points into your clipboard, which you then can paste into any text editor.
    • .cam load [data]
      Import supplied list of points.
    • .cam tp [0 or 1]
      Toggles whether to teleport you back to your previous position after the camera path has been completed.
    • .cam alpha [0..1]
      Modifies how the smoothly the points are traversed by the camera.
    • .cam gui [0 or 1]
      If one, will disable the guis during the duration of the recording (default on).


.c[louds]

  • .cdensity
    Set large and small cloud density
  • .cdensitylarge
    Set large cloud density
  • .cdensitysmall
    Set small cloud density
  • .clight
    Set Cloud lightness
  • .crand
    Set large and small cloud noise
  • .cviewdist
    Sets the cloud view distance. Will be reset when view distance in graphics settings are changed

.chatsize

  • .chatsize [width]/default [height]/default
    Set the chat dialog with custom width and/or height (default 400x160 [Depending on the interface])

.clearchat

  • .clearchat
    Clears your chat history

.client+

  • .client+
    Client+ configuration command

.clientconfig

  • .clientconfig [parameterName] [parameterValue]
    Changes client configuration at runtime. It can change any value in the clientsettings.json file. parametername may seem like subcommands, but is actually a dynamic list of options. This means that mods can change the list of options.
    • floatyGuis [1|0]
      Enables/disables the experimental feature where chest dialogs float above the chests
    • showentitydebuginfo [0|1]
      Displays arbitrary debug information above entities
      May require corresponding server command /entity debug 1
    • ssaa [0.5|2]
      Controls Screen Space Anti-Aliasing. 0.5 value enables 0.5x Sampling rate and may give a performance gain at the cost of reduced graphics quality for low end hardware. 2 value enables 2-4x Sampling rate.
    • gammaLevel [level]
      Allows to set gamma level in survival mode. Value 1 is the default 100%, 1.5 is brighter.


.clientconfigcreate

  • .clientconfigcreate [name] [datatype] [value]
    Adds a new client configuration key that did not exist before.


  • .clientconfigcreate overheadLookAt bool true
    Adds a client configuration key that causes the player's seraph to look at the camera when it is in front of the character. Set to false to disable.

.clients

  • .clients
    List of connected players.
  • .clients ping
    List of connected players with their ping.

.cp

  • .cp [posi|aposi|apos|chat]
    Copy something to your clipboard
    • .cp posi
      The position below the player as an integer.
    • .cp aposi
      The absolute player position as an integer in the format X=1,Y=1,Z=1.
    • .cp apos
      The absolute player position as a float in the format X=1.34,Y=1.34,Z=1.34.
    • .cp chat
      The chat history.

.debug

  • .debug normalview
    Shows vertex normals instead textures, but does not discard transparent pixels.
  • .debug wireframe [value]
    Running .debug wireframe will give some help info.
    • entity
      Shows entity collision boxes.
    • chunk
      Shows chunk borders.
    • serverchunk
      Shows server chunk borders.
    • region
      Shows region borders.
    • blockentity
      Shows block entity borders e.g. of large gear.
    • ambsounds
      Shows ambient sound borders e.g. of flowing water.
  • .debug talk [value]
    Plays actions with the character's voice. Running .debug talk will give a list of values.
  • .debug [perceptioneffect|pc] [value]
    Applies effect.
    • drunk
      Makes player drunk.
    • damagedfreezing
      Applies a freezing effect to player.
  • .debug tofb [true|false]
    Toggle offscreen buffer.
  • .debug cmr
    Print a full list of color map rectangles to the client-main.txt.
  • .debug us
    Toggle unbind samplers mode.
  • .debug gl [true|false]
    Toggle OpenGL debug mode.
  • .debug uiclick
    Toggle UI Debug print interactions.
  • .debug discovery [value]
    Show a text on the screen as for lore books.
  • .debug soundsummary
    Print a count of loaded sounds.
  • .debug meshsummary
    Print a full list of block mesh sizes in kilobytes to client-debug.txt.
  • .debug chunksummary
    Print a count of total chunks, packed chunks and free pool objects.
  • .debug renderers
    Print a full list of renderers.
  • .debug exptexatlas [block|item|entity]
    Export an atlas(es) of blocks, items or entities.
  • .debug liquidselectable
    Toggle forced liquid selectable.
  • .debug relightchunk
    Recalculate sunlight and queue for redrawing in the chunk.
  • .debug fog [value]
    Sets fog density.
  • .debug fov [value]
    Sets field of view.
  • .debug wgen
    Print a rainfall and adjusted temperature values.
  • .debug redrawall
    Redraw all chunks.
  • .debug ci
    Display some information on the current chunk the player is in
  • .debug shake [value]
    Shake effect. Insert a higher negative value to remove the effect.
  • .debug recalctrav
    Recalculate traversability of all chunks.
  • .debug find [blockName]
    Specify all or part of the name of a block to find its coordinates.

List of server commands/debug also exists. Use .help debug for more info on debug commands.

.edi

  • .edi
    Show/Hide Extended information on debug screen, e.g. block lighting.

.exponepng

  • .exponepng [code|hand] [block|item] [size=100] [code]
    Export one item as png image.

.fbdeb

  • .fbdeb
    Toggle Framebuffer/WOIT Debug mode

.fountain

  • .fountain [quantity] [quad|cube]
    Toggle Particle fountain.

.freemove

  • .freemove
    Toggle Freemove

.gencraftjson

  • .gencraftjson
    Copies a snippet of json from your currently held item usable as a crafting recipe ingredient

.gui

  • .gui
    Hide/Show all GUIs

.help

  • .help
    Display list of available client commands

.lockfly

  • .lockfly
    Locks a movement axis during flying/swimming
  • .lockfly 1
    Locks a movement axis to X
  • .lockfly 2
    Locks a movement axis to Y
  • .lockfly 3
    Locks a movement axis to Z

.logticks

  • .logticks
    Toggle Tick profiling. Won't log ticks below the threshold.

.map

  • .purgedb
    Purges map DB.
  • .redraw
    Redraws map.
  • .worldmapsize [mapHeight] [mapWidth]
    Sets world map size.

.moon

  • .moon
    Prints the current moon phase.

.movespeed

  • .movespeed
    Set Movespeed

.music

  • .music
    Shows current music track

.netbenchmark

  • .netbenchmark
    Toggles network benchmarking

.noclip

  • .noclip
    Toggle noclip

.online

  • .online
    Prints list of online players.
  • .online ping
    Prints list of online players with their ping.

.pastemode

  • .pastemode
    Set the chats paste mode. If set to multi pasting multiple lines will produce multiple chat lines.

.recomposechat

  • .recomposechat
    Recompose chat dialogs

.reconnect

  • .reconnect
    Reconnect to server

.recordingmode

  • .recordingmode
    Makes the game brighter for recording (Sets gamma level to 1.1 and brightness level to 1.5)

.reload

  • .reload shapes
    Reloads all JSON models from assets/blockshapes. Can be used to quickly test new block shapes.
    Notice: The chunks are not redrawn, so you'd have to force a redraw e.g. by placing and removing a block.
  • .reload textures
    Reloads all textures from assets/textures. Can be used to quickly test texture changes.
  • .reload lang
    Reloads all lang files from assets/lang. Can be used to quickly test translation changes.
  • .reloadhandbook
    Reloads handbook entries. Can be used to quickly test translation etc. changes in handbook.

.resolution

  • .resolution
    Sets the screen size to given width and height

.serverinfo

  • .serverinfo
    Display information about server info

.spawndecal

  • .spawndecal
    Spawn a decal at position

.tfedit

  • .tfedit
    Opens the Transform Editor

.time

  • .time
    Read local game time or speed

.viewdistance

  • .viewdistance
    Sets the viewing distance. Same as setting the view distance in the graphics settings but with no upper limit. For viewing distances above 1000 blocks you also have to set the .zfar value above that.

.vrec

  • .vrec
    Video Recorder Tools

.we

.zfar

  • .zfar [value]
    Sets the clipping plane distance, everything beyond given value is no longer visible (default value is 1000). Very high values will cause Z-fighting.


Wiki Navigation
Vintage Story Guides[[::Category:Guides| ]]Frequently Asked Questions Soundtrack Versions Controls
Game systems Crafting Knapping Clay forming Smithing Cooking Temperature Hunger Mining Temporal stability Mechanical power Trading Farming Animal husbandry
World World generation Biomes Weather Temporal storms
Items Tools Weapons Armor Clothing Bags Materials Food
Blocks Terrain Plants Decorative Lighting Functional Ore
Entities Hostile entities Animals NPCs Players
Miscellaneous List of client commands List of server commands Creative Starter Guide Bot System WorldEdit Cinematic Camera Adjustable FPS Video Recording ServerBlockTicking


Icon Sign.png

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.

Modding
Modding Introduction Getting Started Theme Pack
Content Modding Content Mods Developing a Content Mod Basic Tutorials Intermediate Tutorials Advanced Tutorials Content Mod Concepts
Code Modding Code Mods Setting up your Development Environment
Property Overview ItemEntityBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsWorld properties
Workflows & Infrastructure Modding Efficiency TipsMod-engine compatibilityMod ExtensibilityVS Engine
Additional Resources Community Resources Modding API Updates Programming Languages List of server commandsList of client commandsClient startup parametersServer startup parameters
Example ModsAPI DocsGitHub Repository