SuperMartijn642s Config Lib FAQ
10 questions players actually ask, answered.
How do I create a config file for my mod using Config Lib?
In your mod's code, build a ConfigBuilder, add your options with the provided value types, and call the build method with a name and a path. Config Lib then creates the file and handles loading, saving, and syncing automatically.
Where does Config Lib put the config files it generates?
It writes them to the standard config folder for your mod loader, typically inside a folder named after your mod. The exact path is determined by the name and directory you pass when building the config.
How do I make a config value apply to everyone on a server instead of just me?
Mark the option as a server config rather than a client config when registering it. Server values are read from the server's file and synced to connected clients, so all players see the same setting.
What's the difference between client, server, and common configs in Config Lib?
Client configs are per-player and only exist on the client, server configs live on the server and sync to players, and common configs are loaded on both sides. Choosing the right type determines who can change a value and whether it syncs.
Why does my config value reset or not save after I change it?
This usually happens when the value is edited while the game is running without triggering a save, or when a server config is changed on the client side where it has no effect. Edit the correct file for the config type and reload or restart so the change is picked up.
Can I change config options in-game without restarting?
Yes, Config Lib supports reloading values between world loads and can apply changes without a full restart. Some options may still require a world reload or rejoin to take effect depending on how the mod reads them.
How do I edit a mod's config file by hand?
Open the config file in a text editor, change the values while keeping the existing structure and keys intact, then save. Config Lib will read the updated file the next time it loads or reloads the config.
Does Config Lib work on both the client and the server?
Yes, it is designed to run on both sides and handles syncing values between them. Server-side values are authoritative and get sent to clients so everyone stays consistent.
Will Config Lib slow down my game or cause performance issues?
No, it is a lightweight library focused on config handling and does not add ongoing per-tick overhead. Any performance impact comes from the mods using it, not from the config system itself.
Do I need Config Lib installed on both the client and server for mods that use it?
Yes, any mod that depends on Config Lib requires it on both sides, since the library handles loading and syncing on client and server. Missing it on either side will prevent those mods from working.