SuperMartijn642's Config Lib
Modby SuperMartijn642
Config Lib makes dealing with config files just a bit easier.
Type
Mod
CurseForge Downloads
191,226,797
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
Archimedes S7 Pack
Cobble X Friends
Bad No Cookie
Worlds O' Plenty II
AVD (Average Vanilla Desire)
EwServer
Vanilla++
Aero and Additions
Vanilla Cataclysst
Minimal - Optimized
Stardivers
Beyond Vanilla
CreateAbility
Oh no! It's Yet Another Pack
Lyrran's BattleCraft
Pigeon Craft s2
Orange Juice with Pulp
Create: Council of Sand
TPW: Redux
fedcraft
Dark's simple QoL
Fir3fr0gPersonalPack
Saniasu
Create: Industrial Frontier
Kinetic Civilisation
Poketod SMP
Cobblemon x Confluence
Creative Shock
NeoCraft: Horizons
Sosaland
Gaymers EU Create
Full Scale
KineticWorks
Extra Optimized QoL
AuroraSMP Season 5 Modpack
Glowy's Pack
En+anced Plus
SquirrelPAK 123
PeninsulaCraft
Perpetual Motion
Unnamed really cool community
Better Adventure Enhanced
Skyfication
Voiding of World
Iron Sky: TurboClocked
Mister Experience
RothCraft
Smolder's Ultimatum
DiamondFire Modpack
FlameCraft - Explore The Unknown
OptimisticMC Lycoris Pack
perfomance
Onyx
Vanilla Rewired
SkyForge (Member Edition)
JUSTCREATE_byzemzemsuyu
TinyN
BLOCK ALM
Hellstrike: Advanced Warfare
Ethereal Wrath
Purgreate
Virimon
Official Yakuza modpack
SilentTech
SYNCRAFT
Better Create
Titanroot Skies
OptimNVC QoL
Inazuma Cobblemon
NEOptimized
SirLaughalotMC Plays Create Modpack
MC Sooty Edition
MeepPack
