This repository contains fixed up code and demo projects/assets for the ACK-3D engine that was included in the book, "Amazing 3-D Games Adventure Set" by Lary Myers, published in 1995.

The CD included with that book contained multiple versions of the ACK-3D engine, two of which were for DOS (one for Watcom C++ 9.5 and the other Borland C++ 4.0/4.5) and another copy for Windows which was also the latest version of the ACK-3D engine at that time. The two DOS versions do not build out of the box without issues (crash bugs, etc). Additionally, the code for the DOS version of the map editor does not build as-is.

In this repository, I have taken the Windows version included on the book's CD and back-ported it to DOS using Watcom C++ 10.0a. I have also fixed build issues with the DOS map editor and cleaned up the makefiles and build scripts for all included tools and projects. Lary used his own custom MK.EXE tool which kind of did stuff similar to a makefile, but it was his own custom tool that was limited. I have not really left Windows compatibility as that was not a goal of mine. Having said that, I don't think it would be super difficult to add that back if someone desired it.

Some minor bugs and other improvements have been made, but nothing major. Many of the existing bugs that were present in ACK-3D remain (e.g. secret doors render strangely or not at all in many cases, and multi-height walls still can be seen through ceilings, etc.). I may try to fix some of these things in the future.

Finally, I have included a somewhat simpler example project that has been thoroughly commented. This project I hope serves to demonstrate what Lary covered in chapter's 11 and 14 of the book, but instead focused on DOS only and without going overboard with extra things like the FDEMO and MALL projects both did.

Also, I wrote two posts about this whole adventure here and here if anyone is interested.

The core ACK-3D library, based on the Windows version included on the book's CD.

Source for the BPIC utility discussed in the book in Appendix A, used for constructing resource files.

Source and data files for the DOS version of the map editor. Unlike the Windows version "ACKEDIT" (not included in this repository), this does not work with resource files directly and so is not quite as convenient to work with.

Source and assets for the "FDEMO" project discussed briefly in the book in Appendix C.

Source and assets for the "MALL" project also discussed briefly in the book in Appendix C. This project is very, very similar to the "FDEMO" project and really only differs by assets used.

An example project I created from scratch (but using assets from the Station Escape, FDEMO and MALL projects from the book's CD).