Back to mods
Adaptive Graphics project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Adaptive Graphics release should I use?

Updated 10 months ago
Latest stable file 0.0.2
Game version 1.21.0, 1.21.1
Loader Built-in Vintage Story mod system

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.

Client Required
Dedicated server Not supported
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 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

 

Configuration
 

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 achieve
  • ShowFPS - Shows a simple FPS indicator on the bottom left
  • ToleranceFPS - The lower/upper bounds of the target fps, dictates sensitivity to change
  • AllowLastResort - If all options to lower settings have been exhausted, allow to lower each shader quality (SSAO, shadow) by one to try and achieve target fps
  • MinViewDistanceMaxViewDistance - The distances in which the mod can automatically adjust to
  • ViewDistanceStep - How near/far blocks are adjusted to the view distance when automatically adjusting
  • AllowChangeShaderSettings - Allows to automatically change both shader settings (SSAO and Shadow). Typically causes stuttering as shaders are reloaded but less noticeable over time
  • AllowChangeShaderShadowSettings - Allows to automatically change shadow quality settings. No effect if AllowChangeShaderSettings is disabled
  • BaseShadowQualityMaxShadowQuality - 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 High

  • AllowChangeShaderSSAOSettings - same as AllowChangeShaderShadowSettings but for SSAO quality
  • BaseSSAOQualityMaxSSAOQuality - same as BaseShadowQualityMaxShadowQuality but 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 changes
  • AsymmetricPercentage - Percentage to skew the Tolerance for the TargetFPS, setting this to 0 disables this. In effect, this makes reaction quicker when fps falls below the target, react conservatively when fps rises
  • FpsTrendDuration - The duration (seconds) to confirm a trend is sustained before an outlier FPS will be used in computing the average. Recommended is 3-5
  • OutlierTolerance - FPS is considered an outlier outside these bounds. This is multiplied to the average of the FPS sampled within the FpsSampleDuration
  • SettleInitial - Wait period (seconds) to let the FPS settle before making adjustments initially on game start
  • SettleAfterAdjust - Wait period to let the FPS settle after making adjustments to the graphical settings
  • SettleAfterPause - 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 focus
  • SamplingInterval - How often (seconds) FPS calculated and collected
Known Issues
  • 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
Future Plans
  • 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
Credits
ResetXPDR for his work on MSFS AutoFPS, which this mod is heavily inspired from
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.

2 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Adaptive Graphics versions and loaders

2 of 2 releases match

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.