Wiki 9Minecraft Wiki 9Minecraft

Cloth Config API FAQ

17 questions players actually ask, answered.

What does Cloth Config actually do?
It's a library that other mods use to build their in-game settings screens, so it adds no items, blocks, or settings of its own. If you installed it alone, you won't see anything new in-game until another mod depends on it.
How do I open a config screen that uses Cloth Config?
Open the mod list, find the mod whose settings you want to change, and click its config button. Many mods also add a keybind or a button on the main menu or pause menu that opens their Cloth Config screen directly.
Why can't I find Cloth Config in my mod list's config button?
Cloth Config itself has no settings to configure, so it usually has no config button of its own. Look for the config button on the mod that depends on Cloth Config, not on Cloth Config itself.
Do I need Cloth Config installed on a server?
It's a client-side library, so it belongs in your client mods folder for the settings screens to render. Installing it on a server does nothing for players and won't fix a missing-screen problem on their clients.
A mod says it requires Cloth Config but I already have it — why is it still broken?
You likely have a version mismatch between Cloth Config and the mod that needs it, or the two are built for different Minecraft versions. Make sure both target the same Minecraft version and update whichever one is older.
My config screen opens but the Save button doesn't stick.
Some mods only apply changes after a game restart, while others save instantly and just don't show a confirmation. If edits vanish entirely, the mod's config file may be read-only or the screen may be failing to write — check the mod's own config file permissions.
Can I edit Cloth Config settings without opening the game?
Yes — each mod that uses Cloth Config writes its own config file, usually JSON, in the config folder. Edit that file directly while the game is closed, then relaunch; the in-game screen will reflect your changes.
Does Cloth Config hurt performance or cause lag?
No, it only runs when a settings screen is open, so it has no measurable impact during normal gameplay. If you're seeing lag, it's coming from the mod whose config you're editing, not from Cloth Config.
Will Cloth Config conflict with other config mods?
It coexists fine with other config libraries because each mod picks which one it uses. Conflicts only appear when two mods try to register the same keybind or menu button, which is a mod-level issue rather than a Cloth Config one.
Can I remove Cloth Config if I don't use any mods that need it?
Yes, but check your mod list first — many popular mods silently depend on it, and removing it will crash the game on startup with a missing-dependency error. If nothing depends on it, it's safe to delete.
What does Cloth Config API do in Minecraft?
It is a client-side configuration library that provides a settings screen framework for other mods. It adds no items or blocks of its own.
What is the Cloth Config API Mod?
Cloth Config API is a config screen API and library for Minecraft mods. It is a technical mod that serves as a dependency for other mods.
Do I need to install Cloth Config API?
You only need to install it if another mod requires it. It doesn't add any content or make changes to gameplay on its own.
How do I use Cloth Config API?
It is a library used by mod developers to build config screens, and it provides a Mod Config Screen. Players generally don't interact with it directly beyond having it installed for mods that depend on it.
How do I access Cloth Config API?
It provides a Mod Config Screen for the mods that use it. There is no standalone Cloth Config menu of its own.
Does Cloth Config API work with NeoForge?
Yes, the mod author lists fabric, forge, and neoforge as supported loaders.
Is Cloth Config API client-side or server-side?
It is listed as client and server. It is a client-side configuration library that provides a settings screen framework for other mods.