SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedLibraries & compatibility

Config lib

by VSCustodian · for Vintage Story

Config library for content mods

684KDownloads
1.18.8Latest game version
Vintage Story ModDBSource

About Config lib

From Vintage Story ModDB

Config library for content mods

You can support me on Patreon:


Requires ImGui

There is an addon you might want to check: Auto Config lib

For other modders (or if you want to help): I need help with wrighting documentation for this library, I'm bad at it and dont have energy to do this stuff. Also I will be happy to have some help with testing new features.

 

This is a library that allows making configs even for content mods (there is also API for code mods, including custom widgets) and provides a unified GUI for editing them in game. It does not require for your mod to depend on this library. If the library is not installed, default values from assets will be used.

This library also allows changing values in regular JSON patches, that can be valuable for server configurations and can make tweaking other mods for server needs much easier.

 

Documentation on JSON API of this library (written by Somnium). If you want to help keep documentation up-to-date, expand it and help test new features, please ping me in discord, any help will me much appreciated.

If you need help with adding a config file using this lib feel free to ping me in discord on official VS server.

Thanks Somnium for feature suggestions and help with testing them, and the documentation.

Some of the mods that use this library:

Feel free to request any features you might need under mod's discord post (link is above in Homepage tab).

 

Example of adding config reload functionality keeping optional dependency:

<pre class="language-csharp">public sealed class CombatOverhaulSystem : ModSystem { public Settings Settings = new();

public override void Start(ICoreAPI api) { if (api.ModLoader.IsModEnabled("configlib")) { SubscribeToConfigChange(api); } }

private void SubscribeToConfigChange(ICoreAPI api) { ConfigLibModSystem system = api.ModLoader.GetModSystem&lt;ConfigLibModSystem&gt;();

system.SettingChanged += (domain, config, setting) =&gt; { if (domain != "combatoverhaul") return; setting.AssignSettingValue(Settings); }; system.ConfigsLoaded += () =&gt; { system.GetConfig("combatoverhaul")?.AssignSettingsValues(Settings); }; } }</pre>

Highlights

From source data

Game versions

Built for Vintage Story 1.18.8.

Footprint

Rated a light load on a server.

Config lib on Nxeon

From our catalogue
One-click install
Supported on Nxeon Vintage Story servers. We download it from Vintage Story ModDB, place it, and restart the server.
Server side
Required on the server
Server load
light
Smallest plan we suggest
Vintage Story — 1 GB (1 GB RAM). This follows our own load rating above, not a benchmark.

Run Config lib on a Vintage Story server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Vintage Story ModDB as “Mod”

Libraries & compatibility

Foundations and fixes other mods build on. Usually installed because something else needs it.

Runs on your server

From source side support

Vintage Story ModDB lists Config lib as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Compatibility

Game
Vintage Story
Runs on
Serverrequired on the server
Game versions
1.18.8

Verified at the source

  • ✓Vintage Story ModDBOfficial listing, checked 2026-09-24Open ↗
  • ✓AuthorVSCustodian, as published on Vintage Story ModDB
  • ✓LicenseNot published by the sourceFree

Config lib, answered

Generated from the mod’s own source data.

Do my players need to install Config lib?

Vintage Story ModDB lists Config lib as required on the server. Check its Vintage Story ModDB page to see whether players need it too.

Is it free?

Yes. Config lib is free to download from Vintage Story ModDB.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Config lib on a Vintage Story server.

Deploy in about a minute from $4.00 a month, then add Config lib in one click.