Cloth Config API — the Library Behind Every Mod Settings Screen
Fabric · Forge · NeoForge · 383.5M downloads

Cloth Config API: the mod behind the settings button

Cloth Config is the library that mods use to build their in-game settings screens. Sliders, toggles, dropdowns, text fields — written once, working on Fabric, Forge, and NeoForge. Without it, a mod that offers configuration either crashes on startup or forces you to edit a JSON file by hand. With it, you get the config screen you have probably used a hundred times without noticing which library drew it.

Fabric / Forge / NeoForge Minecraft 1.21.4 Library / API Verified source

Quick facts

CategoryLibrary / API
LoadersFabric, Forge, NeoForge
Minecraft1.21.4 and older supported versions
Authorshedaniel
SourceCurseForge
Downloads383.5M (CurseForge, Sep 2026)
SideClient-side (for config screens)

Source status

Verified

The download below is the file listed in our catalogue. Metadata last checked November 2026.

View on CurseForge →

Opens CurseForge in a new tab. CurseForge's terms apply.

Minecraft Mod

The mod behind the settings button

Cloth Config API screenshot showing a mod settings screen with sliders, toggles, and dropdowns rendered by the library
A mod's settings screen, rendered by Cloth Config on Fabric 1.21.4. The sliders, toggles, and dropdowns are all library widgets — the mod supplies the values, Cloth Config draws the UI and writes the file.
External link

Get Cloth Config API

One JAR per loader. Drop into mods for Fabric, Forge, or NeoForge — config screens are client-side.

Visit Cloth Config API

File: cloth-config.zip · External — creator's site · No redirects, no ads

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

1
Config screen frameworkA consistent UI for sliders, toggles, dropdowns, and text fields — the same widget set across every dependent mod.
2
Multi-loader supportThe same config screen renders identically on Fabric, Forge, and NeoForge. The mod does not branch per loader.
3
Mod Menu integrationOn Fabric, Cloth Config screens open from the Mod Menu mod list — the standard route to a mod's settings.
4
Save/load handlingConfig values are validated and written to the mod's config file automatically. The mod does not manage the file itself.

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.

  1. Download the JAR matching your loader — Fabric, Forge, or NeoForge. The JARs are not interchangeable.
  2. Download the JAR matching your Minecraft version. Cloth Config ships separate builds per MC version; loading the wrong one will crash on startup.
  3. Drop the JAR into .minecraft/mods (or your launcher's mods folder for the profile you are using).
  4. 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.
Dependency, not a feature mod. Cloth Config adds nothing visible to the game by itself. If you are installing it because a mod told you to, that is the only reason you need it. Remove the dependent mod, and Cloth Config can be removed too.

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.

FieldValue
CategoryLibrary / API
LoadersFabric, Forge, NeoForge
Minecraft versions1.21.4 and older supported versions
SideClient-side (for config screens)
SourceCurseForge (shedaniel)
Downloads383.5M (CurseForge, Sep 2026)
Last verifiedNovember 2026

Frequently asked questions

Do I need Cloth Config for every mod?
No. Only mods that explicitly list Cloth Config as a dependency need it. Many mods use their own config system or none at all.
What happens if I skip Cloth Config?
The dependent mod may crash on startup, or its settings button may do nothing. Some mods fall back to a config file you can edit manually, but the in-game settings menu won't work.
Is Cloth Config client-side or server-side?
Client-side for config screens. The settings menu is a client UI, so the server does not need Cloth Config unless a specific mod uses it for server-side configuration.
Which loaders does Cloth Config support?
Cloth Config supports Fabric, Forge, and NeoForge. Choose the JAR matching your loader and Minecraft version.
Do I need Mod Menu to open config screens?
On Fabric, Mod Menu provides the mod list UI where Cloth Config screens open from. Without Mod Menu you'll need another way to reach the settings screen — typically the mod's own config key or command.

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.