Settings

This page was last verified for Vintage Story version 1.18.15.

This article is a stub.
This article does not contain as much information as we would like. If you wish to contribute, you can request wiki edit access on the forum or the Discord.

This is a list of all settings that can be changed in-game in Vintage Story.

Terminology

Term	Meaning	Explanation
bloom
FPS	frames per second	More pictures in a second looks smoother; fewer pictures per second can look choppy.
gamma
god rays
GPU
GUI
particles
RAM
SSAO
VRAM

Graphics

Essential graphics settings

Setting	Type	Effect	Performance impact
Quality preset	Dropdown	Goes from "Pathetic" to "Absolute Maximum"	Scales with preset

Graphics quality

Setting	Type	Effect	Performance impact
View distance	Slider, increments of 32 blocks	The distance at which blocks are rendered. Going over 512 blocks may lead to a crash due to running out of VRAM on lower-end graphics cards	High FPS and memory cost at high settings

Appearance/other

Setting	Type	Effect	Performance impact
Gamma	Slider, 30-300, increments of 5	Adjusts overall brightness	None
FOV	Slider, 20-160°, increments of 1	Field of view, defaults to 70°	Medium FPS cost at high FOV
Full screen	Checkbox	Enables or disables full screen mode	N/A

Advanced graphics settings

These are shown only if the player does not choose "show only essential settings". In addition to the options shown under essential graphics settings, these additional settings are available to be tweaked.

Graphics quality

Setting	Type	Effect	Performance impact
AO+Smoothlight	Checkbox	Produce smooth shadow transitions and block-level ambient occlusion. Should be left on by default. Disabling may help if placing blocks is not instant	Little to no FPS impact
FXAA	Checkbox	Smooths out the edges of the scene	Little to no FPS impact
Waving foliage	Checkbox	Toggles whether or not foliage waves in the wind	Little to no FPS impact
Foam and shiny effect	Checkbox	Toggles reflective surfaces on various blocks, and the foam, ripple and specular effects on water surfaces. Recommended to set to off for freezing issues when playing with an integrated GPU, such as Intel HD or Iris graphics	Medium FPS cost
Bloom	Checkbox	Enables or disables block bloom and ambient bloom	High FPS cost
God rays	Checkbox	Enables or disables crepuscular (dawn/dusk) rays effect	Very high FPS cost
SSAO	Slider, off/medium/high quality	Adds ambient occlusion to fine geometry at sub-block level, giving the scene a greater sense of depth	High FPS cost
Shadows	Slider, off/low/medium/high/very high quality	Sets dynamic shadow quality	High FPS cost
Particles	Slider, percentage	Controls ambient particle density and sets an upper limit for number of particles alive at the same time	Medium FPS cost
Dynamic Lights	Slider, 0 - 100 light sources, steps of 1	Maximum number of mobile light sources	Very high FPS cost if set to more than 12 light sources
Resolution	Slider, percentage	"Lets you increase/decrease the pixel resolution. High resolutions yield better quality scenes, but can have a very high fps cost. A low resolution may make your game run a lot faster. Note: Screenshots taken with F12 will not show GUI if the resolution is not 100%"	Medium FPS cost (scales depending on setting)

Appearance/other

Setting	Type	Effect	Performance impact
Sepia	Slider, 0-100, steps of 5	Changes overall sepia of the scene	No FPS impact
Ambient bloom	Slider, percentage, steps of 10%	Only works if Bloom is on. Applies bloom effect to whole scene. 0% means only block bloom is applied	No FPS impact
Max FPS	Slider, 15 - unlimited, steps of 1	Only works if VSync is off. Limits maximum framerate. Recommended to set at 30, 60 or 75 FPS	May help with stutter
VSync mode	Dropdown, off/on/on+sleep	Off: No hardware vsync, FPS limit controlled by Max FPS setting, may cause screen tearing On: VSync active, may help with screen tearing at the cost of halved FPS, may only be effective in fullscreen mode On+Sleep: Combines Max FPS and hardware VSync setting. Recommended to set Max FPS slightly higher than your monitor refresh rate. May reduce stutter issues with VSync for some players	Depends on setting
View bobbing	Checkbox	Enables or disables up and down bobbing effect when moving	None
Optimize RAM	Dropdown, optimize somewhat/aggressively optimize	Reduces memory usage according to setting, "aggressive" recommended for high view distance settings. Must restart the game world for this setting to take effect	May cause mild lag spikes if set to aggressive optimization
Occlusion culling	Checkbox	Removes hidden parts from scenes to reduce loads on the GPU. If the player changes their view very quickly, enabling this may cause a delay in chunk rendering. Recommended on for multicore CPUs	Enabling helps increase FPS
Purple grass fix	Checkbox	Fixes purple grass bug for some players with Radeon HD graphics cards	N/A
Chunk upload rate limiter	Slider, 0 - 8, steps of 1	Limits rate at which world rendering data is sent to the GPU. Higher values limit this more. Often needs to be adjusted if view distance settings are changed	Higher values may help with lag spikes when moving between chunks. Lower values slightly speed up rendering of new world areas

