Return to Castle Wolfenstein - single player for AmigaOS 3.x
============================================================

A port of the Return to Castle Wolfenstein single player game to 68k
AmigaOS 3.x, based on the MorphOS port of the GPL source release. It
renders through minigl.library and was written for PiStorm3D, the
hardware MiniGL for Raspberry Pi 4 / CM4 based PiStorm systems (Emu68).

Source code, build instructions and notes:
  https://github.com/Sdursun/ReturnToCastleWolfenstein_Minigl68k

About this project
------------------
The code of this port was written entirely with Claude Code, an AI coding
assistant, working together with me on real hardware: I ran every build
on my Amiga and sent back the logs, and Claude Code found the problems and
wrote the fixes. I do not normally port games; this is an experimental
project for me. I believe a good programmer can do wonderful things with
this code base and with PiStorm3D.

Status
------
Tested on AmigaOS 3.2, PiStorm with Raspberry Pi 4 (Emu68) and the
PiStorm3D minigl.library of 2026-09-24:

- Menus, levels, cutscenes, sound, keyboard, mouse and console work.
- About 40 fps at 640x480 in the first level (20-38 fps while moving);
  r_vertexlight 1 adds about 10 fps.
- A level loads in about 25 s from an FFS partition.

This is a first test release. Other minigl.library implementations have
not been tested.

Requirements
------------
- AmigaOS 3.x, 68040 or better with an FPU (Emu68 qualifies)
- RTG (Picasso96 or CyberGraphX)
- minigl.library in LIBS: (from PiStorm3D, not included)
- AHI
- Plenty of Fast RAM (about 25 MB for the program, as much for the data)
- The game data of the PC version patched to 1.41: pak0.pk3,
  sp_pak1.pk3, sp_pak2.pk3, sp_pak3.pk3. The data is NOT included in this
  archive and is not freely distributable; use your own copy of the game.

Installation
------------
1. Copy the main/ directory of your PC installation to e.g.
   Games:RTCW/main
2. Copy rtcw-sp to Games:RTCW and main/amiga.cfg from this archive to
   Games:RTCW/main
3. Start it from a Shell:
     cd Games:RTCW
     rtcw-sp +exec amiga.cfg

To keep the settings, add "exec amiga.cfg" to main/autoexec.cfg.

Notes
-----
- Console commands need a leading slash in game (/god, /cg_drawFPS 1).
  Cheats need the level to be started with +devmap, e.g.
  rtcw-sp +exec amiga.cfg +devmap escape1
- Use a Paula mode in AHI prefs (e.g. "Paula: HiFi 14 bit stereo++"). A
  sound card through AHI costs a lot of speed on PiStorm.
- The MiniGL warning about a small stack at startup can be ignored; the
  game switches to its own 2 MB stack.
- 640x480 is the fastest mode; lower resolutions are slower.
- Not supported: networking, stencil shadows, clip planes for mirrors
  and portals, gamma control, the mouse pointer in windowed mode.

More details are in README.txt (English) and OKUBENI.txt (Turkish) in
the archive.

Credits
-------
- id Software - Return to Castle Wolfenstein and its GPL source release
- Mark Olsen and Sigbjorn Skjaeret - the MorphOS port
- Hyperion Entertainment - MiniGL
- Steffen Haeuser and the PiStorm3D contributors - PiStorm3D
- Stefan "Bebbo" Franke - the m68k-amigaos-gcc toolchain
- Sean Barrett - stb_sprintf

Licence
-------
GNU General Public License version 3 with id Software's additional terms
(COPYING.txt in the archive). This is a modified version of the Return to
Castle Wolfenstein single player GPL source code; it is not made or
endorsed by id Software or ZeniMax Media. "Return to Castle Wolfenstein"
and "Wolfenstein" are trademarks of their owners.

The complete source code is available at the address above.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
-rwxrwxrwx     0/0       12736   35873  35.5% -lh5- 84dc Sep 25 17:47 RTCW_Pistorm/COPYING.txt
-rwxrwxrwx     0/0        1015    1832  55.4% -lh5- ed62 Sep 25 16:14 RTCW_Pistorm/OKUBENI.txt
-rwxrwxrwx     0/0        1739    3431  50.7% -lh5- 0dae Sep 25 17:48 RTCW_Pistorm/README.txt
-rwxrwxrwx     0/0         291     486  59.9% -lh5- 454a Sep 25 16:13 RTCW_Pistorm/main/amiga.cfg
-rwxrwxrwx     0/0     1478791 3614368  40.9% -lh5- ba85 Sep 25 17:47 RTCW_Pistorm/rtcw-sp
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         5 files 1494572 3655990  40.9%            Sep 26 00:26