ZZHalfLife 1.0 - Half-Life for AmigaOS 3.x and MNT ZZ9000
=======================================================
ZZHalfLife brings Valve's original Half-Life single-player campaign
(1998) to classic Amigas equipped with an MNT ZZ9000.
The Xash3D FWGS engine and Half-Life game code run on the ZZ9000's ARM
Cortex-A9 Core1. The RasterIX GPU inside the ZZ9000 FPGA accelerates
3D rendering. The Amiga 68k manages the Workbench launcher, Picasso96
display, input, file access and audio.
ZZHalfLife is the sixth published XACP application using RasterIX.
IMPORTANT - FIRMWARE AND DRIVER COMPATIBILITY
---------------------------------------------
You MUST use the XACP firmware and matching Picasso96 driver:
XX19d-RIX firmware / XACP protocol v1.8 (or a later version explicitly
compatible with the same XACP/RasterIX interfaces).
Firmware download and installation information:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/XX19d-RIX
Install the XACP-compatible zz9000.card from the firmware package
into LIBS:Picasso96/zz9000.card, following the firmware instructions.
Perform a full power-off after changing firmware or the card driver.
The official MNT Research firmware (versions 1.0 to 1.13) is NOT
compatible with ZZHalfLife. The third-party BlitterStudio firmware is
also NOT compatible with this XACP application. You must use the Xanxi
XX19d-RIX / XACP v1.8 firmware and its matching zz9000.card driver,
or a later version explicitly compatible with these XACP/RasterIX
interfaces. Do not mix firmware and driver implementations.
OTHER REQUIREMENTS
------------------
- AmigaOS 3.x with Picasso96 and MNT ZZ9000.
- A Picasso96 display mode for the selected resolution.
- An original, legally owned Half-Life installation from Steam.
- A Windows PC for the supplied ZZHalfLife-Data.exe preparation tool.
- A way to transfer the resulting files to the Amiga.
Supported resolutions: 320x240, 640x480 (default), and 800x600.
The reference and optimized mode is 640x480. Development was carried
out on an Amiga 4000/68060; a 68030/25 MHz system was also tested.
IMPORTANT - PREPARE THE GAME DATA FROM STEAM
--------------------------------------------
NO original Half-Life game files are included with this archive.
You must own and install the ORIGINAL Half-Life on Steam. The separate
game Half-Life: Source is NOT the required version.
1. On your Windows PC, install Half-Life through Steam.
2. The Windows preparation tool is INCLUDED in this LHA archive:
ZZHalfLife/Windows/ZZHalfLife-Data.exe
On your Windows PC, use 7-Zip or another LHA-compatible archiver to
extract the EXE into a folder. You do NOT need a separate download.
3. Run ZZHalfLife-Data.exe. It automatically searches your Steam libraries for
Half-Life. If prompted, select your Half-Life installation folder
(the folder containing the valve subfolder), typically:
C:\Program Files (x86)\Steam\steamapps\common\Half-Life
4. Let the tool finish. In the folder containing the EXE, it creates:
ZZHalfLife_data\data\
The tool reorganizes your own Half-Life game data into chapter-based
archives to improve loading on the Amiga/ZZ9000. It also prepares
the menu resources, music and the mandatory liblist.gam file.
No game assets are downloaded. Your Steam installation is unchanged.
5. On your Amiga, extract ZZHalfLife.lha into a drawer, for example:
Work:ZZHalfLife/
6. Copy the CONTENTS of the generated ZZHalfLife_data\data\
directory into the existing Work:ZZHalfLife/data/ directory.
MERGE the folders. Do NOT delete or replace the supplied ARM binaries
(zzhl_core.bin, zzhl_core_320.bin, zzhl_core_800.bin, zzhl_game.bin).
7. Double-click the ZZHalfLife Workbench icon to play.
The Windows/ directory is only needed on the PC. You can omit it when
copying the game files to an Amiga with limited disk space.
Do NOT redistribute the game data generated from your Steam copy.
WORKBENCH OPTIONS
-----------------
Use the icon's Information window to edit tooltypes:
RES=320 320x240
RES=640 640x480 (default)
RES=800 800x600
MUSIC=MP3 Prepared MP3 soundtrack
MUSIC=CD Original CD audio (requires CDDEVICE and CDUNIT)
MUSIC=MHI MHI audio backend (requires MHIDRIVER)
MUSIC=NONE No music
KEYS=QWERTY Force QWERTY keyboard layout
NOSOUND Disable sound effects
FPSMAX=30 Optional FPS cap for slower 68k systems
POLL=4000 Optional longer 68k polling interval
The supplied icon does not enable FPSMAX=30 or POLL=4000 by default.
For detailed options, controls and file layout, read README in the LHA.
FEATURES AND GAME SUPPORT
-------------------------
- Half-Life single-player campaign with RasterIX-accelerated 3D.
- 320x240, 640x480 and 800x600 resolutions.
- Workbench launcher and keyboard configuration as documented.
- MP3, CD audio and MHI music options.
- Windows data preparation with chapter-based archives.
- Multiplayer is NOT supported.
- Opposing Force and Blue Shift are not included in this release;
support may be considered in future versions.
On the development A4000/68060, a 19-minute gameplay session at 640x480
averaged 47 FPS; actual performance depends on the scene and system.
SOURCE CODE AND LICENSES
------------------------
This application is free of charge, but its components are NOT all
covered by the same license.
- Xash3D FWGS engine: GPLv3-or-later and inherited file-specific notices.
- Half-Life game code: FWGS hlsdk-portable, under Valve's Half-Life 1
SDK license; its own license text is included.
- FreeVGUI and other dependencies: their respective licenses apply.
- RasterIX FPGA renderer: by ToNi3141; file-specific notices apply.
- ZZGL/librixgpu and Core1 integration: see individual source notices.
- AmigaOS 68k Workbench launcher: separately distributed freeware;
its private source code is NOT included.
- Original Half-Life and its game data: Valve Corporation; not included.
The ARM engine, ARM game module, integration and Windows data preparation
source files, build scripts and applicable license notices are available:
Direct source archive:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/download/ZZHalfLife-1.0/ZZHalfLife_1.0_src.zip
Complete release:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/ZZHalfLife-1.0
Public source directory:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/tree/main/applications/games/ZZHalfLife
See LICENSES.txt, GPL-3.0.txt, HLSDK-LICENSE.txt and
FreeVGUI-LICENSE.txt inside the Amiga archive, and the notices in the
source ZIP. The separation of engine and HLSDK modules does not by itself
resolve their license compatibility; individual license terms apply.
This is an independent, unofficial port, not affiliated with or
endorsed by Valve Corporation or MNT Research. Half-Life is a
trademark of Valve Corporation. The MNT ZZ9000 hardware is made by
MNT Research.
VIDEO AND CREDITS
-----------------
Gameplay video: https://youtu.be/EkbUq131PZ8
Port and XACP integration: Xanxi
Xash3D FWGS engine: Uncle Mike, FWGS team and contributors
Half-Life game and original SDK: Valve Software
Half-Life SDK portability work: FWGS contributors
RasterIX FPGA GPU: ToNi3141 ; implementation for the ZZ9000 by Xanxi
FreeVGUI: Nagist, Valve Software and Alibek Omarov
See LICENSES.txt and the original source notices for full attribution.
|