Short:        HighRes add-on for ZZQuake on ZZ9000
Author:       Xanxi
Uploader:     Xanxi - hassani hakim gmail com
Type:         game/shoot
Version:      1.0
Requires:     68020+ Amiga; MNT ZZ9000; firmware XX19b or later; Picasso96; original Quake PAK data
Architecture: m68k-amigaos

ZZQuake HighRes Pack 1.0
========================

ZZQuake HighRes is the high-resolution companion pack for ZZQuake 1.0 on
classic Amiga systems equipped with an MNT ZZ9000.

IMPORTANT: this is an add-on / companion to the normal ZZQuake 1.0 release.
It uses exactly the same Quake data directory, mission-pack directories,
mods and music layout as ZZQuake 1.0.

The original ZZQuake 1.0 / 320x240 release remains separate and unchanged.

INCLUDED BUILDS
---------------

    ZZQuake640      640x480
    ZZQuake800      800x600
    ZZQuake1024     1024x768

Measured timedemo demo1 performance on the development A4000/68060 + ZZ9000:

    640x480         41.9 fps
    800x600         29.6 fps
    1024x768        20.0 fps

RELATION TO ZZQUAKE 1.0
-----------------------

The HighRes launchers use the same directory structure as normal ZZQuake:

    id1/pak0.pak
    id1/pak1.pak
    id1/music/track02.mp3
    id1/music/track03.mp3
    ...

and the same optional directories:

    hipnotic/
    rogue/
    other mod directories selected with GAME=name

Therefore, if you already have a working ZZQuake 1.0 installation, the
recommended installation is simply to place the HighRes launchers, icons
and matching Core1 blobs in the SAME ZZQuake directory.

For example:

    ZZQuake/
        ZZQuake
        zzquake.bin

        ZZQuake640
        ZZQuake640.info
        zzq640.bin

        ZZQuake800
        ZZQuake800.info
        zzq800.bin

        ZZQuake1024
        ZZQuake1024.info
        zzq1024.bin

        id1/
            pak0.pak
            pak1.pak
            music/
                track02.mp3
                track03.mp3
                ...

        hipnotic/
        rogue/

In this configuration, normal ZZQuake and all three HighRes versions share
the same Quake PAK files, music, mission packs, mods and saved data. There is
no need to duplicate your Quake data.

If you prefer to keep ZZQuake HighRes in a separate directory, copy your
existing id1/ directory there as well, including id1/music/ if you use MP3 or
MHI music. Copy hipnotic/, rogue/ or any mod directories you want to use too.

Quake game data and music are NOT included in this archive.

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

ZZQuake HighRes Pack 1.0 requires firmware XX19b or later.

Firmware and project releases are available from:

https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases

STARTING THE HIGHRES VERSIONS
-----------------------------

Launch the desired version from Workbench or Shell:

    ZZQuake640
    ZZQuake800
    ZZQuake1024

Each launcher must remain together with its matching Core1 blob:

    ZZQuake640      zzq640.bin
    ZZQuake800      zzq800.bin
    ZZQuake1024     zzq1024.bin

OFFICIAL MISSION PACKS AND MODS
--------------------------------

The same options as ZZQuake 1.0 are supported:

    HIPNOTIC
    ROGUE
    GAME=name

The corresponding directories are the same ones used by normal ZZQuake.

MUSIC
-----

ZZQuake HighRes retains the same three music backends as ZZQuake 1.0:

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

MUSIC=MHI
    Uses an external MHI-compatible decoder.

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

MP3 replacement tracks are NOT stored in a separate top-level MUSIC drawer.
They belong inside the normal Quake data tree:

    id1/music/

using names such as:

    id1/music/track02.mp3
    id1/music/track03.mp3
    id1/music/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 engines in zzq640.bin, zzq800.bin and zzq1024.bin are derived
from GPL-licensed Quake / quakegeneric source.

Complete corresponding source and build material is available in the public
repository under:

    applications/games/ZZQuakeHighRes/

and in the GPL source archive attached to the GitHub release.

The Amiga 68k launchers are separate proprietary freeware components.

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

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

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

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

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

Video:
https://youtu.be/cA2HyqZZk8k

ZZQuake / XACP port and HighRes variants: Xanxi, 2026.