What Fzzy Config works with.
| Platform | Java Edition |
|---|---|
| Loaders | Fabric, Forge, NeoForge, Quilt |
| Minecraft versions | 1.20.1, 1.20.6, 1.21.1, 1.21.5, 1.21.8, 1.21.11, 26.1, 26.2 |
| Environment | Client, Server |
Fzzy Config is a configuration engine for Minecraft Java mods, which means it is code other mods are built on rather than a feature you install for yourself. What a player gets from it is a proper settings screen instead of a text file to edit by hand, opened from the mod list in Mod Menu or with a chat command, and the same screen behaviour across every mod that uses it. It runs on Fabric, NeoForge, Quilt, and Forge, and it is declared on both the client and the server because it syncs settings between them.
What the Fzzy Config mod actually does
A mod author writes their settings once and Fzzy Config generates the screen from the layout of the config file. There is no separate screen code, so the mod ships smaller and the settings look and behave the same as every other Fzzy Config screen you have seen. Widgets are matched to the value type, which stops each mod inventing its own slider for the same kind of number.
Edits are tracked before they take effect. You can review a set of changes, revert them, or read a change history rather than guessing what you altered three screens ago. Settings that need a restart say so, and the /configure command opens any registered config screen directly if you would rather not go through a mod list.
- Config screens generated from the mod's own settings file, with no screen-building code on the mod's side.
- Search across settings, breadcrumb navigation between nested screens, and right-click context menus.
- Keyboard navigation and narration by default, which most config libraries leave to the individual mod.
- Change tracking with apply, revert, and a readable change history.
- Server-client sync, including pushing a live settings change from a client out to a server.
- Screens reachable from Mod Menu, Catalogue, or the /configure command.
- Automatic validation and correction of values, so a bad number is caught before it reaches the game.
Fzzy Config on Fabric, NeoForge, Quilt, and Forge
Three of the four loaders are in step. Fabric, Quilt, and NeoForge all sit at build 0.7.6+26.2 and target Minecraft 26.2, published in June 2026. Forge is the outlier, and it is the one real limit worth knowing before you plan a pack around this library.
- Fabric, build 0.7.6+26.2, targeting Minecraft 26.2.
- Quilt, build 0.7.6+26.2, targeting Minecraft 26.2.
- NeoForge, build 0.7.6+26.2+neoforge, targeting Minecraft 26.2.
- Forge, build 0.7.6+1.20.1+forge, targeting Minecraft 1.20.1 and nothing newer.
- Earlier builds cover the 1.20 and 1.21 lines, back to 1.20.1.
So a Forge setup above 1.20.1 has no Fzzy Config build to install, and any mod that requires the library will refuse to load there. On Fabric, Quilt, and NeoForge the project has kept pace with the current drop.
Installation and dependencies
You install this the way you install any other library mod, alongside the mod that asked for it, in the same mods folder. The one step people miss is the Kotlin runtime library, which differs per loader and is a required dependency on every build.
- 1.Match the Fzzy Config build to your loader and your exact Minecraft version.
- 2.Download the jar from the Modrinth project page linked on this page.
- 3.Put it in your mods folder next to the mod that requires it.
- 4.Add the Kotlin library your loader needs, listed below, or the game will not start.
- 5.Launch once and open the settings from your mod list or with the /configure command.
- Fabric and Quilt builds require Fabric API and Fabric Language Kotlin.
- The NeoForge build requires KotlinLangForge.
- The Forge build requires Kotlin for Forge.
- Install the same set on a server when the mod requiring Fzzy Config runs server-side.
How it compares to other config libraries
Cloth Config API solves the same problem and is far more widely adopted, so most mods you install will pull that one instead. YetAnotherConfigLib is the other common answer, and it is the one behind several well-known Fabric mods. Fzzy Config pushes further on validation, change tracking, and server-client sync, which is why the mods that pick it tend to be the ones with settings a server operator actually cares about. As a player you do not choose between the three, you end up with whichever ones your mods ask for, and having all of them installed at once is normal.
Questions about Fzzy Config.
5 questions
Do I need Fzzy Config on the server as well as the client?
Yes, when you are playing on a server that runs the mod requiring it. The project declares itself required on both sides because it syncs settings between server and client, and lets a server push a live settings change out to connected players. On a single-player world the client copy is the only one that exists. The simple rule is to install it wherever you installed the mod that asked for it.
Why does a mod I installed require Fzzy Config?
Because that mod's author used it to build their settings. Fzzy Config handles the config file, the in-game screen, and the validation, so the mod ships without that code and lists the library as a dependency instead. It is the same arrangement as Fabric API or Cloth Config API. Nothing is broken in your install, the game simply refuses to load the mod until the library it needs is present.
Does the Fzzy Config mod work on Forge?
Yes, but only on Minecraft 1.20.1. The Forge build is 0.7.6+1.20.1+forge and has not moved past that version, while Fabric, Quilt, and NeoForge are all on 0.7.6+26.2 for Minecraft 26.2. If you run Forge on anything newer than 1.20.1 there is no matching build, and a mod that depends on Fzzy Config will not load on that setup.
Which Minecraft version does Fzzy Config support?
The project spans 1.20.1 through the 1.21 line and on into the 26.x drops, with the current release at 26.2 on Fabric, Quilt, and NeoForge. Each build targets a narrow version range, so match the file to your exact game version rather than assuming a newer jar will run on an older game. Forge is capped at 1.20.1.
Where can I download Fzzy Config?
From the Modrinth project page by fzzyhmstrs, which is the source linked on this page. The mod is published under the Timefall Development License Modified, which allows use but not redistribution, so we link to the project instead of hosting the file. Pick the version matching your loader and your Minecraft version.
