Smootheez Config Lib
If you have ever tried to build a Minecraft mod, you know that configuration handling can be one of the most tedious parts of the process. Writing file managers, building screens by hand, and keeping everything in sync with your mod ID quickly turns into a chore. Smootheez Config Lib, often shortened to SCL, exists to eliminate exactly that problem. It is a lightweight utility mod that gives developers a cleaner, faster way to manage configuration files and in-game settings.
Although it was originally created for the author's own projects, Smootheez Config Lib is freely available for anyone to use. Whether you are building a small quality-of-life mod or a large content expansion, this library can save you hours of repetitive coding.
What Does Smootheez Config Lib Actually Do?
At its core, SCL handles the boring parts of configuration so you can focus on gameplay features. Instead of writing custom serialization logic, you simply declare your options and let the library take over. The main capabilities include:
- Config file management with automatic reading and writing
- Automatic config screen generation
- Automatic config file generation
- In-game previews for quick testing
- A standard config screen layout
- Config screens with descriptive tooltips
- Editing values directly inside an OptionList
- Adding new values to an OptionList at runtime
- A confirmation screen for destructive or important changes
This means less boilerplate, fewer bugs, and a consistent look across every mod that adopts the library.
Supported Minecraft Versions and Loaders
Smootheez Config Lib is built for modern Minecraft and targets the Fabric loader. It is compatible with Minecraft 1.20.1 and newer releases, making it a solid choice for developers working on current projects. Because the library relies on the Fabric entrypoint system, integration is straightforward for anyone already familiar with Fabric mod development.
If you are browsing for tools to speed up your workflow, the foxygame.net launcher includes Smootheez Config Lib in its curated add-on catalog, so you can add it to a compatible profile in a single click without hunting through separate repositories.
How to Install Smootheez Config Lib
Adding the Repository
The first step is to point your build system at the JitPack repository. In your build.gradle file, add the JitPack Maven URL inside the repositories block. This allows Gradle to resolve the library from its public source.
Adding the Dependency
Next, declare the dependency itself. You can reference a version stored in your gradle.properties file, or specify a version number directly. Using a property keeps your version management tidy, especially if you plan to update SCL alongside other libraries.
Creating a Config Class
With the dependency in place, create a class annotated with the Config annotation. Inside it, define your options using ConfigOption. Integers, doubles, booleans, enums, and OptionList values are all supported. You can also mark numeric options as sliders or percentage sliders, which changes how they appear in the generated screen.
Registering the Config
Finally, register your config class in your fabric.mod.json under the scl entrypoint. Once registered, Smootheez Config Lib automatically generates both the config file and the config screen. Note that the screen requires ModMenu to be present, the gui flag must be set to true, and the config name should match your mod ID.
Why Developers Keep Coming Back
The real value of SCL is consistency. Every mod using it gets the same clean interface, the same confirmation prompts, and the same option list behavior. Players benefit too, because they do not have to learn a new config layout for every mod they install. For anyone searching to download Smootheez Config Lib, the payoff is a smoother development cycle and a more polished end product.
If you are ready to try it, look for Smootheez Config Lib for Minecraft on Modrinth, CurseForge, or the JitPack releases page. The project is licensed under MIT, so you are free to include it in your own work. Found a bug or have a suggestion? The GitHub issue tracker is the place to share feedback. For developers tired of writing config code by hand, SCL is a small dependency that delivers a big improvement.