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[[::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