Puzzle

Puzzle

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

15.7M downloads
Created Apr 9, 2026
by Motschen

About

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 <a href="https://modrinth.com/modpack/fabulously-optimized">Fabulously Optimized</a> or using <a href="https://lambdaurora.dev/optifine_alternatives">Lambda's fantastic list of alternative mods</a>
  • Puzzle was created to solve the latter by providing a <b>united config for OptiFine replacement mods</b> 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 <b>resourcepack-provided splash screens</b>
  • We also offer some new, innovative features to resourcepack developers, such as <b>unlocked rotation values</b> and <b>bigger size for JSON-models</b>. <br>The configuration screen can be found in the vanilla options screen, as well as ModMenu. ‎
<center> <p><span style="font-size: 8px;"><img src="https://cdn.modrinth.com/data/3IuO68q1/images/8ee2b5037fcfde764a61668bb67d0090b3f313eb.webp" alt="A customized splash screen featuring the puzzle logo in front of an image of a sunset" width="655" /></span></p> </center> Currently, there is included support for the following mods:</p>
  • <a href="https://modrinth.com/mod/cull-leaves">Cull Leaves</a>
  • <a href="https://modrinth.com/mod/iris">Iris</a>
  • <a href="https://modrinth.com/mod/continuity">Continuity</a>
  • <a href="https://modrinth.com/mod/lambdynamiclights">LambDynamicLights</a>
  • <a href="https://modrinth.com/mod/lambdabettergrass">LambdaBetterGrass</a>
  • <a href="https://modrinth.com/mod/cit-resewn">CITResewn</a>
  • <a href="https://modrinth.com/mod/entitytexturefeatures">Entity Texture Features</a>
  • <a href="https://modrinth.com/mod/entity-model-features">Entity Model Features</a>
<center> </div> Visit the <a href="https://www.midnightdust.eu/wiki/puzzle/">new wiki</a> to get started with using Puzzle for your own resourcepack! </center>

Versions

v2.3.0+1.21.5-neoforgeLatest
1.21.5neoforgeDec 29, 2025

# Puzzle v2.3.0 - Backported Minecraft 1.21.11's new multi-axis-rotation system for models to MC 1.20.1 - 1.21.10 ## Puzzle v2.2.1 - Add support for 1.21.11 (Mounts of Mayhem) - Fix crash when ModMenu is missing - Fix 1.21.4 support by providing an extra build - This is the first 1.21.4 build with working splashscreen logo blending! - Load splashscreen textures earlier on NeoForge - Update to MidnightLib 1.9.2 # Puzzle v2.2.0 - Setup a **multiversion** build environment - Puzzle will now always be up-to-date on all relevant versions of Minecraft (Fabric/Forge 1.20.1; Fabric/NeoForge 1.21.1, 1.21.5, 1.21.8, 1.21.10) - Migrate to Mojang mappings in preparation for upcoming non-obfuscated releases - Updated Entity Model/Texture Features compatibility

Download
v2.3.0+1.21.8-neoforge
1.21.6, 1.21.7, 1.21.8neoforgeDec 29, 2025

# Puzzle v2.3.0 - Backported Minecraft 1.21.11's new multi-axis-rotation system for models to MC 1.20.1 - 1.21.10 ## Puzzle v2.2.1 - Add support for 1.21.11 (Mounts of Mayhem) - Fix crash when ModMenu is missing - Fix 1.21.4 support by providing an extra build - This is the first 1.21.4 build with working splashscreen logo blending! - Load splashscreen textures earlier on NeoForge - Update to MidnightLib 1.9.2 # Puzzle v2.2.0 - Setup a **multiversion** build environment - Puzzle will now always be up-to-date on all relevant versions of Minecraft (Fabric/Forge 1.20.1; Fabric/NeoForge 1.21.1, 1.21.5, 1.21.8, 1.21.10) - Migrate to Mojang mappings in preparation for upcoming non-obfuscated releases - Updated Entity Model/Texture Features compatibility

Download
v2.3.0+1.21.8-fabric
1.21.6, 1.21.7, 1.21.8fabric, quiltDec 29, 2025

# Puzzle v2.3.0 - Backported Minecraft 1.21.11's new multi-axis-rotation system for models to MC 1.20.1 - 1.21.10 ## Puzzle v2.2.1 - Add support for 1.21.11 (Mounts of Mayhem) - Fix crash when ModMenu is missing - Fix 1.21.4 support by providing an extra build - This is the first 1.21.4 build with working splashscreen logo blending! - Load splashscreen textures earlier on NeoForge - Update to MidnightLib 1.9.2 # Puzzle v2.2.0 - Setup a **multiversion** build environment - Puzzle will now always be up-to-date on all relevant versions of Minecraft (Fabric/Forge 1.20.1; Fabric/NeoForge 1.21.1, 1.21.5, 1.21.8, 1.21.10) - Migrate to Mojang mappings in preparation for upcoming non-obfuscated releases - Updated Entity Model/Texture Features compatibility

Download

Download

Download v2.3.0+1.21.5-neoforge

Minecraft: 1.21.5

Loaders: neoforge

Tags

fabricneoforgequilt1.21.71.21.81.21.91.21.101.21.11