
SuperMartijn642's Config Lib
SuperMartijn642
34,758,891 downloads · 1,326 followers
Minecraft: Minecraft 1.12 – 26.3
Runs on: Client & server
カテゴリー: library
Compatibility by loader
- fabric1.18 – 1.21, 26.1 – 26.3· Latest 1.1.8a-fabric-mc26.3 (2026年9月29日)
- quilt1.18 – 1.21, 26.1 – 26.3· Latest 1.1.8a-fabric-mc26.3 (2026年9月29日)
- forge1.12 – 1.12.2, 1.14 – 1.21, 26.1 – 26.2· Latest 1.1.8a-forge-mc26.2 (2026年9月29日)
- neoforge1.12 – 1.12.2, 1.14 – 1.21, 26.1 – 26.3· Latest 1.1.8-neoforge-mc26.3 (2026年9月15日)
Required with
Overview
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.
ModConfigBuilder#define returns a Supplier which should be stored to retrieve the value from the config.
Supplier booleanValue = builder.define( "booleanValue", true );
Supplier integerValue = builder.define( "integerValue", 5, 0, 10 );
Supplier doubleValue = builder.define( "doubleValue", 0.5, 0, 1);
Supplier 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 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 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 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 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, 1.16, 1.17, 1.18, and 1.19.
Example Mod:
For a concrete example of how to use Config Lib checkout the example mod.
FAQ
Can I use your mod in my modpack? Yes, feel free to use my mod in your modpack
Discord
For future content, upcoming mods, and discussion, feel free to join the SuperMartijn642 discord server!

Modrinth modrinth
indexable