Overview:

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


Requirements:

1) An RTG Amiga (32-bit pixel format ARGB recommended).
2) 68060 processor or better (PiStorm recommended).
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) CAMD library installed and configured for native MIDI playback.
7) The Duke Nukem 3D data files (must be the full PC Atomic version!).


Configuration Options:

If you have trouble running in 32-bit color mode, check your P96 preferences
and ensure -> Overall Settings -> DepthIncludesAlpha -> ON.
The 'CloseWB' configuration option 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.
It will try to use digital music data first, if no files are found it
will then try and use the game data to play native MIDI (CAMD).
To release the mouse capture in windowed mode you will need to access 
the mouse menu.
Any errors/warnings should be written to a log file.


Performance Considerations:

1) Fast File System is actually not, use PFS3 instead.
2) Playing OGG compressed music on a real 68k CPU will be very slow, try using
   WAV files or MIDI instead.
3) Use v4.18 of AHI as the later versions are too slow.
4) 32-bit color image reconstruction on a real 68k CPU will be very slow.


Limitations:

1) No network 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.
1.0.35 - Changed timer back to threaded, minor menu bug fixes.
1.0.36 - Added back native MIDI support, fixed the help screen.
1.0.38 - Reupload.
1.0.39 - Minor updates.
1.0.40 - Updated mixer, fixed display handling.
1.0.41 - Fixed MIDI playback speed.
2.0.04 - Added mouse wheel support and PiStorm optimized image reconstruction.
2.0.06 - Image reconstruction tweaks.
2.0.07 - Fixed minor memory leak.
2.0.08 - Minor bug fixes.


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)
https://www.youtube.com/watch?v=NlkxvDx27sY (AHI setup guide)
https://convertio.co/ (OGG to WAV converter)
http://sc55.duke4.net/ (Roland SC-55 based OGG music packs)


Thanks and acknowledgements:

Fabien Sanglard

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                 558108 1125740  49.6% -lh5- fc2b May 28 05:41 AmiDuke/AmiDuke
[Amiga]                   7082    7325  96.7% -lh5- 5e20 May 29 09:46 AmiDuke/AmiDuke.info
[Amiga]                   1781    3782  47.1% -lh5- 9154 May 28 05:43 AmiDuke/AmiDuke.readme
[Amiga]                   1821    2756  66.1% -lh5- f73b May 29 09:46 AmiDuke/AmiDuke.readme.info
[Amiga]                   1313    3201  41.0% -lh5- 7b3f Apr 25 10:07 AmiDuke/DUKE3D.CFG
[Amiga]                    828    1314  63.0% -lh5- 640d Apr 20 11:33 AmiDuke/DUKE3D.CFG.info
[Amiga]                   7232    7424  97.4% -lh5- 59ac May 12 12:50 AmiDuke/Grabs.info
[Amiga]                 310646  921654  33.7% -lh5- a693 May 10 14:30 AmiDuke/Grabs/duke_20260510_143051.bmp
[Amiga]                      0       0 100.0% -lh0- 0000 Mar 27  2021 AmiDuke/Grabs/screen_grabs_go_here.txt
[Amiga]                   2344    4676  50.1% -lh5- 7ea3 Feb 18  2009 AmiDuke/LICENSE.DOC
[Amiga]                   2268    4518  50.2% -lh5- 3d67 Feb 18  2009 AmiDuke/license.txt
[Amiga]                   1381    1915  72.1% -lh5- 5add May 29 09:49 AmiDuke/LOG.TXT.info
[Amiga]                   7233    7424  97.4% -lh5- bec0 Apr 20 11:37 AmiDuke/Music.info
[Amiga]                  81902   81902 100.0% -lh0- d39c Mar  7  2022 AmiDuke/Music/music_files_example.jpg
[Amiga]                      0       0 100.0% -lh0- 0000 Mar 27  2021 AmiDuke/Music/place_music_files_here.txt
[Amiga]                   4806    5015  95.8% -lh5- 2d26 May 29 09:49 AmiDuke/Music/place_music_files_here.txt.info
[Amiga]                 389035  389035 100.0% -lh0- d0fc Apr 22 11:16 AmiDuke/src.zip
[Amiga]                   7233    7424  97.4% -lh5- b123 May 29 09:55 AmiDuke.info
[Amiga]                    571    2739  20.8% -lh5- b178 May 28 16:26 AmiDuke/LOG.TXT
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        19 files 1385584 2577844  53.7%            May 30 00:41