A downloadable tool for Windows, macOS, and Linux

Download NowName your own price

PuzzleGraph is a tool for creating simple typical computer game puzzles and then analyzing and visualizing their state space.

Setup and connect puzzle elements like gates, toggles, pressure plates and boulders. See the state space of the puzzle visualized, including solution paths, dead ends and fail states.

Share your puzzles!

If you use PuzzleGraph - either purposefully or just messing around - please tell me about your experience. And I'd love to see puzzles you make with it, and potentially include them with the distribution if you want!

PuzzleGraph is open source and the source code is available here under the Mozilla Public License, v. 2.0.

New in version 1.1

All the node and edge types now have tooltips to make it more clear what exactly they do and there is a help screen with an overview of all the element types.

I also added three new puzzle elements; the one way edge, the blockable hazard edge, and the ball track edge.

PlatformsWindows, macOS, Linux
Made withUnity
Average sessionAbout a half-hour


Download NowName your own price

Click download now to get access to the following files:

PuzzleGraph_1.1_Linux.zip 13 MB
PuzzleGraph_1.1_Mac.zip 12 MB
PuzzleGraph_1.1_Win.zip 10 MB


Log in with itch.io to leave a comment.

Hey, this is extremely cool! Is there any chance of getting another upload of the source code? I'd love to play around with this a bit if possible. Thanks!

Right, thanks for the reminder. Since Bitbucket stopped Mercurial support, the source is now available here:


thank you!

Ah the mac build needs to updated to 64 bit as the last two versions of macos dont support 32bit apps

(2 edits)

Very funny and interesting tool.

One thing that you should consider is an option to turn off states calculations. If  you make more complicated puzzle, the game just starts to slow down and freezes eventually due to enormous number of calculations computer has to make to compute all different states the game might have.

And my own puzzle if someone wants to try.

Hi. Glad you like the tool!

Thanks for the suggestion, but I'm not actively developing the tool further (though it's open source if anyone want to give it a go themselves).

Since you're sharing your puzzle: You can choose Menu > Open Puzzle Folder and see the text files for your puzzles. If you post the text content somewhere, other people will be able to save it as text files and open it locally in their own PuzzleGraph application. :)

This is really excellent. It's a fantastic tool for learning puzzle design as a discipline. I notice that doors, if they start open, will close when triggered by a lever, but not a button or a plate. I wish they closed for any trigger, that would make possible a lot of interesting puzzle mechanics. Having one action that is both advantagous and disadvantagous to the player in different ways is a really important idea in puzzle design. I really hope you're able to take this idea further, I'm loving it.


Looks really interesting and useful but unfortunately only for really basic puzzles. Suffers from two things that I noticed

* Interchangeability of players and balls - maybe one player is too big to go through crawlspace or something like that, or only one type of balls lets you go through hazard

* Hardcoded rather than customizable puzzle elements, that feel quite arbitrary, especially path elements. I think, it would be better if you could select for each path (or have some library of presets), whether you can see/shoot (in each directions), what types of players can go, what types of balls can be carried/pushed etc. etc.

Also I haven't found a way to reverse direction of stuff like steps and walls

Great tool. I'm looking for ideas to make games and this has my mind racing!

I saw this a couple years ago, and was so glad to see source come out to muck around. Was reading through it and came across something funky though. Sure enough:
Just thought I'd drop that here in case you are after (visual) bug reports.
Regardless. Incredible project.

Good find! To be honest I haven't tested a lot with multiple player characters so am not too surprised. You say you discovered this by looking through the code. What specifically tipped you off?

Hey, awesome to see you read these comments! I've been enjoying spending a lot of time just reading/rewriting/mucking around with the code and seeing ways this project could be taken further. In this case, it seems to be due to the merging of states. As you know, states nodes are created, and then compared to existing states, to see if it's actually an already existing one. In the case of 2 players (other than when they can't reach each other), every state (other than when they are in the same node), involve an exact replica, in which the two players are switched. This visual bug is caused due to the state in which the players are where you'd expect, having been replaced with the state in which they are switched. The ideal solution in my mind is not so tightly linking specific 'movables' to each state, but instead merely linking the concept (or definition) of that movable to the state, and then evaluating which particular movable is most appropriate to animate to the new location.


I really like the way this gives immediate feedback to the designer. It might not be the best way to actually design a well-crafted puzzle, but you can just adjust the variables around bit by bit and instantly know if you've destroyed the intended path through the puzzle or opened up a bunch of unintended ones.

I've never been able to find the video of the talk since I watched it originally, but I remember Marc Ten Bosch (Meigakure dev) talking a bit about state spaces and how he tries to design puzzles that create large state spaces with a short goal path, the notion being that these puzzles are easy to solve, but only if you know the solution. This kind of visualization would be pretty useful if that's your design philosophy, especially if it was integrated right into your dev tools (assuming your game lends itself well to being analyzed as a state space - grid based movement and all that).


Nice game bro, thanks

The program doesn't work for my computer for some reason, it opens but its black and nothing happens

I'm sorry to hear that. Are you using Windows, Mac or Linux? What version?

I'm using Windows 10

Are you having the same issue with other applications or games made with Unity, or with any games in general - or only with PuzzleGraph?

(2 edits)

Only Puzzle Graph.
But I got a new pc and it works on this one?  Weird.

I am currently messing around with it and there is a problem with one way passages, they don't work. I can still come back.

Also Door that starts open doesn't seem to let me go through either.

Hi. I'm afraid I don't know where to start with regard to the issue you had first, but I'm happy to hear it works on your new PC!
About the puzzle related issues would it perhaps be possible for you to record videos of them so I can see the exact puzzle configuration that triggers it? Thanks!


Great work / superb value.

Rugged quality work for solid puzzle game construction in any dimension including virtual to physical. Great application potential for demands of emerging platforms.