Quick facts
| Category | Library / API |
| Loaders | Fabric, Forge, NeoForge |
| Minecraft | 1.21.4 and older supported versions |
| Author | shedaniel |
| Source | CurseForge |
| Downloads | 383.5M (CurseForge, Sep 2026) |
| Side | Client-side (for config screens) |
Source status
Verified
The download below is the file listed in our catalogue. Metadata last checked November 2026.
Opens CurseForge in a new tab. CurseForge's terms apply.
The mod behind the settings button
Get Cloth Config API
One JAR per loader. Drop into mods for Fabric, Forge, or NeoForge — config screens are client-side.
What Cloth Config actually does
Cloth Config is a UI library for mod config screens. A mod that wants to expose settings to the player normally has two options: write its own UI code for each loader, or depend on a library that does it. Cloth Config is that library, and it is the one most mods pick — not because it is the only option, but because it already handles the loader-specific differences, the widget rendering, and the save/load cycle.
The player-facing effect is simple. If a mod page says "requires Cloth Config API," install it. You get the mod's settings menu. If you skip it, the dependent mod may crash on startup, or its settings button may do nothing. The fallback — editing the mod's JSON config file by hand — technically works, but the in-game menu will not, and the mod author's documentation assumes the menu.
Cloth Config's role in the ecosystem is larger than its own feature list suggests. Hundreds of mods use it — performance mods, utility mods, content overhauls — because writing a config UI from scratch is tedious and easy to get wrong. If you have ever adjusted a slider in a mod's settings screen without thinking about which library drew that slider, the answer is very often Cloth Config.
What happens if you skip it
The failure mode depends on how the dependent mod was written, and it is worth knowing the three possibilities before you decide Cloth Config is optional:
- Hard crash on startup. The mod declares Cloth Config as a required dependency, and the loader refuses to launch without it. This is the most common case, and it is the easiest to diagnose — the crash log names Cloth Config explicitly.
- Silent settings failure. The mod loads, but its settings button does nothing, or the config screen opens blank. This happens when the mod treats Cloth Config as optional but uses it for the UI.
- File-only fallback. The mod falls back to a JSON config file that you can edit by hand. The in-game menu does not work, but the mod's functionality is intact.
On Fabric specifically, there is one more thing worth knowing: Cloth Config screens are usually opened from the Mod Menu mod list. If you have Cloth Config but not Mod Menu, the settings screens exist but you have no easy way to reach them — you need the mod's own config key or command. That is not a Cloth Config problem, but it is the most common reason players think Cloth Config is not working.
What the library provides
How to install it (client-side for config screens)
Cloth Config is a library mod. For config screens, it is client-side only — the server does not need it unless a specific mod uses it for server-side configuration. The install is the same as any other mod JAR.
- Download the JAR matching your loader — Fabric, Forge, or NeoForge. The JARs are not interchangeable.
- Download the JAR matching your Minecraft version. Cloth Config ships separate builds per MC version; loading the wrong one will crash on startup.
- Drop the JAR into
.minecraft/mods(or your launcher's mods folder for the profile you are using). - Launch the game. Dependent mods will now show their config screens. On Fabric, open Mod Menu to reach them — without Mod Menu, you need the mod's own config key.
Compatibility at a glance
Every value below comes from the creator's official source page. Where the creator doesn't state a field, we mark it "Unknown" rather than guess.
| Field | Value |
|---|---|
| Category | Library / API |
| Loaders | Fabric, Forge, NeoForge |
| Minecraft versions | 1.21.4 and older supported versions |
| Side | Client-side (for config screens) |
| Source | CurseForge (shedaniel) |
| Downloads | 383.5M (CurseForge, Sep 2026) |
| Last verified | November 2026 |
Frequently asked questions
Do I need Cloth Config for every mod?
What happens if I skip Cloth Config?
Is Cloth Config client-side or server-side?
Which loaders does Cloth Config support?
Do I need Mod Menu to open config screens?
Why this listing exists
Most resource sites either dump hundreds of unverified links with no context, or hide downloads behind fake countdown timers and redirect chains. This page follows a different approach: it shows the resource's real metadata, links to the creator's original page, and states clearly what we have and have not verified.
If you find a broken link, an incorrect version, or a download that goes somewhere unexpected, report it using the contact form. If you are the creator and want this listing removed or changed, see Copyright / DMCA.
Related mods
Report a problem with this page: contact form. If you are the creator and want this listing changed, see Copyright / DMCA.