Easy Config
by iso2t
Easy Config is a Fabric and NeoForge library that lets mod authors declare settings as annotated classes and provides an in-game config screen for them.
What it does
A mod author defines a config as a Java class, and annotation processing turns the annotated fields into a config file and a matching screen. The same API runs on Fabric and NeoForge, so one config definition serves both loaders. Lower-level interfaces are also available for custom loading, saving and metadata handling when the class-based approach is not enough.
Players can change settings in the game without opening files by hand, and the screen groups options into tabs when a mod has more than one config. Installing Fabric API is required on Fabric, and Mod Menu is optional, since it adds access to the in-game screen from the mod list. Heavy Inventories requires Easy Config, so it cannot run without it.
Easy Config is client and server, so the server and every player need it. It is open source under the GNU Lesser General Public License v3.0 only, and its source code and issue tracker are public. Files are published for 26.2 and 26.3 on both loaders, with 1.263.0.9 for 26.3 as the latest file.
Key features
Class-based config definitions
Options are declared as fields of a class and annotations describe how each one is shown and stored.
Single API for two loaders
The same config API works on Fabric and NeoForge, so a mod does not need separate config code per loader.
In-game config screens
Settings can be changed in a screen inside the game, so players do not have to edit config files manually.
Tabbed configs
Mods with more than one config are shown with a tab for each, keeping long option lists organized.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
Required by 1 mod
Use cases
Who it’s for: Mod developers who want configurable options without writing file parsing and screen code, and players who prefer changing settings in the game over editing files.
How it compares
SugarLib is a Fabric and NeoForge library for 1.21.1, and it works on either side, with neither side required to run it, under the MIT License. Stator is a client and server library for 26.1 – 26.2 on Fabric and NeoForge under the MIT License. Easy Config covers 26.2 – 26.3 on both loaders and is open source under the GNU Lesser General Public License v3.0 only.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Easy Config | Fabric and NeoForge | 26.2 – 26.3 | Client and server | 2026-09-29 |
| SugarLib | Fabric and NeoForge | 1.21.1 | Client or server, optional | 2024-11-30 |
| Stator | Fabric and NeoForge | 26.1 – 26.2 | Client and server | 2026-08-23 |
Questions
Does Easy Config need Fabric API on Fabric?
Must Easy Config be installed on the server?
Is Mod Menu needed to open the config screen?
Which versions does Easy Config support?
In the catalog
Easy Config is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.
More from iso2t
Similar mods
What the author says
A class-based config API and in-game config screen for Minecraft mods. EasyConfig makes it easy to create, modify, and share config files for your mod. With an easily accessible in-game config screen, users can adjust settings on the fly without having to manually edit config files.
Official listing
- Modrinth page
- modrinth.com/mod/easy-config
- Owner
- iso2t
- Published
- 2026-07-18
- Updated on Modrinth
- 2026-09-29
- Facts verified
- 2026-10-15