ZZQuake2 1.0 - Quake II for classic Amigas with the MNT ZZ9000
================================================================

ZZQuake2 runs the Quake II engine on the ZZ9000 ARM Cortex-A9 Core1,
with an AmigaOS 68k launcher and graphical interface. Three rendering
engines are available, including FPGA hardware-accelerated OpenGL via
RasterIX in the XACP firmware.

RENDERING MODES
---------------

  Software (Core1 0.8.5):   320x240, 640x480, 800x600
  ARM TinyGL (Core1 0.6.1): 320x240, 640x480
  RasterIX (Core1 0.10.3): 320x240, 640x480, 800x600

The package includes the launcher, the GUI and all
EIGHT Core1 binaries used by the GUI. TinyGL renders in software
on Core1. RasterIX uses the ZZ9000 FPGA 3D accelerator.

REQUIREMENTS
------------

  - AmigaOS 3.x on a classic 68k Amiga.
  - MNT ZZ9000 graphics card and Picasso96.
  - XACP-compatible zz9000.card driver (required).
  - XACP firmware: software and TinyGL are compatible with XX19c;
    XX19d-RIX (or later) is required for RasterIX hardware 3D.
  - Legitimately obtained Quake II demo or full-game data.

INSTALLATION
------------

Extract ZZQuake2.lha to a drawer. Keep ZZQuake2_A0, ZZQuake2GUI and
all eight .bin engine files in the same ZZQuake2/ directory.
ZZQuake2_A0 is the historical launcher filename, not an alpha version.

For the demo, place your demo pak0.pak in:

  ZZQuake2/baseq2/pak0.pak

For the full game, the recommended location is:

  ZZQuake2/baseq2/full/pak0.pak

This lets the demo and the full game coexist. Select "Full pak" in
ZZQuake2GUI to use the full-game data. Both are supported.

Optional user-supplied MP3 music belongs in:

  ZZQuake2/baseq2/music/track02.mp3
  ZZQuake2/baseq2/music/track03.mp3
  ...

Use MP3 files encoded at no more than 128 kbps. Supported Amiga/XACP
audio paths include MP3 via XACP decoder, MP3 via MHI and CD audio. Game saves and loads work.
Quake II cinematics are not supported in this release.

No commercial PAK files, music tracks or other game assets are included.

SOURCES, LICENSES AND UPDATES
-----------------------------

The source code and build scripts for the eight distributed ARM Core1
engines are available under GPL v2 with the respective third-party
license notices on GitHub. The Amiga launcher and GUI are distributed
as freeware executables; their source code is not included.

GitHub source and documentation:
  https://github.com/Xanxi-Amiga/XACP-ZZ9000/tree/main/applications/games/ZZQuake2

Release page (including the GPL source ZIP):
  https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/ZZQuake2-1.0

XACP XX19d-RIX firmware:
  https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/XX19d-RIX

Gameplay video - ZZQuake2RIX in 640x480:
  https://youtu.be/KDob1KRbVMw

Original Quake II by id Software; portable quake2generic by ozkl.
TinyGL by Fabrice Bellard; RasterIX by ToNi3141; XACP port by Xanxi.
This project is not affiliated with id Software or MNT Research.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                    862    1636  52.7% -lh5- 79f9 Oct 19 19:33 ZZQuake2.info
[Amiga]                    860    1636  52.6% -lh5- 8e12 Oct 19 19:33 ZZQuake2/baseq2.info
[Amiga]                    862    1636  52.7% -lh5- c0a3 Oct 19 19:34 ZZQuake2/baseq2/full.info
[Amiga]                      0       0 100.0% -lh0- 0000 Oct 19 19:36 ZZQuake2/baseq2/full/put_full_game_pak0.pak_here
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         4 files    2584    4908  52.6%            Oct 21 07:03