What Puzzles Lib works with.
| Platform | Java Edition |
|---|---|
| Loaders | Fabric, Forge, NeoForge |
| Minecraft versions | 1.18.2, 1.19.2, 1.20.1, 1.20.4, 1.21.1, 1.21.11, 26.1, 26.2 |
| Environment | Client, Server |
Puzzles Lib is a shared code library from Fuzs, not a mod players seek out for its own features. Other Fabric, Forge, and NeoForge mods list it as a required or optional dependency for shared GUI, config, and networking code, so it only shows up in a modpack because something else needs it. Match the loader and Minecraft version to whichever mod requested it, and Puzzles Lib runs the same on the client and on a dedicated server.
What Puzzles Lib actually does
Puzzles Lib bundles code that Fuzs' other mods, and a number of unrelated add-ons, would otherwise have to duplicate: shared menu and GUI screens, a common config system, and networking plumbing between client and server. Installing it on its own adds nothing to a world. Its only job is to sit in the mods folder and let the mod that actually needs it load.
Installing Puzzles Lib
Download the build that matches your loader and Minecraft version from the Modrinth project page, then drop the jar into your mods folder next to the mod that lists Puzzles Lib as a requirement. Puzzles Lib itself declares two required dependencies on Modrinth: Fabric API and Forge Config API Port. Install whichever one matches your loader alongside it, on top of the mod that first asked for Puzzles Lib in the first place.
Fabric, Forge, and NeoForge version support
Puzzles Lib stays current on Fabric and NeoForge, both reaching release build 26.2.3 for Minecraft 26.2 as of August 2026. Forge is a different story: the last Forge release targets Minecraft 1.20.4, and every branch from 1.21.1 onward drops Forge from the project entirely.
How to download and install Puzzles Lib
Questions about Puzzles Lib.
5 questions
What does Puzzles Lib do?
Puzzles Lib is a shared code library from Fuzs. It bundles common GUI, config, and networking code that other Fabric, Forge, and NeoForge mods reuse instead of writing it themselves. Installed alone, it does not add anything to a world; it only lets whichever mod requires it load correctly.
Do I need to install Puzzles Lib myself?
Only if a mod you installed lists it as a required dependency. Modrinth and CurseForge both flag missing dependencies before a download, and most modpacks bundle Puzzles Lib automatically. Match the file to the same Minecraft version and loader, Fabric, Forge, or NeoForge, as the mod that needs it.
Why does my game crash with Puzzles Lib installed?
Reports of crashes with Puzzles Lib enabled, including a widely discussed Minecraft 1.20.1 case, almost always trace back to a version mismatch between Puzzles Lib and the mod built against it, not damage caused by Puzzles Lib itself. Update every mod that depends on it to versions built for the same release, then re-enable them one at a time to isolate the real conflict.
Does Puzzles Lib work with Forge?
Yes, but only up to Minecraft 1.20.4. Fuzs continues Puzzles Lib on Fabric and NeoForge through the current 26.x releases, while Forge support stopped at 1.20.4 and was dropped from every later branch. A Forge mod that needs Puzzles Lib on 1.21 or newer will not find a compatible build.
Is Puzzles Lib safe to install?
Puzzles Lib is distributed through Modrinth under the Mozilla Public License 2.0, maintained by Fuzs with over 60 million downloads. It is source code, not an executable installer, and adds no bundled extras beyond the shared library code other mods call into.
