

Modrinth · Fabric, NeoForge, Quilt · Client mod
Puzzle
Puzzle is a client-side mod. Install it on your computer; the server does not need it.
Adds resourcepack features and a GUI to configure OptiFine alternatives more conveniently.
- Downloads
- 27.8M
- Author
- Motschen
- Loader
- Fabric, NeoForge, Quilt
- Minecraft
- 1.18 – 26.3
- Updated
- –
Screenshots
What Puzzle looks like
Replace the Mojang logo with your own!
Customize the splash-screen colors
Customize the splashscreen with Puzzle!Images: Puzzle on Modrinth, published by the project team.
Setup
Install Puzzle on your client
Client-side mods only run on your computer. More server RAM does not change their performance.
- 01
Install the loader locally
Install Fabric or NeoForge or Quilt for your Minecraft version in your launcher.
- 02
Download the file
Download the Puzzle file for your loader and your exact Minecraft version, for example 26.3.
- 03
Add it to the mods folder
Put the .jar file in your local .minecraft/mods folder and remove older duplicates.
- 04
Launch
Launch Minecraft with the loader profile. Nothing needs to change on the server.
- On the server
- Not needed
- On the client
- Required
- Loader
- Fabric, NeoForge, Quilt
- Minecraft
- 26.3, 26.2, 26.1.2 +28 more
- License
- MIT License
Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Puzzle · Modrinth- Puzzle 2.0.1 - Fabric 1.21September 24, 2024Minecraft 1.21, 1.21.1 · Fabric, Quilt
- Puzzle 1.6.3 - 1.21June 16, 2024Minecraft 1.21, 1.21.1 · Fabric, Quilt
- Puzzle 1.6.2 - 1.20.6May 4, 2024Minecraft 1.20.6 · Fabric, Quilt
- Puzzle 1.6.0 - 1.20.2September 24, 2023Minecraft 1.20.2 · Fabric, Quilt
- Puzzle 1.5.2 - 1.20July 12, 2023Minecraft 1.20, 1.20.1 · Fabric, Quilt
Original description by the project author
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. ‎

- Cull Leaves
- Iris
- Continuity
- LambDynamicLights
- LambdaBetterGrass
- CITResewn
- Entity Texture Features
- Entity Model Features
Does Puzzle need to be installed on the Minecraft server?
No. Modrinth marks Puzzle as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.
Which version and loader does Puzzle require?
Use a file for Fabric, NeoForge, Quilt and your exact Minecraft version. Supported versions include 26.3, 26.2, 26.1.2. Files for different loaders are not interchangeable.
Puzzle is not working – what should I check?
First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.
Similar mods
Popular mods in the same category
Fabric API
by modmuss50
Lightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Server-ready
Cloth Config API
by shedaniel
Configuration Library for Minecraft Mods
Server-ready
YetAnotherConfigLib (YACL)
by isxander
A builder-based configuration library for Minecraft!
Server-ready
Fabric Language Kotlin
by modmuss50
This is a mod that enables usage of the Kotlin programming language for Fabric mods.
Looking for mods for your own server?
The catalog lists mods that run on Minecraft servers.