n.b. VSync mode may be overwritten by some graphics cards using adaptive sync settings, such as FreeSync or GSync.

Mouse

Setting	Type	Effect	Notes
Mouse sensitivity	Slider (0-200), steps of 5	Changes mouse sensitivity. Higher values are more sensitive	Defaults to 50
Mouse move smoothing	Slider (0-95), steps of 5	Applies a smoothing effect to mouse movement. 0 disables this feature	Defaults to 0
Mouse wheel sensitivity	Slider (0.1x - 10x), steps of 0.1	Sets a multiplier on the number of lines scrolled for each mouse wheel click	Defaults to 1x
Invert Y Axis	Checkbox	Enable or disable inverting the Y axis for mouse movement	Defaults to off
Item collect mode	Dropdown (Always collect items/Only collect items while sneaking)	Sets the condition by which players will pick up loose items from the ground	Defaults to "Always collect items"

Controls

See the list of controls.

Sound

Setting	Type	Effect
Master sound level	Slider (0-100%), steps of 1	Changes overall sound level
Ambient sound level	Slider (0-100%), steps of 1	Changes sound level for ambient noises
Weather sound level	Slider (0-100%), steps of 1	Changes sound level for weather effects
Music level	Slider (0-100%), steps of 1	Changes volume of background music
Music frequency	Slider ("Rarely", "Sometimes", "Often", "Very often")	Changes how often background music will play
Output device	Dropdown	Select the audio output device for Vintage Story

Interface

Setting	Type	Effect	Notes
GUI scale	Slider (4-16), steps of 1	Changes GUI scale including size of dialogs	Defaults to 8
Auto show/hide chat	Checkbox	Enable or disable automatically showing the chat window for 15 seconds every time a new chat message is sent	Default on
Block info overlay	Checkbox	Enable or disable a text box at the center-top of the screen showing information on the targeted block	Can be toggled on or off in-game
Block interaction help	Checkbox	Enable or disable information on how to interact with the targeted block or entity	Can be toggled on or off in-game
Coordinate overlay	Checkbox	Enable or disable a text box at the top-right of the screen showing player's coordinates and the cardinal direction they are facing	Can be toggled on or off in-game
Minimap	Checkbox	Displays a minimap in the top right corner of the screen	Can be toggled on and off in-game with ?. May not be available in some game modes depending on world generation settings
Immersive mouse mode	Checkbox	Opens block dialogs above their in-world position and allows players to control the camera when block dialogs are open	Players can hold Alt to unlock the cursor and stop controlling the camera
Immersive first person mode	Checkbox	Enables or disables players seeing their own body in first person mode	Experimental setting
Language	Dropdown	Sets the interface and game language
Window border	Dropdown ("Resizable", "Fixed", "Hidden")	Sets window border display mode
Developer mode	Checkbox	Enables additional settings for developers and modders, and shows server logs instead of story logs in singleplayer	Requires a confirmation to activate

Debug

These are only available if Developer Mode is enabled under Interface settings.

Setting	Type	Effect	Notes
Error reporter	Checkbox	Launches the error reporter on startup
Extended debug info	Checkbox	Displays additional debug info in the debug screen, frame profiler and item stack tooltips
OpenGL debug mode	Checkbox	Enable or disable OpenGL debug mode for precise error tracking	Reduces game performance
Texture dispose debug	Checkbox	Enable or disable texture dispose debugging to track memory leaks	Reduces game performance
VAO dispose debug	Checkbox	Enable or disable VAO dispose debugging to track memory leaks	Reduces game performance
Sound dispose debug	Checkbox	Enable or disable sound dispose debugging to track memory leaks	Reduces game performance

See also

• List of controls