AI logic puzzle maker: the rule is small, the consequences are not
A logic puzzle game is one rule and a hundred consequences. The rule takes an afternoon to implement and the consequences take the rest of the project, which is why implementation should not be your bottleneck. Free AI to start: Flockbay's AI and your own Claude, ChatGPT, agent or API key are free for your first build; after that, a plan keeps you building. It runs on Windows, macOS and Linux, on the official Godot engine.
The main page on this subject is What is an AI game maker that writes a real Godot project?.
AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.
Intel or AMD Chromebook, with Linux turned on.
The shape of the genre
The great logic puzzle games have a mechanic you could explain in one sentence. Boxes can be pushed but not pulled. Time rewinds and you meet yourself. Colour determines what you can stand on. That is the entire rule set.
What follows is the design, and the design is finding the situations where that rule does something surprising. That is a search problem carried out by a person, and it is slow, and it does not compress.
Which means the implementation should be nearly free, and traditionally it is not. Grid movement with correct edge cases, undo that actually restores everything, state that rewinds cleanly — these are fiddly and they consume the exact energy you needed for puzzle design.
Get the rule running the same evening
You describe the mechanic to Flockbay and it writes the GDScript into your Godot project. "The player moves on a grid, can push one block at a time but never pull, and pushing into another block does nothing."
Then the parts you would have forgotten: undo that steps back through every change, a reset key, a move counter, a solved state. Say you want them and they exist.
Undo in particular is worth calling out. In a puzzle game it is not a convenience, it is the primary verb — players undo far more than they move — and a subtly wrong undo makes a good puzzle feel broken.
More on this: Make a puzzle game with AI: the rule is small, the levels are the work
Designing the puzzles is the actual project
Levels go down the same way Flockbay builds everything: describe the situation and it lays it out, or place it yourself in Godot's TileMap panel and 2D view, which for a puzzle, where one tile is the whole difference, is often the faster way. In a flat project that is a grid in the most literal sense: ground is a TileMapLayer painted by cells, and its TileSet's terrains give the edges and the collision, so the room is exactly the shape painted. The blocks, switches and doors on top are sprites at an exact position, rotation and scale.
Nothing generates a good puzzle, because a good puzzle is a piece of misdirection aimed at a person, and the aiming is the craft. Flockbay can build any layout you describe; which layout misleads a player in the right way is yours to find.
The reliable method is boring and works: build a situation, solve it yourself, then find out whether it teaches. Every puzzle should introduce one idea, and the puzzle after it should assume you learned it. When you find yourself explaining a level in words, the level is not doing its job.
Order matters as much as content. The same twenty puzzles in a different sequence are a different game, and often the difference between people finishing and people quitting at level six.
More on this: AI top down game maker: the camera that shows everything
Testing on other people, early
You cannot judge the difficulty of a puzzle you designed. You know the answer, permanently, and there is no way back to not knowing it.
So the only instrument is someone else playing while you say nothing, which is uncomfortable and necessary. Watch where they stall. Half of what you thought was elegant is invisible.
The game runs locally on the bundled Godot, so handing it to someone on a laptop needs no connection and no setup.
Practical facts
Flockbay is a desktop app for Windows, macOS and Linux with Godot inside it. It settles 2D or 3D with you before the project exists, and for this genre both are real answers. The grid version is the flat world's natural shape and gets the flat world's own tools. The spatial version, where the rule plays out in three dimensions, is less crowded ground and is one choice away rather than the thing the app is built around.
Building needs an internet connection. Free AI to start: Flockbay's AI and your own Claude, ChatGPT, agent or API key are free for your first build; after that, a plan keeps you building.
More on this: AI idle game maker: the genre that is almost entirely code
Presentation does more than you expect
Two puzzle games with identical mechanics can feel completely different depending on what the pieces are. Blocks and grids read as an exercise. A room, a light and a door read as a place.
Since Flockbay builds the world as well as the rule, dressing a puzzle as somewhere real is cheap in either kind of project. In a flat one that is the floor of a room with a lamp and a door stood in it, from a Catalogue where 55,073 of the 60,648 objects are sprites, searchable by name with a picture of each. In a 3D one there are props, light, and terrain or water from a Godot plugin to do it with. Either way it changes how long people are willing to sit with a hard puzzle.
It also affects how a rule is understood. A mechanic explained by what the objects obviously are needs no tutorial text, and tutorial text in a puzzle game is nearly always a sign the level failed.
More on this: Story to game: what survives the translation and what does not
A starting project for this is the puzzle game templates.
Questions
- Will it design puzzles for me?
- No. It implements the rule and the surrounding systems, and builds any level you describe. Designing a puzzle is aiming misdirection at a person and that stays with you.
- Can I get proper undo?
- Yes, and ask for it early. Undo is the most-used action in a puzzle game and a subtly wrong one makes good puzzles feel broken.
- Does it have to be 3D?
- No, and 2D is not the fallback. It is settled when you create the project. A grid puzzle in a flat world is a TileMapLayer with sprites for the pieces; a spatial puzzle in 3D is less crowded ground. Same app, the same chat, either way.
- Can I change the core rule later?
- Yes, by describing the change. Doing that cheaply is useful, because the first version of a mechanic is rarely the interesting one.
- What does it cost?
- Nothing. Free to download. Free AI to start: Flockbay's AI and your own Claude, ChatGPT, agent or API key are free for your first build; after that, a plan keeps you building.
Free for Windows, macOS and Linux. Rule running tonight, puzzles after.
Download Flockbay free