Simple Config Lib
Every Minecraft mod developer knows the pain of building a settings screen from scratch. You write the same boilerplate code for buttons, sliders, and text fields, then wrestle with saving and loading data across different game versions. Simple Config Lib eliminates that entire routine. This library lets you describe your mod's configuration as a plain Java class, and it handles everything else: the interface, the file storage, and the localization. The result is a consistent, predictable settings experience for players on Fabric, Forge, and NeoForge alike.
What Makes Simple Config Lib Different?
Most configuration libraries force you to learn a proprietary API or manually build UI components. Simple Config Lib flips the model. You define a class with fields, annotate them as needed, and the library generates a fully functional settings screen with a single call. It automatically saves and loads values, so you never touch a config file directly. This approach means less code to maintain and fewer bugs across updates.
Core Features at a Glance
- Class-level configuration: Describe settings with ordinary Java fields, no XML or JSON schemas required.
- Auto-generated UI: The library builds the settings screen for you, complete with appropriate controls for each data type.
- Zero file handling: Saving and loading happen automatically in the background.
- Cross-loader consistency: The same code works identically on Fabric, Forge, and NeoForge.
- Automatic localization: The library derives translation keys from your configuration structure, making i18n straightforward.
- Rich widget set: Support for sliders, toggles, dropdowns, and more, covering common data types.
- Client-side helpers: Utility methods for building custom screens, usable independently of the game version.
Who Should Use This Library?
There are two distinct audiences. For mod developers, Simple Config Lib is a time-saver that lets you focus on gameplay rather than infrastructure. For players, it usually appears as a dependency for another mod. You don't need to configure it yourself; it simply ensures that the mods you install have a working settings interface. If you're assembling a modpack, you can include it freely as long as you link back to the original project page.
Supported Loaders and Versions
The library supports the three major mod loaders: Fabric, Forge, and NeoForge. On Fabric, you must also install Fabric API for the library to function. Forge and NeoForge require no additional dependencies. The project tracks recent Minecraft versions, and because the configuration code is version-agnostic, you can write it once and use it across multiple game releases. This is a major advantage if you maintain a mod for several Minecraft versions simultaneously.
How to Install Simple Config Lib
Installation is straightforward. First, download Simple Config Lib from the official CurseForge or Modrinth page, matching the file to your Minecraft version and loader. Then place the JAR file into your mods folder. If you're using Fabric, ensure Fabric API is also present. For players, that's all you need to do. For developers, add the library as a dependency in your build script and start defining your configuration class.
If you prefer a more automated approach, the foxygame.net launcher offers a one-click install for Simple Config Lib for Minecraft, pulling the correct version for your loader and game edition without manual file management. Its add-on catalog keeps the library updated, so you always have a compatible build.
Step-by-Step for Players
- Check which loader your modpack uses (Fabric, Forge, or NeoForge).
- Download the matching Simple Config Lib JAR.
- Place it in the
modsfolder alongside your other mods. - Launch the game. The library works silently in the background.
Step-by-Step for Developers
- Add Simple Config Lib to your project dependencies.
- Create a configuration class with public fields for each setting.
- Call the library's registration method to generate the screen.
- Test on your target loader. The same code runs on all three.
Frequently Asked Questions
Do players need to install this manually? Only if a mod requires it. Simple Config Lib is a dependency, not a standalone tool. It needs no separate configuration and simply makes other mods' settings work.
Does it conflict with other mods? No. The library is designed to be passive and does not interfere with other mods' behavior.
Do I need different code for different loaders? No. Both the configuration and the helper utilities are loader-agnostic. Write once, run everywhere.
Where can I report bugs? The project's GitHub repository is the place for issues and feature requests.
Project Status and Future
Simple Config Lib began as an internal tool for the author's own mods, born from frustration with libraries that dropped Forge support on newer Minecraft versions. It has since grown into a public, actively maintained project. The feature set continues to expand, and bug fixes are released regularly. For mod developers tired of reinventing the settings wheel, this library offers a clean, modern solution that keeps pace with the game's evolution.
Whether you're a developer looking to cut boilerplate or a player who just wants mods to work smoothly, Simple Config Lib delivers a unified, reliable configuration experience. Its cross-loader design and automatic UI generation make it a standout choice in the Minecraft modding ecosystem. Try it on your next project, and you'll wonder how you managed without it.