Overview:

This is an Amiga 68k port of Duke Nukem 3D based on an old Atari port
with some newer features from Chocolate Duke added for extra flavour.


Requirements:

1) An RTG Amiga.
2) 68060 processor or better.
3) 32 MB of RAM.
4) AHI installed and configured (see links section below).
5) Music packs for digital music playback (see links section below).
6) The Duke Nukem 3D data files (must be the PC Atomic version).


Configuration Options:

The tooltype 'closewb' can be used to close the Workbench.
You must specify a stack of at least 300,000.
The AHI device used will be the one setup in your AHI Prefs (unit 0).
You will need to place the PC game data files DUKE3D.GRP and DUKE.RTS 
in the AmiDuke folder.
You will need to place the digital music files in the AmiDuke music folder.
Any errors *should* be written to a file called 'ERROR.TXT' in the game
directory.
To release the mouse capture in windowed mode you will need to access 
the mouse menu.


Performance Considerations:

1) If you have a Blizzard you should really be using BlizKick, Apollo users
   should be using RemApollo.
2) Fast File System is actually really slow, use PFS3 instead.
3) Playing OGG compressed music on a real Amiga will be very slow, try using
   WAV files instead.
4) Use v4.18 of AHI as the later versions are too slow on a real Amiga.
5) Running in a window with an 8 bit screen mode will be slower.


Limitations:

1) No network or multi-player support.
2) No joystick support.


Version History:

1.0.08 - Initial release based on the AGA version.
1.0.09 - Fixed graphic issues with ramps.
1.0.10 - Fixed close Workbench tooltype.
1.0.16 - Added support to run from the Shell, slight performance improvements.
1.0.18 - Fixed memory corruption on startup.
1.0.19 - Added support for playing back compressed music files (OGG/WAV) using
         the SDL Mixer.
1.0.20 - Fixed minor memory leak.
1.0.21 - Added window mode support and native MIDI support (CAMD).
1.0.22 - Fixed mouse capture when switching video modes.
1.0.26 - Fixed mouse capture.
1.0.27 - Fixed minor memory leak.
1.0.28 - SDL fixes for 8 bit window mode.
1.0.29 - Updated window mode and input capture handling.
1.0.30 - Fixed memory bug when loading the DUKE.RTS file.
1.0.31 - Minor performance improvements, stack check added.
1.0.32 - Removed broken MIDI support, updated inactive window handling.
1.0.33 - Minor performance improvements.


Links:

http://eab.abime.net/showthread.php?p=1043667 (AmiDuke thread on EAB)
http://www.gog.com/game/duke_nukem_3d_atomic_edition (game data)
http://fabiensanglard.net/duke3d/ (Duke Nukem 3D code review)
https://github.com/fabiensanglard/chocolate_duke3D (Chocolate Duke3D)
http://aminet.net/package/driver/audio/ahiusr_4.18 (AHI Audio system)
https://www.youtube.com/watch?v=NlkxvDx27sY (AHI setup guide)
http://sc55.duke4.net/ (Roland SC-55 based OGG music packs)


Thanks and acknowledgements:

Fabien Sanglard

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]               572082 1146928  49.9% -lh5- 3bf5 Jun 15 20:43 AmiDuke/AmiDuke
[unknown]                13956   15284  91.3% -lh5- 06e9 Mar  3 15:19 AmiDuke/AmiDuke.info
[unknown]                 1275    3106  41.0% -lh5- 30f1 Apr 26 20:55 AmiDuke/DUKE3D.CFG
[unknown]                  685    1109  61.8% -lh5- 14c3 Jan  8  1980 AmiDuke/DUKE3D.CFG.info
[unknown]                 2344    4676  50.1% -lh5- 7ea3 Feb 18  2009 AmiDuke/LICENSE.DOC
[unknown]                 2268    4518  50.2% -lh5- 3d67 Feb 18  2009 AmiDuke/license.txt
[unknown]                81902   81902 100.0% -lh0- d39c Mar  7 20:10 AmiDuke/music/music_files_example.jpg
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 AmiDuke/music/place_music_files_here.txt
[unknown]                 1550    3187  48.6% -lh5- d9f5 Jun 15 20:44 AmiDuke/AmiDuke.readme
[unknown]                 1864    2808  66.4% -lh5- 3b5d Jul 11  2020 AmiDuke/AmiDuke.readme.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        10 files  677926 1263518  53.7%            Jun 16 02:59