Cloth Config
by shedaniel
A configuration screen API that provides a standardized way for mods to display and edit their settings in-game.
Overview
Cloth Config is a library mod created by shedaniel. A configuration screen API that provides a standardized way for mods to display and edit their settings in-game. As a library mod it concentrates on shared code that other mods build on, and it has been downloaded around 250 million times, which puts it among the options players reach for in this space.
Cloth Config is built for players installing mods that use it for their in-game settings screens. Cloth Config supplies a reusable configuration-screen framework, so it appears as a dependency whenever a mod offers a polished options menu. It is approachable enough to drop into a world and use right away, with little setup required.
The mod is available for Forge, Fabric, NeoForge, and Quilt, so it fits a range of modpacks and launchers. It currently supports Minecraft 1.20.1, 1.20.4, and 1.21.1, spanning the 1.20.1 to 1.21.1 releases. It is a client-side mod, which means you can add it to your own game for personal benefit even when the server you join does not run it.
Mod Loaders
Minecraft Versions
Key Features
Cloth Config brings a focused set of features to the table. Highlights include in-game configuration screens, plus multiple input types and widgets, with the full list below.
- In-game configuration screens
- Multiple input types and widgets
- Category and sub-category support
- Search and filter configs
- Tooltip descriptions
Tags
How to install Cloth Config
Cloth Config supports Forge, Fabric, NeoForge, and Quilt; pick one loader (you cannot mix them) and install it for your chosen Minecraft version. It is built for Minecraft 1.20.1, 1.20.4, and 1.21.1, so make sure your profile uses one of those versions.
- 1Choose and install one mod loader from Forge, Fabric, NeoForge, and Quilt for a Minecraft version this mod supports (1.20.1, 1.20.4, and 1.21.1).
- 2Check the download page for any required libraries. Cloth Config lists no hard dependencies here, but it is always worth confirming for your exact version.
- 3Drop the Cloth Config .jar file into your instance's mods folder. On a server, place it in the server's mods folder instead, and each player who wants it adds it to their own client.
- 4Launch the game with that loader profile and confirm Cloth Config appears in the in-game mods list; if it does not load, re-check the loader, the Minecraft version, and any library requirements.
Supported Minecraft versions: 1.20.1, 1.20.4, and 1.21.1. Always download the build that matches your version exactly, as mod files are version-specific.
See our full mod install guideCompatibility & alternatives
Because it ships for both Fabric and Forge-family loaders, it slots into most popular modpacks regardless of which side they are built on.
As a library mod, Cloth Config adds no content of its own and has a negligible footprint, it exists to support the mods that depend on it.
If you are comparing options, a similar mod worth a look is (no direct alternative, it is a config library). They overlap in purpose, so most players pick whichever suits their loader and pack.
Frequently asked questions
What does the Cloth Config mod do?
A configuration screen API that provides a standardized way for mods to display and edit their settings in-game. It is a library mod by shedaniel, aimed at players installing mods that use it for their in-game settings screens.
Is Cloth Config Forge or Fabric?
Cloth Config supports Forge, Fabric, NeoForge, and Quilt. You only install it on one of these loaders, never several at once, so choose the one your pack uses.
What Minecraft versions does Cloth Config support?
Cloth Config supports Minecraft 1.20.1, 1.20.4, and 1.21.1. Be sure to download the file built for your specific version, since mod jars are not interchangeable across versions.
Does Cloth Config need any dependencies?
No, Cloth Config lists no required mod dependencies here, so it works as a standalone install. It is still wise to confirm on the download page for your exact version.
Can I use Cloth Config on a multiplayer server?
Yes. Cloth Config is client-side, so you can run it yourself on any server, even one that does not have the mod, since it does not require server support.
Play modded Minecraft
Host a modded server with Astroworld Hosting or join our community.
Try Astroworld Hosting