Simon Tatham's Portable Puzzle Collection

Introduction

This page contains a collection of small computer programs which implement one-player puzzle games. All of them run natively on Unix (GTK), on Windows, and on Mac OS X. They can also be played on the web, as Java or Javascript applets.

I wrote this collection because I thought there should be more small desktop toys available: little games you can pop up in a window and play for two or three minutes while you take a break from whatever else you were doing. And I was also annoyed that every time I found a good game on (say) Unix, it wasn't available the next time I was sitting at a Windows machine, or vice versa; so I arranged that everything in my personal puzzle collection will happily run on both those platforms and more. When I find (or perhaps invent) further puzzle games that I like, they'll be added to this collection and will immediately be available on both platforms. And if anyone feels like writing any other front ends for platforms I don't support (which people already have) then all the games in this framework will immediately become available on another platform as well.

The games

The actual games in this collection were mostly not my invention; they are re-implementations of existing game concepts within my portable puzzle framework. I do not claim credit, in general, for inventing the rules of any of these puzzles. (I don't even claim authorship of all the code; some of the puzzles below have been submitted by other authors.)

Below each image are two links to versions of the puzzle you can play on the web. The 'java' link goes to a Java applet, which you can play in your browser if you have a working Java plugin. There's also a link marked 'js', which links to an alternative web version written in Javascript using asm.js; those versions are new as of March 2013 and have been somewhat tested in Firefox 19, Chrome 26, Internet Explorer 10 and Safari 6.

Also below each image is a link to the Windows binary for the game, and a link to the manual. For all other platforms, the games are provided in a single bundle, so scroll down to the Download section to get them all.

Black Box
[ java | js | manual ]
[ blackbox.exe ]
Find the hidden balls in the box by bouncing laser beams off them.
Bridges
[ java | js | manual ]
[ bridges.exe ]
Connect all the islands with a network of bridges.
Cube
[ java | js | manual ]
[ cube.exe ]
Pick up all the blue squares by rolling the cube over them.
Dominosa
[ java | js | manual ]
[ dominosa.exe ]
Tile the rectangle with a full set of dominoes.
Fifteen
[ java | js | manual ]
[ fifteen.exe ]
Slide the tiles around to arrange them into order.
Filling
[ java | js | manual ]
[ filling.exe ]
Mark every square with the area of its containing region.
Flip
[ java | js | manual ]
[ flip.exe ]
Flip groups of squares to light them all up at once.
Galaxies
[ java | js | manual ]
[ galaxies.exe ]
Divide the grid into rotationally symmetric regions each centred on a dot.
Guess
[ java | js | manual ]
[ guess.exe ]
Guess the hidden combination of colours.
Inertia
[ java | js | manual ]
[ inertia.exe ]
Collect all the gems without running into any of the mines.
Keen
[ java | js | manual ]
[ keen.exe ]
Complete the latin square in accordance with the arithmetic clues.
Light Up
[ java | js | manual ]
[ lightup.exe ]
Place bulbs to light up all the squares.
Loopy
[ java | js | manual ]
[ loopy.exe ]
Draw a single closed loop, given clues about number of adjacent edges.
Magnets
[ java | js | manual ]
[ magnets.exe ]
Place magnets to satisfy the clues and avoid like poles touching.
Map
[ java | js | manual ]
[ map.exe ]
Colour the map so that adjacent regions are never the same colour.
Mines
[ java | js | manual ]
[ mines.exe ]
Find all the mines without treading on any of them.
Net
[ java | js | manual ]
[ netgame.exe ]
Rotate each tile to reassemble the network.
Netslide
[ java | js | manual ]
[ netslide.exe ]
Slide a row at a time to reassemble the network.
Pattern
[ java | js | manual ]
[ pattern.exe ]
Fill in the pattern in the grid, given only the lengths of runs of black squares.
Pearl
[ java | js | manual ]
[ pearl.exe ]
Draw a single closed loop, given clues about corner and straight squares.
Pegs
[ java | js | manual ]
[ pegs.exe ]
Jump pegs over each other to remove all but one.
Range
[ java | js | manual ]
[ range.exe ]
Place black squares to limit the visible distance from each numbered cell.
Rectangles
[ java | js | manual ]
[ rect.exe ]
Divide the grid into rectangles with areas equal to the numbers.
Same Game
[ java | js | manual ]
[ samegame.exe ]
Clear the grid by removing touching groups of the same colour squares.
Signpost
[ java | js | manual ]
[ signpost.exe ]
Connect the squares into a path following the arrows.
Singles
[ java | js | manual ]
[ singles.exe ]
Black out the right set of duplicate numbers.
Sixteen
[ java | js | manual ]
[ sixteen.exe ]
Slide a row at a time to arrange the tiles into order.
Slant
[ java | js | manual ]
[ slant.exe ]
Draw a maze of slanting lines that matches the clues.
Solo
[ java | js | manual ]
[ solo.exe ]
Fill in the grid so that each row, column and square block contains one of every digit.
Tents
[ java | js | manual ]
[ tents.exe ]
Place a tent next to each tree.
Towers
[ java | js | manual ]
[ towers.exe ]
Complete the latin square of towers in accordance with the clues.
Twiddle
[ java | js | manual ]
[ twiddle.exe ]
Rotate the tiles around themselves to arrange them into order.
Undead
[ java | js | manual ]
[ undead.exe ]
Place ghosts, vampires and zombies so that the right numbers of them can be seen in mirrors.
Unequal
[ java | js | manual ]
[ unequal.exe ]
Complete the latin square in accordance with the > signs.
Unruly
[ java | js | manual ]
[ unruly.exe ]
Fill in the black and white grid to avoid runs of three.
Untangle
[ java | js | manual ]
[ untangle.exe ]
Reposition the points so that the lines do not cross.

Licence

This game collection is copyright 2004-2012 Simon Tatham (portions copyright Richard Boulton, James Harvey, Mike Pinna, Jonas Kölker, Dariusz Olszewski, Michael Schierl, Lambros Lambrou, Bernd Schmidt, Steffen Bauer, Lennard Sprong and Rogier Goossens). It is all distributed under the MIT licence. This means that you can do pretty much anything you like with the game binaries or the code, except pretending you wrote them yourself, or suing me if anything goes wrong.

Download

Here are Windows executables of the puzzle games in the collection. (On Windows only, the Net executable is called "netgame.exe" in order to avoid clashing with Windows's own "net.exe". The name of the game is still "Net" :-)

blackbox.exe | bridges.exe | cube.exe | dominosa.exe | fifteen.exe
filling.exe | flip.exe | galaxies.exe | guess.exe | inertia.exe
keen.exe | lightup.exe | loopy.exe | magnets.exe | map.exe | mines.exe
netgame.exe | netslide.exe | pattern.exe | pearl.exe | pegs.exe
range.exe | rect.exe | samegame.exe | signpost.exe | singles.exe
sixteen.exe | slant.exe | solo.exe | tents.exe | towers.exe
twiddle.exe | undead.exe | unequal.exe | unruly.exe | untangle.exe

Here are some Windows help files. If you install these in the same directory as the executable files, then each game should display a "Help" menu giving help about the game collection in general and that game in particular. You can also browse the same documentation online in HTML format.

(The help file is available in a choice of two formats. The .CHM file is HTML Help, supported by Win98 and above; the .HLP and .CNT files are old-style WinHelp, supported by everything from Win95 up to WinXP but not by Vista. The HTML help file is the recommended one, and the puzzles will use it by preference if both are available.)

HTML Help: puzzles.chm
WinHelp: puzzles.hlp | puzzles.cnt

Here is a .zip file containing all of the above Windows binaries and the help file.

puzzles.zip

Here is a Windows installer.

puzzles-version-installer.exe

Here is a Mac OS X disk image file, containing a single monolithic application called "Puzzles". You should be able to download and open the disk image, then drag the Puzzles application to wherever you feel like keeping it; it should be entirely self-contained.

Puzzles.dmg

Here is a source archive of the collection, which should allow you to compile the games on any Unix system supporting GTK. (At least, I hope so; I've only tested it on Linux so far, and I wouldn't rule out portability issues on other types of Unix.)

puzzles-version.tar.gz

Some people have ported this puzzle collection to various mobile devices. Here are some links to their port pages:

(Note that these are third-party ports, not maintained by me. If you have trouble with one of these, you should probably follow the link to the appropriate maintainer's page and contact them about the problem in the first instance.)

Development

All of these puzzles are written in C, with a porting interface so that the same back-end puzzle code can talk to wildly different graphical front ends. The source archive above includes native GUI front ends for Windows and Mac OS X, an X front end using the GTK+ library, and a mixed C/Java front end for compiling the puzzles into Java applets using NestedVM.

There is extensive developer documentation describing the cross-platform interfaces. If you want to write a new puzzle or a new front end (to make all these games run on another platform), this is probably the place to start.

If you want to see the latest state of development, you can check the development sources out from my Subversion repository.

The Subversion URL you need is svn://svn.tartarus.org/sgt/puzzles. So you could use a checkout command such as this:

svn co svn://svn.tartarus.org/sgt/puzzles

Alternatively, you can browse the Subversion repository on the WWW, here.

Feedback

Please report bugs to anakin@pobox.com.

You might find it helpful to read this article before reporting a bug.

Patches are welcome.


(comments to anakin@pobox.com)
(thanks to chiark for hosting this page)
(last modified on Sun Mar 30 16:20:19 2014)