CurseForge · Minecraft mod
Puzzles
Data-driven puzzle blocks with in-game GUIs. Create custom puzzles via JSON datapacks—no coding required. Supports automation, multiple languages, and includes two built-in puzzles.
Quick answer
Which Puzzles release should I use?
puzzles-1.0.0.jar targets 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is Puzzles required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does puzzles-1.0.0.jar need?
puzzles-1.0.0.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Puzzles without breaking your instance.
Built for puzzles-1.0.0.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use puzzles-1.0.0.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside puzzles-1.0.0.jar. It opens that exact file at the source.
About this project
What does Puzzles add?
Puzzles
Data-driven puzzle blocks for Minecraft 1.21.1 (NeoForge).
Features
- Puzzle Block — locks onto a puzzle, outputs items, checks answers, gives rewards
- Puzzle Desk — creates Puzzle Paper from regular paper + a selected puzzle
- Datapack-driven — add/modify puzzles by editing JSON files, no recompilation
- In-game GUI — open the puzzle folder directly and refresh without
/reload - Two modes — one-shot (single play) or locked (auto-repeat)
- Automation-friendly — compatible with hoppers and pipes via NeoForge ItemHandler
How to Play
- Craft a Puzzle Block and a Puzzle Desk
- Put paper into the Puzzle Desk, pick a puzzle, click Load
- Insert the Puzzle Paper into the Puzzle Block
- Follow the output/input cycle to solve the puzzle
Adding Custom Puzzles
Puzzles are defined as JSON files. Place them in:
<world>/datapacks/puzzles/data/puzzles/puzzle_type/
Click the "Puzzle" button in the Puzzle Desk GUI to open the folder directly. Then run /reload in-game to load new puzzles.
Included Puzzles
- Stone Trial — smelt stones into their smooth variants
- Compression Trial — compress 9 ores into a block
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.252 or newer
License
MIT
Project description from CurseForge.
Pick your setup
Puzzles by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Puzzles versions and loaders
puzzles-1.0.0.jar
2 Oct 2026
Looking for an older file? The official CurseForge project page is in Resources.