Shadow Config

Mod developers use the library to define and read configuration files without writing the parsing code themselves. One config class can be written out as JSON, JSONC, TOML or YAML, so the same settings model works for any of those formats. Output is kept clean and formatted, and comments can be preserved when the file is rewritten.

Nested structures, lists and primitive values are handled through Jackson-based serialization. When a config changes shape between versions, the library migrates existing files automatically instead of requiring a hand-written mapping. Comments are injected from annotations, so the documentation in a file stays in step with the code that defines it.

The library is aimed at mod developers who want a small, focused dependency. Its runtime footprint is kept minimal, and it is published for Fabric, Forge and NeoForge so one codebase can serve several loaders. It is licensed under the Creative Commons Attribution 4.0 license and is not open source. The current files cover 1.12.2, 1.20.1, 1.21 and 1.21.1, and the library is required by three other mods: Stylish Battle Ranks, Regenerating Blocks and LegacyChecker.