How to Fix Cloth Config API Errors
Mods that depend on Cloth Config API won't load without it. How to read the Fabric Loader and NeoForge messages and pick the Cloth Config file that fits.
Quick Fix
Download Cloth Config API for your mod loader and exact Minecraft version from Modrinth or CurseForge, put it in the same mods folder and restart.
Error Message
Mod 'Example Mod' (examplemod) 1.0.0 requires any version of cloth-config, which is missing!How to Fix
Download Cloth Config API from Modrinth or CurseForge and pick the file for your loader and your exact Minecraft version.
Put the jar in the same mods folder as the mod that needs it, then restart the game or server completely.
Under A potential solution has been determined, Fabric Loader lists what to add, for example Install cloth-config, any version. That line gives the version range you need.
If the wrong version is present, replace your Cloth Config jar with one inside the range the message asks for, and delete older copies so only one is left.
Search the log for both ids. Cloth Config is cloth-config on Fabric and cloth_config on Forge and NeoForge.
On a server, install Cloth Config only when a mod on that server needs it. Modrinth marks Cloth Config itself as optional on both client and server.
Common Causes
- Cloth Config isn't installed. Fabric Loader stops with Incompatible mods found! and names the mod that requires cloth-config, which is missing. NeoForge says the mod requires cloth_config and that cloth_config is not installed.
- The Cloth Config file is for a different loader. Fabric, Forge and NeoForge each have their own Cloth Config file, and only the one made for your loader works.
- The Cloth Config file is for a different Minecraft version. Every file lists the versions it supports; 26.2.155+fabric, for example, only supports 26.2.
- The mod needs a newer Cloth Config than the one installed. Fabric Loader then reports that the mod requires a certain version of cloth-config, but only the wrong version is present.
Diagnostic Steps
- Read the error screen or latest.log for the dependency line.
- Note which mod needs Cloth Config and which version range it asks for.
- Download the matching Cloth Config file for your loader and Minecraft version.
- Remove old or duplicate Cloth Config jars.
- Restart and check the log again.
FAQ
What is Cloth Config?
A library other mods use for their configuration screens. Its Modrinth page describes it as a configuration library for Minecraft mods, with files for Fabric, Forge and NeoForge.
What is Cloth Config's mod id?
cloth-config on Fabric and cloth_config on Forge and NeoForge. Loader messages use the id, so search your log for both spellings.
Does a server need Cloth Config?
Only when a mod installed on the server requires it. Modrinth lists Cloth Config as optional on both sides, so the mods that depend on it decide.
Related Errors
How to Fix Missing Mod Dependency
Mod X requires Y version Z or later
How to Fix Fabric API Missing
Mod requires fabric-api @ [*]
How to Fix Forge Version Mismatch
Mod requires Forge version X.X.X or above, currently running Y.Y.Y
How to Fix Duplicate Mod Error
Duplicate mod: X / Found duplicate mod at path
