Table of Contents
DreamZZT
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)
Music
The engine will play music by checking for the existence of an MP3 file in the following format: [worldname]/[first word of boardname].mp3.
Scripting
Note that the list is incomplete.
Bugs
* #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.
^hideplayer
TODO
^loadjpeg [filename]
Draw the specified filename (with extension).
^playercolor [color]
Sets the player's color to the specified value.
^rename_ammo [name]
TODO
^teleport [x] [y]
Moves the calling object to the specified coordinates.
^textcolor [number1] [number2]
TODO
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. |
Graphical
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.
Scripting
DreamZZT adds the following OOP extensions:
#__dark 1turns the board dark, while#__dark 0removes darkness,alignedcan be used as a synonym foralligned.
There are also some documented, but unimplemented (in the final source code revision) extensions:
- The flags
pcanddreamcastare 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?
Cheats
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. |