Version 3

For background information about the blocks project, see Goals, History, and/or Versions.

How to play:

1. Install Java if you don't already have it.
2. Download the file blocks-v3.zip.
3. Unzip it into a folder somewhere.
4. Get a command prompt and set the current directory to the "out" subfolder.
5. Type the command "java Maze" and get familiar with the controls for the maze game, since the blocks program uses the same navigation controls. (See maze game documentation.) Be sure to learn the slide controls, they're very useful for blocks. (You can find them in the Options screen on Keys tab # 3.)
6. When you're ready, use the menu command "Load Geom" and pick one of the scene files from the "data" folder. The file "basic-train" is a good place to start. See Controls for information about new controls that were not part of the original maze game (like train speed!) and Settings for information about how the game settings can be adjusted to work better in geometry mode.
7. Try out the other predefined scene files. In Examples there are some notes about what you can see in each of the scenes.
8. When you get tired of the predefined scene files, you can edit them and/or create ones of your own. See Scene Language for details about the scripting language.
9. If you get ambitious you can define your own block types using the same scripting language. See Kinds of Blocks if you're looking for ideas.

Notes and limitations:

1. The blue grid is a mat that the objects sit on. You can't go below the plane of the mat.
2. The clipping algorithm runs well for small numbers of blocks. However, it's not fully optimized, and the time required grows as the number of blocks squared. Proceed with caution!
3. Once in a while the game will get a key stuck or lock up completely. Sorry about that. I don't know why it does that, but I'll figure it out eventually. It looks like these problems have been around since the original maze game.