List of client commands

From Vintage Story Wiki
Revision as of 02:11, 5 October 2024 by Bluelightning32 (talk | contribs) (Show the output of turning on entity boxes)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Other languages:
Gear-rusty.png

This page is outdated.
Reason: Severely outdated, see protip below for up to date information.
The content on this page is not up to date with the most recent game update. If you do wish to contribute, please request wiki edit access on the Discord.

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

Book-normal-brickred.png Protip:
It is advised to utilize in-game command handbook available under client command .chb as it is generally up to date with current game version and often has more information than what is available on Wiki. The article has been updated to include the addition of most commands as off 1.19.8, however, some the commands that have been removed or moved since 1.15 may not be correct. If a command does not work, check .chb for alternate commands. 


See also: List of server commands


Client Commands

.blockitempngexport

  • .blockitempngexport [inv|all] [imageSize] [domain]
    Export all items and blocks as png images
    • [inv|all] is (optionally) the exportRequest
    • [imageSize] is an integer number
    • [domain] is a string without spaces

.bsedit

  • .bsedit
    Opens the block selection editor. Alias for .dev bsedit

.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

.charsel

  • .charsel
    Opens the character selection menu.

.chatsize

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

.chb

  • .chb
    Opens up command handbook

.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
    Prints list of online players. Alias for .online .
  • .clients ping
    Prints list of online players with their ping. Alias for .online 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.

.crash

  • .crash
    Crashes the game.

.ctblocks

  • .ctblocks [freezeCtBlocks]
    Lets you to toggle on/off the updating of client ticking blocks. This can be useful when recording waterfalls and such.
    • [freezeCtBlocks] is a boolean, including 1 or 0, yes or no, true or false, or on and off

.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 selection boxes in blue and collision boxes in red.
      polar bear selection and 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.

.dev

  • .dev bsedit
    Opens The Block Selection Editor. Has alias of .bsedit .
  • .dev reload <assetcategory>
    Asseted reloading utility. Incase of shape reload will also Re-tesselate. Incase of textures will regenerate the texture atlesses. See .reload for more information, as command is an alias.
  • .dev tfedit [fp/tp/tpo/gui/ground]
    • [fp/tp/tpo/gui/ground] is (optionally) the type.
    • Opens The transform Editor. Has Alias of .tfedit .

.edi

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

.errorreporter

  • .errorreporter
    Reopens the error reporting dialog

.exponepng

  • .exponepng code [block|item] [exportCode] [size=100]
    Export one item as png image
    • [block|item] is the exportType
    • [exportCode] is a string without spaces
    • [size] is an integer number. Default is 100.
  • .exponepng hand [size=100]
    Export icon for currently held item/block.
    • [size] is an integer number. Default is 100.

.fbdeb

  • .fbdeb
    Toggle Framebuffer/WOIT Debug mode

.fountain

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

.firstlaunchinfo

  • .firstlaunchinfo
    Show the first launch info dialog.

.freemove

  • .freemove [freeMove]
    Toggle Freemove
    • [freeMove] is a boolean, including 1 or 0, yes or no, true or false, or on or off

.gencraftjson

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

.gui

  • .gui [show_gui]
    Hide/Show all GUIs
    • [show_gui] is a boolean, including 1 or 0, yes or no, true or false, or on or off

.help

  • .help
    Display list of available client commands. Has options parramameters of [commandname] [subcommand] and [subsubcommand] which are strings without spaces, you can use .help [commandname] to display the information regarding the command in question as well as restrictions on parameters as well as a list of subcommands.

.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

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

.moon

  • .moon
    Prints the current moon phase.

.movespeed

  • .movespeed [speed]
    Set Movespeed
    • [speed] is a decimal number, for example 0.5

.music

  • .music stop
    Stops the current music track.

.netbenchmark

  • .netbenchmark
    Toggles network benchmarking

.notminecraft

  • .notminecraft
    Discription in the command handbook and when .help notminecraft reads: "No, this is not minecraft". Command displays a banner in the top right corner of the game that states "No, this is not minecraft". The banner also displays the minecraft icon with a red "X" marking through the image. To toggle off, run the command again.

.noclip

  • .noclip [noclip]
    Toggle noclip

.online

  • .online
    Prints list of online players. Alias for .clients .
  • .online ping
    Prints list of online players with their ping. Alias for .clients ping .

.pastemode

  • .pastemode [single|multi]
    Set the chats paste mode. If set to multi pasting multiple lines will produce multiple chat lines.
    • [single|mulit] is the mode

.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

  • This command has alias of Alias for .dev reload
  • Warning: Some of the commands listed below may have changed, .chb does not list what options are available for testing and not all of the commands would run as tested.
  • .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 [fp/tp/tpo/gui/ground]
    Opens The transform Editor. Has Alias of .dev tfedit .
    • [fp/tp/tpo/gui/ground] is (optionally) the type.

.time

  • .time
    Read local game time or speed

.timelapse

  • .timelapse [interval-in-days] [duration-in-months]
    Takes a set of timelapse photographs of the same spot of several hours, days, or seasons. Images can be found in folder Pictures/Vintagestory/timelapse.
    Note: As currently implemented, the world does not actually change while the photographs are being taken. For example, crops will not grow, snow will not fall, ect. This is intended only for seeing the visual changes of the changing time of day or changing seasons.

.tutorial

  • Interact with the tutorial system.
  • .tutorial hud
    Toggles the tutorial HUD.
  • .tutorial restart
    Restarts the currently selected tutorial .
  • .tutorial ship [skip_amount]
    Skips the currently selected tutorial.
    • [skip_amount]
      Is an integer Number.

.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

.weather

  • .weather
    Shows current weather info.

.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 ItemEntityEntity BehaviorsBlockBlock BehaviorsBlock ClassesBlock EntitiesBlock Entity BehaviorsCollectible 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