Settings

This page was last verified for Vintage Story version 1.18.7.

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.

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	Increase or decrease pixel resolution. Higher resolutions have a higher FPS cost but look better, while lower percentages look worse but let the game run faster. Screenshots taken with F12 may not show GUI if resolution is not at 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