Table of Contents
TinyZoo is a collection of small ZZT source ports by asie, with the following traits:
- Custom, optimized binary bytecode format,
- Support for ZXT-based extensions via the conversion tool.
NOTE: The Analogue Pocket using the “gb” platform ID is correct.
Converting your ZZT world
NOTE: This is complicated because it's early. It will get easier. (I think.)
NOTE: If you want to utilize ZXT extensions, it is recommended - but not necessary, if you're using a different tool - to download the latest CI ClassicZoo/ZXT build, which includes necessary editing and testing facilities: GitHub Workflows (video guide - generally, pick the topmost entry; you also need to be signed in to GitHub, this is not ideal and will be resolved eventually).
- Download the latest CI zima build: GitHub Workflows (video guide - generally, pick the topmost entry; you also need to be signed in to GitHub, this is not ideal and will be resolved eventually)
- You need Java 17 for new zima builds. Download a copy here.
- Download the latest engine file for your platform - see above.
- Run the following command in the command line:
java -jar zima.jar binconv -o output_rom_path -e engine_file_path -p platform_id input_world_path, replacing the underscored identifiers with the necessary values:
output_rom_pathis the output file path for the ROM image.
engine_file_pathis the path for the platform-specific engine file - you can download it above, in the platform list.
platform_idis the platform ID - you can find it in the platform list.
input_world_pathis the path to the input world. You can specify multiple worlds, but this may not be supported by all platforms.
Make sure to study the licensing information before publicly releasing a converted world - or just contact me directly if you have any questions.
Publishing to HTML5
Currently, the best supported GB emulator for TinyZoo/GB is binjgb.
- Download binjgb from the pre-configured TinyZoo/GB copy.
- Copy your ROM to this directory, named
To upload to itch.io, pack all the files in the linked directory (including
game.gb) into a ZIP file, then publish it as an in-browser game on Itch.
Acquiring physical cartridges
- There is no reason to buy a cartridge larger than 4MB ROM - bigger sizes are not supported by TinyZoo/GB at this time.
- Note that you need a cartridge with 128K RAM and MBC5.
- For smaller games (or games utilizing “board groups”), 32K RAM might be sufficient - in this case, build your ROM with
–sram-size 32passed to binconv.
- Museum of ZZT Discord - TinyZoo discussion is welcome in the