Puzzle

Puzzle

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

by
24.0M Downloads
fabricneoforgequiltlibraryutility
Configure a Compatible Minecraft Server

Screenshots

Replace the Mojang logo with your own!
Customize the splash-screen colors
Customize the splashscreen with Puzzle!
Puzzle provides a uniform way to access common settings

About this Mod

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!

Available Versions

Puzzle 2.3.1 - Neoforge 26.2release
MC 26.2neoforge
June 17, 2026
Puzzle 2.3.1 - Fabric 26.2release
MC 26.2fabric, quilt
June 17, 2026
Puzzle 2.3.1 - Neoforge 26.1release
MC 26.1, 26.1.1, 26.1.2neoforge
March 25, 2026
Puzzle 2.3.1 - Fabric 26.1release
MC 26.1, 26.1.1, 26.1.2fabric, quilt
March 25, 2026
Puzzle 2.3.0 - Neoforge 1.21.5release
MC 1.21.5neoforge
December 29, 2025

How to Install Puzzle on Your Client

1

Install the Mod Loader Locally

Install fabric for your local Minecraft version.

2

Download the Matching File

Choose the Puzzle file for fabric and Minecraft 26.2.

3

Install Mod

Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.

Compatibility

Mod Loaders

fabricneoforgequilt

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+27 more)

Server-side

βœ— Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

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 Minecraft mods folder. Your server can remain unchanged unless the mod 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.2, 26.1.2, 26.1.1. 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. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.

Minecraft Server for Your Group

Puzzle stays on your client. Host a compatible world for your group.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
Client Compatibility Guide
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Unsupported

Supported Versions

26.226.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.6+20 more