
Vintage Story Mod DB · Vintage Story mod
Adaptive Graphics
WARNING: The mod is currently in its testing phase. Unexpected results, and instability may occur. User feedback is highly appreciated! Automatically adjusts your graphics settings based on a desired target FPS! This mod aims to improve your Vintage Story ex
Quick answer
Which Adaptive Graphics release should I use?
Adaptive Graphics 0.0.2 targets 1.21.0, 1.21.1. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.
Where it goes
Is Adaptive Graphics required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This Vintage Story file is marked client-only.
What else does Adaptive Graphics 0.0.2 need?
0.0.2. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Adaptive Graphics without breaking your instance.
Built for Adaptive Graphics 0.0.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 0.0.2. It targets 1.21.0, 1.21.1; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 0.0.2. It opens that exact file at the source.
About this project
What does Adaptive Graphics add?
WARNING: The mod is currently in its testing phase. Unexpected results, and instability may occur. User feedback is highly appreciated!
Automatically adjusts your graphics settings based on a desired target FPS!
This mod aims to improve your Vintage Story experience by changing graphical settings to achieve a user-set target FPS, in the hopes of achieving a smoother gameplay based on changing circumstances. Included features are:
- Tracking of the game's Frames per Second to determine if certain settings should be decreased or increased
- Completely configurable according to your preferences and hardware
- Last resort option to bring down shader qualities one step further when the target FPS can't be achieved, at the cost of quality
- Minimal FPS counter on the bottom left of the screen
Recommended to be configured with Config Lib by Maltiez.
Configurable by changing values in the provided config file AdaptiveGraphics.json inside ModConfig folder.
Note on default values: These are the initial settings used in testing, actual default values may still change.
TargetFPS- The user desired FPS to achieveShowFPS- Shows a simple FPS indicator on the bottom leftToleranceFPS- The lower/upper bounds of the target fps, dictates sensitivity to changeAllowLastResort- If all options to lower settings have been exhausted, allow to lower each shader quality (SSAO, shadow) by one to try and achieve target fpsMinViewDistance,MaxViewDistance- The distances in which the mod can automatically adjust toViewDistanceStep- How near/far blocks are adjusted to the view distance when automatically adjustingAllowChangeShaderSettings- Allows to automatically change both shader settings (SSAO and Shadow). Typically causes stuttering as shaders are reloaded but less noticeable over timeAllowChangeShaderShadowSettings- Allows to automatically change shadow quality settings. No effect ifAllowChangeShaderSettingsis disabledBaseShadowQuality,MaxShadowQuality- The base quality is what you set usually set as your default. The maximum tells the mod how high it can set shadows
0 - Off
1 - Low
2 - Medium
3 - High
4 - Very HighAllowChangeShaderSSAOSettings- same asAllowChangeShaderShadowSettingsbut for SSAO qualityBaseSSAOQuality,MaxSSAOQuality- same asBaseShadowQuality,MaxShadowQualitybut for SSAO quality
0 - Off
1 - Medium
2 - High
The next set of configurations are advanced settings, they are generally not changed unless you understand the changes
FpsSampleDuration- The duration (seconds) of the rolling window for average FPS, which will then compared against the Target FPS. Setting this lower cause more sudden changes, higher cause slower changesAsymmetricPercentage- Percentage to skew the Tolerance for theTargetFPS, setting this to0disables this. In effect, this makes reaction quicker when fps falls below the target, react conservatively when fps risesFpsTrendDuration- The duration (seconds) to confirm a trend is sustained before an outlier FPS will be used in computing the average. Recommended is 3-5OutlierTolerance- FPS is considered an outlier outside these bounds. This is multiplied to the average of the FPS sampled within theFpsSampleDurationSettleInitial- Wait period (seconds) to let the FPS settle before making adjustments initially on game startSettleAfterAdjust- Wait period to let the FPS settle after making adjustments to the graphical settingsSettleAfterPause- Wait period to let the FPS settle after pausing. Used for external settings such as an external frame limiter in use when game is out of focusSamplingInterval- How often (seconds) FPS calculated and collected
- Server error from trying to save config through ConfigLib (fixed in next release)
- Flicker observed from the sky occurs when view distance is changed (Limitation?)
- Stutters when changing settings that requires a shader reload (SSAO Quality, Shadow Quality). These lessen eventually as the stutters hit hardest when initially reloading the shaders for the set quality
- Documentation
- Minimize oscillations if present
- Configuration presets
- Dynamic view distance steps
- Environment aware (Caves, Below ground, Day/Night)
- FPS Cap compatibility
- Testing on different averaging methods
Feedbacks, suggestions, and support are all welcome and appreciated! You can reach me in the Vintage Story discord server.
Project description from Vintage Story Mod DB.
Pick your setup
Adaptive Graphics releases for each Vintage Story version.
Choose the version and loader you play, then open the matching release.
1.21.0
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Adaptive Graphics versions and loaders
0.0.2
adaptivegraphics_0.0.2.zip
29 Sept 2025
0.0.1
adaptivegraphics_0.0.1.zip
27 Sept 2025
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.