ZZQuake 1.0
============

ZZQuake runs the original Quake engine and software renderer on the second
ARM Cortex-A9 core of the MNT ZZ9000 through XACP. AmigaOS handles the
launcher, Picasso96 display, input, file access and audio integration.

This first public release targets 320x240 in 32-bit RTG mode.

IMPORTANT - FIRMWARE REQUIREMENT
--------------------------------

COMPATIBILITY
-------------

ZZQuake 1.0 requires the XACP firmware branch and was validated with
XX19b / XACP v1.7.

It is not compatible with the official MNT firmware 1.13 or with
BlitterStudio firmware builds.

Use the XX19b / XACP v1.7 firmware provided with the XACP-ZZ9000 project 
or any later XACP firmware revision.

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

Copy the complete ZZQuake directory to your hard disk.

Place your own Quake data files in:

    ZZQuake/id1/

Shareware Quake:

    id1/pak0.pak

Registered Quake:

    id1/pak0.pak
    id1/pak1.pak

Quake game data is not included.

OFFICIAL MISSION PACKS
----------------------

Quake Mission Pack No. 1: Scourge of Armagon
(Hipnotic Interactive)

Place its data in:

    hipnotic/pak0.pak

Launch with:

    ZZQuake HIPNOTIC

or enable the HIPNOTIC Workbench ToolType.


Quake Mission Pack No. 2: Dissolution of Eternity
(Rogue Entertainment)

Place its data in:

    rogue/pak0.pak

Launch with:

    ZZQuake ROGUE

or enable the ROGUE Workbench ToolType.

Other Quake mods can be selected with GAME=name.

MUSIC
-----

ZZQuake provides three mutually exclusive music backends:

MUSIC=MP3
    Uses the native XACP MP3 decoding pipeline on the ZZ9000 ARM.

MUSIC=MHI
    Uses an external MHI-compatible decoder.

MUSIC=CD
    Plays audio tracks from a physical Quake CD.

MP3 replacement tracks are stored in:

    id1/music/

using names such as:

    track02.mp3
    track03.mp3
    track04.mp3
    ...

For both MUSIC=MP3 and MUSIC=MHI, 128 kbit/s CBR MP3 files are recommended
for best playback stability.

SOURCE AND LICENSING
--------------------

The ARM Core1 engine in zzquake.bin is derived from GPL-licensed Quake /
quakegeneric source.

Complete corresponding source for the GPL-covered ARM component is available
in the public repository under:

    applications/games/ZZQuake/source/arm/

The published source rebuilds the released ARM blob bit-identically.

The Amiga 68k launcher is a separate proprietary freeware component.

No Quake PAK files, music or commercial game assets are distributed with
ZZQuake.

PROJECT AND RELEASE
-------------------

ZZQuake 1.0 release:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/ZZQuake-1.0

Project and source:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/tree/main/applications/games/ZZQuake

ZZQuake / XACP port: Xanxi, 2026.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                    859    1636  52.5% -lh5- b564 Sep 14 21:17 ZZQuake.info
[Amiga]                   5593   14882  37.6% -lh5- 1ac6 Sep 14 21:17 ZZQuake/COPYING
[Amiga]                    195     332  58.7% -lh5- 49e4 Sep 14 21:21 ZZQuake/id1/README.txt
[Amiga]                   2620    6420  40.8% -lh5- 857b Sep 14 21:41 ZZQuake/README.txt
[Amiga]                    537     947  56.7% -lh5- d6a9 Sep 14 21:16 ZZQuake/SOURCE.txt
[Amiga]                  53374  107980  49.4% -lh5- 09a1 Sep 14 20:59 ZZQuake/ZZQuake
[Amiga]                 221338  395228  56.0% -lh5- 1ca2 Sep 14 20:54 ZZQuake/zzquake.bin
[Amiga]                   2263    3889  58.2% -lh5- 2a04 Sep 14 20:39 ZZQuake/ZZQuake.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         8 files  286779  531314  54.0%            Sep 16 01:28