Skip to content

Puzzle

Adds resourcepack features and a GUI to configure OptiFine alternatives more conveniently.

FabricNeoForgeQuilt
Loaders
FabricNeoForgeQuilt
Downloads on Modrinth
28M
Followers on Modrinth
1.2K
versions
84
Updated
September 29, 2026Sep 29
Published
in 2022
This is a library — other mods need it, and it adds nothing to the game by itself
Replace the Mojang logo with your own! · swipe

At a glance

A library: other mods need it
Runs on Fabric, NeoForge and Quilt
For Minecraft 1.18–1.20.4, 1.20.6–26.3
Client only — no need to install it on the server
Latest version — 2.3.1+26.3-neoforge from September 29, 2026
Requires MidnightLib
Where it's needed
In gamerequiredOn servernot needed

Install in the game only; not needed on the server

Game versions1.18–1.20.4, 1.20.6–26.3

Context: For a long time, OptiFine has been a big part of Minecraft modding.
For an equal amount of time, it has been causing errors with mods – its closed source nature making it especially hard to work with as a mod developer.
For that reason, a lot of alternatives have been created.
But usually they only replicate one specific feature of OptiFine, meaning the user has to install a lot of mods and configure them by searching for the specific mod in ModMenu.

  • The first problem is relatively easy to solve, by either downloading a modpack such as Fabulously Optimized or using Lambda's fantastic list of alternative mods
  • Puzzle was created to solve the latter by providing a united config for OptiFine replacement mods with built-in support for the most relevant alternatives and an API for other mods to take advantage of.
  • Due to many OptiFine features still having no replacement mod, Puzzle also adds certain OptiFine features on it's own, like resourcepack-provided splash screens
  • We also offer some new, innovative features to resourcepack developers, such as unlocked rotation values and bigger size for JSON-models.
    The configuration screen can be found in the vanilla options screen, as well as ModMenu. ‎

A customized splash screen featuring the puzzle logo in front of an image of a sunset

Currently, there is included support for the following mods:
Visit the new wiki to get started with using Puzzle for your own resourcepack!

FAQ

How to install Puzzle?

Install Fabric for your Minecraft version, download Puzzle for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Puzzle support?

Puzzle has builds for Minecraft 1.18–1.20.4, 1.20.6–26.3.

Is Puzzle needed on the server?

Client only — no need to install it on the server

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More