Revive Amiga port for NetHack 3.7

Update the Amiga Intuition window port (AMII/AMIV) for the 3.7 window_procs API. Key changes: - Update all window function signatures for 3.7 - Add assembly trampolines for AmigaOS register-based callbacks - Convert all K&R function definitions to C99 - Add cross-compilation build system (cross-pre1/pre2/post.370) using bebbo's m68k-amigaos-gcc with -noixemul -std=gnu17 -m68000 - Clipping fixes: viewport centering, simplified ScrollRaster, duplicate Ctrl-R suppression, glyph buffer invalidation - Add menucolor support in menu rendering - Move native txt2iff.c and xpm2iff.c to outdated/ - Add nethack.cnf and README.amiga
2026-03-23 20:48:06 +01:00
parent 7b89255ea8
commit 2d597cb9fa
27 changed files with 1101 additions and 908 deletions
@@ -0,0 +1,106 @@
+                        NetHack 3.7 for Amiga
+                        ====================
+
+Requirements
+------------
+  - AmigaOS 3.0 or later (Kickstart 39+)
+  - 6 MB free RAM minimum (8 MB recommended)
+  - Hard drive with ~5 MB free space
+
+Recommended: RTG graphics card (Picasso96/CyberGraphX) for best
+tile rendering. Native AGA/OCS/ECS chipsets are supported.
+
+
+Installation
+------------
+Extract NH370AMI.ZIP to a directory and assign it:
+
+    assign NetHack: <path>
+
+The directory should contain:
+    nethack          - game binary
+    nhdat            - data library
+    symbols          - symbol set definitions
+    sysconf          - system configuration
+    nethack.cnf      - game options
+    hack.font        - font descriptor
+    hack/8           - font bitmap (8pt)
+    tiles/tiles16.iff - 16-color tiles (OCS/ECS)
+    tiles/tiles32.iff - 32-color tiles (AGA/RTG)
+    tomb.iff         - tombstone image
+    record           - high score file
+
+To play:
+    cd NetHack:
+    nethack
+
+
+Display Modes
+-------------
+Two display modes are available, selected in nethack.cnf:
+
+  Text mode (AMII):
+    OPTIONS=symset:AmigaFont
+
+  Tile mode (AMIV):
+    OPTIONS=windowtype:amiv
+
+Tile mode auto-selects tiles32.iff (32 colors, 5 bitplanes) when the
+screen supports 32+ colors, otherwise tiles16.iff (16 colors, 4 planes).
+
+
+Configuration
+-------------
+Edit nethack.cnf for game options.  Key settings:
+
+  OPTIONS=windowtype:amiv       - tile graphics (default)
+  OPTIONS=symset:AmigaFont      - text mode with line-drawing chars
+  OPTIONS=menucolors            - colored inventory items
+  OPTIONS=time,lit_corridor     - show turn count, lit corridors
+  OPTIONS=boulder:0             - display boulders as '0'
+
+Menu color examples (add after OPTIONS=menucolors):
+  MENUCOLOR=" blessed "=green
+  MENUCOLOR=" cursed "=red
+  MENUCOLOR=" uncursed "=cyan
+
+
+Building from Source
+--------------------
+Cross-compilation from Linux using bebbo's m68k-amigaos-gcc toolchain
+(https://franke.ms/git/bebbo/amiga-gcc):
+
+    # Install toolchain to /opt/amiga
+    # Clone NetHack 3.7 source
+    cd NetHack
+    make fetch-lua
+    sys/unix/setup.sh sys/unix/hints/linux.370
+    make CROSS_TO_AMIGA=1 all
+    make CROSS_TO_AMIGA=1 package
+
+The distribution ZIP is created at targets/amiga/NH370AMI.ZIP.
+
+Toolchain requirements:
+  - m68k-amigaos-gcc (bebbo's amigaos-cross-toolchain in /opt/amiga)
+  - -noixemul (libnix) for linking
+  - -m68000 for maximum compatibility (or -m68020/040/060)
+
+
+Known Issues
+------------
+  - Native Amiga compilation (SAS/C, DICE) is not supported;
+    cross-compilation with GCC is required
+
+
+Credits
+-------
+Olaf Seibert first ported NetHack 2.3 and 3.0 to the Amiga.
+Richard Addison, Andrew Church, Jochen Erwied, Mark Gooderum,
+Ken Lorber, Greg Olson, Mike Passaretti, and Gregg Wonderly
+polished and extended the 3.0 and 3.1 ports.  Andrew Church,
+Ken Lorber, and Gregg Wonderly are responsible for the 3.2 port.
+Janne Salmijärvi resurrected the Amiga port for 3.3 and
+Teemu Suikki joined before 3.4.0.
+
+Updated for NetHack 3.7, cross compile fixes and 32 color tile support by Ingo
+Paschke in 2026.