Settings
From Vintage Story Wiki
This page was last verified for Vintage Story version 1.19.7.
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 | Overall "brightness" | ||
god rays | |||
GPU | Graphical Processing Unit | A computer component, usually responsible for handling dedicated graphical rendering tasks. Sometimes called a "graphics card". | |
GUI | Graphical User Interface | An interface that allows users to interact or alter settings, with a graphical front-end (i.e. uses tables, buttons, charts, fonts with different color and size) and so on. Contrast this to a text-based user interface, which is a user interface that is presented and controller purely in text. | |
particles | |||
RAM | Random Access Memory | ||
SSAO | Screen Space Ambient Occlusion | ||
VRAM | Video RAM |
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.
Accessibility
Setting | Type | Effect |
---|---|---|
Toggle sprint | Checkbox | Enabled: Tap the sprint key to enable sprinting and tap it again to disable sprinting. Also allows double-tap Tab to to activate sprint. Disabled: Sprint key must be held down to activate sprint mode. |
View bobbing | Checkbox | Enabled: View bobbing (up-and-down camera motion while moving) is enabled. Disabled: View bobbing is disabled, which may help those with motion sickness. |
Camera shake strength | Slider (0-100%), steps of 1 | Adjusts camera shake for various effects such as freezing, getting hurt, after teleporting and other sources |
Wireframe thickness | Slider (0.5x-8x), steps of 0.5 | Determines thickness of the wireframe outlines when knapping, clayforming, smithing or chiseling |
Glitch strength waviness | Slider (0-150%), steps of 1 | Determines the intensity of the waviness effect during low temporal stability situations |
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
History
References
Wiki Navigation | |
---|---|
Vintage Story | 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 |