I am just playing around here and have no plans to actual create a serious fork. If you are interested in this code, please look to the original.
- Water placed via the default editor now matches the colors used for water in DEMO.ZZT,
- Keys on the HUD that the player does not have are now drawn in black-on-dark-blue, making a key silhouette
- Board exits are listed beneath keys
The Reconstruction of ZZT is a reverse-engineered recreation of the source code to the last official release of ZZT, ZZT 3.2. The output executable is byte-for-byte identical with said release, which means that the source code accurately represents the original engine's behavior.
The intent behind this project is to faciliate improved preservation and accessibility of ZZT's worlds and community, as well as faciliate new, exciting developments.
There are many ways to run ZZT on a modern PC. While pretty much anything capable of running DOS will do the trick, the recommended ones are:
- Zeta, an emulator dedicated to running ZZT's original engine (Windows, Linux, macOS, HTML5),
- DOSBox, a general DOS software emulator.
The official ZZT worlds originally released with the game can be found here.
Beyond that, I highly recommend checking out the Museum of ZZT, particularly its Featured Games section, to find amazing worlds created by the ZZT community over the past three decades.
ZZT comes with a built-in editor and documentation - just press "E"!
However, please note that the community has since created more powerful editors, the most popular of which is KevEdit. This is currently the recommended solution. Dr. Dos has created a live stream series on YouTube detailing how to use Zeta and KevEdit to create your own ZZT worlds.
This release's binary distribution includes:
- ZZT.EXE - the ZZT engine executable,
- ZZT.DAT - the documentation originally included with ZZT,
- DEMO.ZZT - the official demonstration world, part of ZZT's bundled documentation,
- ZZT.CFG - the ZZT configuration file (set to open DEMO.ZZT by default).
The source code includes the source format for both ZZT.EXE and ZZT.DAT, as well as relevant tools.
Yes! There are many ZZT worlds, utilities, and other documents which have not yet been preserved. If you'd like to share them and see them be adequately catalogued and preserved, please contact me at (kontakt at asie dot pl) - or get in touch with the Museum of ZZT community.
- BIN - output directory for EXE and TPU files,
- DIST - output directory for the binary distribution,
- DOC - documentation files used for building ZZT.DAT:
- ABOUT.HLP - about text,
- GAME.HLP - help text (play),
- EDITOR.HLP - help text (editor):
- CREATURE.HLP, TERRAIN.HLP, ITEM.HLP, LANG.HLP, LANGREF.HLP, LANGTUT.HLP, INFO.HLP - additional help text,
- LICENSE.HLP - licensing terms for the source code release, formatted for in-game view,
- END1.MSG, END2.MSG, END3.MSG, END4.MSG - registration messages for the shareware version of ZZT; not present,
- MISC - miscellaneous files which are not part of the build process:
- relocfix.py - Python 3 script for fixing relocation table semgents in EXE binaries after LZEXE decompression,
- RES - resource files which are not otherwise recompiled:
- DEMO.ZZT - the official ZZT demonstration world,
- ZZT.CFG - the ZZT configuration file used for the binary distribution,
- SRC - the reconstructed ZZT source code,
- ZZT.PAS - main source file,
- TOOLS - tools used when building:
- DATPACK.PAS - DATPACK, a tool for creating and extracting the ZZT.DAT file (source code),
- LZEXE.EXE - LZEXE, a .EXE compression tool by Fabrice Bellard,
- BUILD.BAT - source code build script,
- LICENSE.TXT - licensing terms for the source code release.
The Reconstruction of ZZT is licensed under the terms of the MIT license as described in LICENSE.TXT, with the exception of certain files included with this release:
- TOOLS/LZEXE.DOC, TOOLS/LZEXE.EXE:
LZEXE.EXE v0.91 (c) 1989 Fabrice BELLARD
Ce programme fait parti du domaine public (FREEWARE), donc vous pouvez
l'utiliser, le copier et le distribuer sans problème. Et vous pouvez même
en faire un usage commercial, c'est à dire compacter des fichiers EXE que
vous allez vendre. Mais la vente de LZEXE.EXE est interdite.
- MISC/relocfix.py: Copyright (c) 2020 Adrian Siekierka, licensed under "zero-clause" BSD
- DOS-compatible environment (f.e. DOSBox),
- Turbo Pascal 5.5 (if you don't have it, it's officially available for free via Embarcadero's Antique Software website).
- Ensure that TPC.EXE from Turbo Pascal is available on your PATH (f.e.
SET PATH=C:\TP;%PATH%
). - From the source code directory, run
BUILD.BAT
. - The DIST directory will contain files comprising the release as outlined in the FAQ.
If the source code has not been modified, the resulting ZZT.EXE file should be byte-for-byte identical with the ZZT.EXE bundled with ZZT 3.2.
If you'd rather stick to an entirely free software stack for building ZZT, that is also possible, albeit not without modifications:
- Ideally, the latest SVN trunk version of Free Pascal should be used.
- Free Pascal must be compiled as a DOS/i8086 cross-compiler in the Large memory model (more information).
- The compilation flags "-Mtp" and "-WmLarge" must be used.
- The methods in VIDEO.PAS using inline(...) must be rewritten, as Free Pascal does not support this form of inline ASM code.
- SOUNDS.PAS must be patched, as Free Pascal does not support overlapping CASE statements.
- As LZEXE is not free software (source unavailable), you may want to consider removing it from your build process or replacing it with another compressor, such as UPX (with the --8086 flag).
Please note that, as Free Pascal's RTL is significantly larger, the resulting binary is likewise about 40KB larger - leaving less memory space for game worlds.
These are variables which are not used at all anywhere in the source code, but are assumed to exist in the stack or data segments, affecting relevant variable offsets and stack checks. They are required for byte-level equivalence, but you are free to remove them and get a functionally equivalent version of the engine - with the exception of some structures, like TStat, which are serialized to disk.
- Fix 5 annoying bugs in ZZT.
- Give a copy of each bugfix to a friend, neighbor or business associate.
- You now have five better friends.
I'd like to thank everyone who has spent the last few years contributing to the rebirth of the small ZZT community. It is thanks to your passion and dedication that this project has been made possible.