SuperMartijn642's Config Lib
Modby SuperMartijn642
Config Lib makes dealing with config files just a bit easier.
Type
Mod
CurseForge Downloads
191,217,777
CurseForge ID
Modrinth Downloads
33,931,933
Modrinth ID
Last Updated
Nov 7, 2026
Description
SuperMartijn642's Config Lib allows you to specify a config once and it then handles reloading values between world loads, syncing values with clients, and generating values for client- or server-only on its own.
Creating a config:
A config is created using a ModConfigBuilder.
Simply create a new instance using #ModConfigBuilder().
ModConfigBuilder builder = new ModConfigBuilder();
A value can be added to the config with ModConfigBuilder#define which takes a name and a default value.
For integer and double values a minimum and maximum value are also required.
Test code block;
ModConfigBuilder#define returns a Supplier which should be stored to retrieve the value from the config.
Supplier<Boolean> booleanValue = builder.define( "booleanValue", true );
Supplier<Integer> integerValue = builder.define( "integerValue", 5, 0, 10 );
Supplier<Double> doubleValue = builder.define( "doubleValue", 0.5, 0, 1);
Supplier<ExampleEnum> enumValue = builder.define( "enumValue", ExampleEnum.VALUE_1 );
A comment can be added to a value by calling ModConfigBuilder#comment(String) before defining the value.
Supplier<Boolean> valueWithComment = builder.comment( "this is a comment for 'valueWithComment'" ).define( "valueWithComment ", true );
By default values are reloaded when world is loaded.
This can be changed to only reload a value when Minecraft launches by calling ModConfigBuilder#gameRestart() before defining the value.
Supplier<Boolean> notReloadedValue = builder.comment( "this is value will not be reloaded" ).define( "notReloadedValue", true );
Values in COMMON or SERVER configs are synchronized with clients by default, to prevent this use ModConfigBuilder#dontSync().
Supplier<Boolean> notSynchronizedValue = builder.comment( "this is value will not be synchronized" ).define( "notSynchronizedValue", true );
Values can also be put into categories.
ModConfigBuilder#push(String) pushes a category and ModConfigBuilder#pop() pops a category.
builder.push( "special" );
Supplier<Boolean> specialValue = builder.comment( "this value is in the 'special' category" ).define( "specialValue", true );
builder.pop();
A comment can be added to the active category using ModConfigBuilder#categoryComment(String).
builder.push( "client" ).categoryComment( "this, is a comment for the 'client' category" );
After defining all values ModConfigBuilder#build() must be called to finish the config.
builder.build();
Now the values in your config will reloaded and synced automatically and the values can be retrieved using the stored Supplier instances.
This will work for all available versions, that includes Minecraft 1.12, 1.14, 1.15, and 1.16
Example Mod:
For a concrete example of how to use Config Lib checkout the example mod.
Discord
For future content, upcoming mods, and discussion, feel free to join the SuperMartijn642 discord server!
Compatibility
Mod Loaders
Game Versions
Recommended Gear
AffiliateHardware and extras that pair well with this mod.
As an Amazon Associate I earn from qualifying purchases.
Similar Mods
Just Enough Items (JEI)
View Items and Recipes
Cloth Config API (Fabric/Forge/NeoForge)
Config Screen API for Minecraft
Mouse Tweaks
Enhances inventory management by adding various functions to the mouse buttons.
Fabric API
Core API library for the Fabric toolchain
AppleSkin
Adds some useful information about food/hunger to the HUD
GeckoLib
A 3D animation library for entities, blocks, items, armor, and more!
Included in Modpacks (3,564)
Show fewer
HORYZONEA
Race To Space Parasites
Blue Skies & Black Smoke
Sovereign Colonization
Machina Arcanum
Cobblemon Odyssey MMORPG
A Crazy Adventure: Science & Survival
Peace of Mind 21.1
GeoThronesSMP
Cups & Wine
Createrington Nomads
Skyblock Alchemy Reconstruction Era
Create Reiterated - S2
Angels PvP Pack
Fancy's Last Stand
OneBlock Cobblemon NDC
Modled
Fantasy-Reimagined
Saturn SMP 2
Create&Greg 2
Tank Booth: Mythos & Mechanica
FOREVER WORLD - KRGG
Pingwin Pack (Tech/Survival)
Tov's Happy Homestead
Fall of Days – Zombie Survival
Arise SMP
Wheel of Mods 3
Deanverse Heroes
To the Stars - Etoile
CreateSMP Aeronautics
Xomaps Element
BSMP - BRUTALSMP
Limbones Server Modpack
Create Astralization
![Instant Assault [Create + TacZ]](https://media.forgecdn.net/avatars/1920/809/639196904425637878.png)
Instant Assault [Create + TacZ]
Cobblemon Reign
CanarioLand 2
Create End Survival
Create Coasters Server
Halloween-Craft 2
Silver's Cobblemon
Convergence
Chaotic Modpack
Potato RPG - Performance Meets Adventure
Create: Aeronautics Experience
BossCraft Milu's Edition
Classic, but not a classic - CBNC
MonyaPack
Mythic Machina
Create: Up and Away
AREACRAFT
Adventure Wildfront
Project SCP (Discontinued)
Harvest Haven
Magecraft: A Gods Tale
Redwolf's Crazy World
Advenium 3
Casino Block
Technopolis
Oasis Tropic
Lovebirds
Mitte-Erde
Apotheosis Pack 3
All About Factory - Industrial Tech & Automation
The Stalker's Story
Everwind Field Equestrian
Ex.Beta RDX
Farmer's Chill Life
Descend In The Madness
Omega Created Technology
Master Farmer's
FNAF: Reborn
Create Terrible Creations
ChaosCraft JS Edition
the horror of the dwellers and more
ZenCobblemon
Ride & Reign
BuddelTech
Create: Punk'd
Holdy's Chronicle
Pickable Me
EwMedieval Modpack
Create Mod-Attack
Community Horror Pack
Karmalandia Oficial BY KKurotsukii
Gex RPG
BurningCube
Christmas Fantasy
BurgeFactory
Soulspark
LightCraft Season 3
Zenith Lite
Atlas Project
Andy's Vanilla+ Modpack
Survival Refined
Create TSS
BMCITY - ONE MORE TIME
Jotunheimr
Comfycraft
Goonercraft: Industrial