COAL - Cloth Config adapter
by oliveryasuna
COAL - Cloth Config adapter lets a COAL-using mod show its settings in a Cloth Config screen, with the config tree kept intact.
What it does
The adapter renders the settings screen of a mod that uses COAL, the abstraction layer other mods depend on, through the Cloth Config GUI library. It is meant for mods that declare heavily nested configs and want the nesting level kept in the GUI, because the sub-category widget recurses cleanly and preserves deep config trees end to end. The mod is listed for Fabric and NeoForge only, for 1.21.8, and it is open source under the MIT License.
Only one COAL adapter can be installed at a time, so a player who prefers the YACL screen installs coal-yacl-adapter instead. Users choose whichever adapter they prefer at runtime, while developers do not compile against either mod. The adapter depends on coal-api and coal-api-gui at compile time, and it needs COAL and Cloth Config to run. Either side can run it, and neither needs it, so the mod is optional on clients and servers alike.
Key features
Cloth Config settings screen
Settings of a COAL-using mod appear in a Cloth Config screen once the three mods are installed together.
Deep config trees preserved
Nested sub-categories keep their depth, where the YACL equivalent flattens after two levels.
Runtime choice of adapter
Players swap between this adapter and the YACL one by changing which file is in the mods folder.
Documentation walkthrough
A written walkthrough explains how to set up the three mods and how the adapter fits with COAL.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Heavily nested configs
A mod with deeply nested settings can keep its structure when it is shown in the Cloth Config screen.
Who it’s for: Players who run COAL-using mods and prefer the Cloth Config screen, and mod authors who want their nested configuration shown without flattening.
How it compares
Cloth Config API is the library this adapter renders through, with files for Fabric, Forge and NeoForge across 1.14 – 26.3, licensed under the GNU Lesser General Public License v3.0 only. GroovyDuvet is a Fabric and Quilt mod for 1.19.2 – 1.21, open source under the GNU Lesser General Public License v3.0 or later. Scelli is a server-side only Fabric mod for 1.21.8 – 1.21.11 under the MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| COAL - Cloth Config adapter | Fabric and NeoForge | 1.21.8 | Client or server, optional | 2026-07-06 |
| Cloth Config API | Fabric, Forge and NeoForge | 1.14 – 26.3 | Client or server, optional | 2026-09-23 |
| GroovyDuvet | Fabric and Quilt | 1.19.2 – 1.21 | Client or server, optional | 2024-06-21 |
| Scelli | Fabric | 1.21.8 – 1.21.11 | Server-side only | 2026-02-26 |
Questions
Does COAL - Cloth Config adapter need Cloth Config?
Can the adapter and coal-yacl-adapter run together?
Which loaders and versions are supported?
In the catalog
COAL - Cloth Config adapter is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 17,695 mods support Minecraft 1.21.8.
More from oliveryasuna
Similar mods
What the author says
Renders every COAL-using mod's settings screen in Cloth Config, plus JSON persistence, load-time validation, and versioned migrations. Any mod that consumes COAL will use Cloth Config for its settings screen once these three are installed together.
Official listing
- Modrinth page
- modrinth.com/mod/coal-cloth-config-adapter
- Owner
- oliveryasuna
- Published
- 2026-07-06
- Updated on Modrinth
- 2026-07-06
- Facts verified
- 2026-10-15