User Tools

Site Tools



DreamZZT is a clone of ZZT and Super ZZT developed by c99koder in the early-mid 00s. While its compatibility is lacking, it is particularly notable for having been ported to the Nintendo DS and Dreamcast. It was developed until November 2007, and its source code is available under the terms of the GPLv2 license.

Extensions (DreamZZT 2.x)


The engine will play music by checking for the existence of an MP3 file in the following format: [worldname]/[first word of boardname].mp3.


Note that the list is incomplete.


* #char 0 changes the character, instead of being a no-op.

^board [id]

Transports the player to the board with the specific numeric ID.

^color [color]

Sets the object's color to the specified value.

^drawtext [x] [y]

Draws the next line of text at the specified coordinates.



^loadjpeg [filename]

Draw the specified filename (with extension).

^playercolor [color]

Sets the player's color to the specified value.

^rename_ammo [name]


^teleport [x] [y]

Moves the calling object to the specified coordinates.

^textcolor [number1] [number2]


Extensions (DreamZZT 3.x)

World format

DreamZZT appends the following information after the end of the TBoardInfo structure in both ZZT and Super ZZT:

Offset Type Description
0x00 boolean If true, animated water is enabled.


Animated water

If enabled in a world, each water tile will use a foreground color of 0x01 and a character of 0xB0. With a random 12.5% chance per tick, each tile may also start the following animation sequence:

  • foreground color 0x09 (light blue), character 0xB0,
  • foreground color 0x09 (light blue), character 0xB1,
  • foreground color 0x09 (light blue), character 0xB2,
  • foreground color 0x09 (light blue), character 0xDB, then repeat the above steps backwards, finally revert to the static look.


DreamZZT adds the following OOP extensions:

  • #__dark 1 turns the board dark, while #__dark 0 removes darkness,
  • aligned can be used as a synonym for alligned.

There are also some documented, but unimplemented (in the final source code revision) extensions:

  • The flags pc and dreamcast are mentioned in the documentation, presumably for detecting the platform DreamZZT is installed on.

TODO: Can the Stones of Power feature be used in DreamZZT in ZZT mode?


DreamZZT adds a significant amount of additional cheats.

Cheat code Effect
+dark Makes board dark.
-dark Removes board darkness.
+/-ammo Adds/removes 10 ammo to/from the player.
+/-gems Adds/removes 10 gems to/from the player.
+/-score Adds/removes 10 score to/from the player.
+/-health Adds/removes 10 health to/from the player.
+/-torch Adds/removes 10 torch to/from the player.
zap Removes player-neighboring tiles.
keys Gives all keys to the player.
warp X Warps to board with ID X and pauses the player.
warp As above, but with a board select menu.
freeze/unfreeze Freezes/unfreezes board ticking.
watch Enables debug information to be printed on a selected object.
inspect Shows a selected object's code.
flags Prints the state of the world flag list in the debug console.
edit Opens the editor.
quit TODO
play cdefgab Plays the #play string cdefgab.
+/-reveal Reveals objects, by making them show changing high-intensity colors.
viewport X Y TODO
Other commands Executes the command as ZZT-OOP code on behalf of the player.
release/dreamzzt.txt · Last modified: 2021/10/30 10:35 by asie