Overview:

Amiga 68k port based on Chocolate Doom v2.3.0...includes ports of Heretic,
Hexen and Strife.

1998 saw the public release of the Doom source code by its original authors,
id Software. Since then, a large number of Doom "source ports" have been
created by programmers, who have extended the code, adding new features and
removing some of the limitations of DOS Doom (now commonly referred to as
"Vanilla Doom" by fans). These efforts should be commended, and many of the
modern Doom source ports are truly impressive pieces of work.

Chocolate Doom takes a different approach to other source ports. Its aim is
to accurately reproduce the experience of playing Vanilla Doom. It is a
conservative, historically accurate Doom source port, which is compatible with
the thousands of mods and levels that were made before the Doom source code
was released.  Rather than flashy new graphics, Chocolate Doom's main features
are its accurate reproduction of the game as it was played in the 1990s. The
project is developed around a carefully-considered philosophy that
intentionally restricts which features may be added (and rejects any that
affect gameplay).

Originally just a port of the Doom source code, the project has grown to
include ports of Heretic, Hexen and Strife, other commercial games that were
based on the Doom engine.


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) CAMD library installed and configured for native MIDI playback (see links
   section below).
7) The original PC games (or demos).


Configuration Options:

When running from the Shell 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).
Please see the Chocolate Doom documentation for command line options, most of
these can be set via Tooltypes.
You need to use the Setup utility to configure each game, this can also be used
to select the music device and set the display mode.


Limitations:

1) No network or multi-player support.
2) No Joystick support because 2 button DOOM is boring.


Version History:

2.3.0.01 - Added window mode support.
2.3.0.03 - Added native MIDI support (CAMD).
2.3.0.04 - Changed to update window even when inactive (DOOM and Strife).
2.3.0.05 - Fixed looping bug with MIDI playback.
2.3.0.06 - Updated mouse grab.
2.3.0.07 - SDL fixes for 8 bit window mode.
2.3.0.08 - Updated window mode and input capture handling.
2.3.0.09 - Updated custom WAD file handling.
2.3.0.10 - Fixed sound effects configuration.


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 real hardware.
5) If you are using Paula stick with the 'FAST' 8 bit Mono/Stereo++ modes
   (AHI prefs).
6) A 16 bit sound card *might* be faster with a 16 bit mode (AHI prefs).
7) If you're still having performance problems, make sure you are using the
   latest/patched WAD files (see links section).


Links:

http://eab.abime.net/showthread.php?t=106461 (Chocolate Doom thread on EAB)
https://www.chocolate-doom.org/wiki/index.php/Chocolate_Doom (Chocolate Doom
offical page)
http://www.doomworld.com/classicdoom/info/patches.php (DOOM WAD versions)
http://aminet.net/package/driver/audio/ahiusr_4.18 (AHI Audio system)
https://www.youtube.com/watch?v=NlkxvDx27sY (AHI setup guide)
http://aminet.net/package/mus/edit/camd (Commodore Amiga MIDI driver)
http://sc55.duke4.net/ (Roland SC-55 based OGG music packs)
http://sycraft.org/content/audio/hexen.shtml (Hexen OGG music packs)
https://www.dropbox.com/s/6avtah7kd3jsim3/Strife%20Music%20-%20Veteran%20Edition
.zip (Strife music packs)
http://aminet.net/package/game/shoot/BOOM_RTG (DOOM port)
http://aminet.net/package/game/shoot/PrBoom (DOOM port)
http://aminet.net/package/game/shoot/ZDOOM_RTG (DOOM port)
http://aminet.net/package/game/shoot/ODAMEX_RTG (DOOM port)

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                12101   15657  77.3% -lh5- b456 Mar 17  2022 Chocolate/HEXEN/HEXEN.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/HEXEN/music/place_music_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/HEXEN/place_wad_files_here.txt
[unknown]               127258  289212  44.0% -lh5- 7818 Feb 23 14:15 Chocolate/HEXEN/Setup
[unknown]                 6109    8938  68.3% -lh5- 91ed Apr 24  2021 Chocolate/HEXEN/Setup.info
[unknown]                   64      64 100.0% -lh0- f4f4 Feb 22 15:12 Chocolate/HEXEN/stdout.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/DOOM/place_wad_files_here.txt
[unknown]               127258  289212  44.0% -lh5- 7818 Feb 23 14:15 Chocolate/DOOM/Setup
[unknown]                 6127    8932  68.6% -lh5- 215e Apr 24  2021 Chocolate/DOOM/Setup.info
[unknown]                  657    1397  47.0% -lh5- 26fc Apr  2  2021 Chocolate/DOOM/stdout.txt
[unknown]                  735    2730  26.9% -lh5- 7d73 Feb 22 15:12 Chocolate/HEXEN/chocolate-hexen.cfg
[unknown]               495076 1042220  47.5% -lh5- b755 Feb 22 15:04 Chocolate/HEXEN/HEXEN
[unknown]                  359    1314  27.3% -lh5- 9ef7 Feb 22 15:12 Chocolate/HEXEN/hexen.cfg
[unknown]                  733    2739  26.8% -lh5- 8830 Apr 24  2021 Chocolate/DOOM/chocolate-doom.cfg
[unknown]                  389    1363  28.5% -lh5- 3ab0 Apr 24  2021 Chocolate/DOOM/default.cfg
[unknown]               464616  924984  50.2% -lh5- c641 Feb 22 15:04 Chocolate/DOOM/DOOM
[unknown]                13432   16009  83.9% -lh5- 0c14 Mar 17  2022 Chocolate/DOOM/DOOM.info
[unknown]                86342   86342 100.0% -lh0- 1479 Mar 17  2022 Chocolate/DOOM/music/music files example.jpg
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/DOOM/music/place_music_files_here.txt
[unknown]                 9897   14781  67.0% -lh5- 6bdc Mar 17  2022 Chocolate/HERETIC/HERETIC.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/HERETIC/music/place_music_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/HERETIC/place_wad_files_here.txt
[unknown]               127258  289212  44.0% -lh5- 7818 Feb 23 14:15 Chocolate/HERETIC/Setup
[unknown]                 6131    8940  68.6% -lh5- adc6 Apr 24  2021 Chocolate/HERETIC/Setup.info
[unknown]                   66      68  97.1% -lh5- 1b28 Feb 23 14:21 Chocolate/HERETIC/stdout.txt
[unknown]                  734    2739  26.8% -lh5- e2aa Apr 24  2021 Chocolate/HERETIC/chocolate-heretic.cfg
[unknown]               460716  923128  49.9% -lh5- e926 Feb 22 15:04 Chocolate/HERETIC/HERETIC
[unknown]                  324    1472  22.0% -lh5- 9afe Apr 24  2021 Chocolate/HERETIC/heretic.cfg
[unknown]                  450     906  49.7% -lh5- 1639 Apr  2  2021 Chocolate/STRIFE/stdout.txt
[unknown]               470066  950008  49.5% -lh5- 3567 Feb 22 15:04 Chocolate/STRIFE/STRIFE
[unknown]                  542    1973  27.5% -lh5- 72b8 Apr 24  2021 Chocolate/STRIFE/strife.cfg
[unknown]                11850   15243  77.7% -lh5- 2e37 Mar 17  2022 Chocolate/STRIFE/STRIFE.info
[unknown]                 1851    2811  65.8% -lh5- 6b47 Apr 24  2021 Chocolate/STRIFE.info
[unknown]                  761    2895  26.3% -lh5- 4f4b Apr 24  2021 Chocolate/STRIFE/chocolate-strife.cfg
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/STRIFE/music/place_music_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27  2021 Chocolate/STRIFE/place_wad_files_here.txt
[unknown]               127258  289212  44.0% -lh5- 7818 Feb 23 14:15 Chocolate/STRIFE/Setup
[unknown]                 5951    8939  66.6% -lh5- 4aa7 Apr 24  2021 Chocolate/STRIFE/Setup.info
[unknown]                 1865    2808  66.4% -lh5- 7773 Apr 24  2021 Chocolate/Chocolate.readme.info
[unknown]                 3176   10348  30.7% -lh5- 1349 Mar  8  2021 Chocolate/CMDLINE.txt
[unknown]                 7096   18431  38.5% -lh5- bfac Mar  8  2021 Chocolate/COPYING.txt
[unknown]                 1851    2811  65.8% -lh5- 79bb Apr 24  2021 Chocolate/DOOM.info
[unknown]                 1848    2811  65.7% -lh5- 46d9 Apr 24  2021 Chocolate/HERETIC.info
[unknown]                 1849    2811  65.8% -lh5- 79f9 Apr 24  2021 Chocolate/HEXEN.info
[unknown]                22123   58802  37.6% -lh5- 48d5 Mar  8  2021 Chocolate/NEWS.txt
[unknown]                 2731    6669  41.0% -lh5- 7ac0 Mar  8  2021 Chocolate/NOT-BUGS.txt
[unknown]                 1713    3887  44.1% -lh5- 6602 Mar  8  2021 Chocolate/README.txt
[unknown]                 2157    4496  48.0% -lh5- 21aa Feb 22 15:10 Chocolate/Chocolate.readme
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        48 files 2611520 5317314  49.1%            Feb 24 02:52