Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
Renders every COAL-using mod's settings screen in Cloth Config, plus JSON persistence, load-time validation, and versioned migrations.
For players
Install all three side-by-side in your mods/ folder:
- COAL — the abstraction layer that COAL-consuming mods depend on.
- coal-cloth-adapter — this mod.
- Cloth Config — the GUI library that actually renders the screens.
Any mod that consumes COAL will use Cloth Config for its settings screen once these three are installed together.
Cloth vs. YACL
Cloth Config's sub-category widget recurses cleanly, so this adapter preserves deep-nested config trees end-to-end. YACL's equivalent flattens after two levels. If your mods declare heavily-nested configs and you want every level preserved in the GUI, pick this adapter.
Don't install alongside coal-yacl-adapter
Only one COAL adapter should be installed at a time. If you'd rather use
YACL, install coal-yacl-adapter
instead of this one.
For mod authors
You don't compile against this mod. Depend on coal-api +
coal-api-gui-<loader> at compile time; your users install whichever adapter
they prefer at runtime. See the docs for
the walkthrough.
Feature coverage
Advertises MIGRATION, VALIDATION, and GUI_DELEGATION. Does not advertise
SYNC, FILE_WATCH, JSON5, or CUSTOM_FORMATS — see the module README on
GitHub for the full annotation-to-widget mapping and known limitations.


