Puzzle

Puzzle

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

by
19.7M Downloads
fabricneoforgequiltlibraryutility
Rent Server with this Mod

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.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
Puzzle 2.3.0 - Neoforge 1.21.8release
MC 1.21.6, 1.21.7, 1.21.8neoforge
December 29, 2025
Puzzle 2.3.0 - Fabric 1.21.8release
MC 1.21.6, 1.21.7, 1.21.8fabric, quilt
December 29, 2025

How to Install Puzzle on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).

3

Install Mod

Open the mod browser in the dashboard and search for "Puzzle". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricneoforgequilt

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+26 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Puzzle server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.

Is Puzzle compatible with fabric and neoforge and quilt?

Puzzle officially supports fabric, neoforge, quilt for Minecraft 26.1.2, 26.1.1, 26.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Puzzle – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Puzzle consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Puzzle with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Unsupported

Supported Versions

26.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.61.21.5+19 more