BurnedConfig
by bnBurned
BurnedConfig is a Fabric and Forge configuration library that creates, loads, saves and reloads JSON config files for other mods, with an API for nested sections.
What it does
Developers call the library to generate JSON configuration files automatically from their defined settings. When a file is missing, it is created with default values, and when a new entry is added to the code, the matching key is filled into existing files while user values stay as they were. Files that cannot be parsed are backed up before a fresh copy is written, so earlier settings are not lost.
The library is built for configuration work that would otherwise be repeated in every project: reading, writing, reloading and updating files. Settings can be grouped into nested sections. Its author describes the goal as a small, lightweight tool with minimal dependencies and few memory allocations, so it suits small utilities as well as large server projects.
It is published for Fabric and Forge under All rights reserved, which means the license does not grant permission to reuse the code. Either side can run it, and neither a client nor a server needs it. Files cover 1.18 – 26.2, with the latest Fabric build 1.0.0 for 26.2 and the latest Forge build 1.0.0 for 1.21.11, both dated 2026-07-21.
Key features
Automatic JSON files
Config files are created, loaded, saved, reloaded and updated in JSON from a simple API call.
Nested sections
Settings can be organized into nested sections, so related options stay grouped in one file.
Default value sync
Missing entries are added with their default values while existing user settings are preserved.
Lightweight design
The library avoids unnecessary allocations and expensive operations, and its dependency list is kept to a minimum.
Compatibility
Latest build for each game version and loader.
26.x4 of 4 versions with builds
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Small mod settings
A mod author with a few options can declare them once and let the library handle file creation and reloading.
Server configuration
Large server projects can use nested sections to group many settings across several config files.
Who it’s for: Mod developers who need JSON configuration files with automatic creation, updates and backups, without writing the file handling themselves.
Questions
Does BurnedConfig need other mods installed?
Is BurnedConfig installed on the server, the client or both?
What happens to a config file that cannot be read?
In the catalog
BurnedConfig is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,894 mods support Minecraft 26.2.
More from bnBurned
Similar mods
What the author says
BurnedConfig is a modern, lightweight, and high-performance configuration library built for developers who want a simple, reliable, and maintainable way to manage configuration files. 🚀 It takes care of the repetitive work so you can focus on building great software instead of writing endless configuration code. 📄…
Official listing
- Modrinth page
- modrinth.com/mod/burnedconfig
- Owner
- bnBurned
- Published
- 2026-07-21
- Updated on Modrinth
- 2026-07-21
- Facts verified
- 2026-10-15