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) 32MB of FAST RAM
4) The original games (or demos)
5) AHI installed and configured (see links section below)
6) Music packs for digital music playback (see links section below)
7) CAMD library installed and configured for native MIDI playback (see links
section below)


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.


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 (DOOM enhanced port)
http://aminet.net/package/game/shoot/ZDOOM_RTG (DOOM enhanced port)
http://aminet.net/package/game/shoot/ODAMEX_RTG (DOOM enhanced port)

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                12132   15705  77.2% -lh5- 9be3 May  4 21:45 Chocolate/HEXEN/HEXEN.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/HEXEN/music/place_music_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/HEXEN/place_wad_files_here.txt
[unknown]               129312  303380  42.6% -lh5- 9888 Jul  1 16:32 Chocolate/HEXEN/Setup
[unknown]                 6109    8938  68.3% -lh5- 91ed Apr 24 00:33 Chocolate/HEXEN/Setup.info
[unknown]                  617    1321  46.7% -lh5- e1e7 Apr  1 17:39 Chocolate/HEXEN/stdout.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/HERETIC/place_wad_files_here.txt
[unknown]               129312  303380  42.6% -lh5- 9888 Jul  1 16:32 Chocolate/HERETIC/Setup
[unknown]                 6131    8940  68.6% -lh5- adc6 Apr 24 00:33 Chocolate/HERETIC/Setup.info
[unknown]                   52      52 100.0% -lh0- bd8c Apr  1 17:38 Chocolate/HERETIC/stdout.txt
[unknown]                  818    3099  26.4% -lh5- 8c55 Apr 24 00:18 Chocolate/HEXEN/chocolate-hexen.cfg
[unknown]               489458 1026112  47.7% -lh5- 9529 Jul  1 16:33 Chocolate/HEXEN/HEXEN
[unknown]                  492    1770  27.8% -lh5- 6b65 Apr 24 00:18 Chocolate/HEXEN/hexen.cfg
[unknown]                  657    1397  47.0% -lh5- 26fc Apr  2 21:17 Chocolate/DOOM/stdout.txt
[unknown]                  734    2739  26.8% -lh5- e2aa Apr 24 00:13 Chocolate/HERETIC/chocolate-heretic.cfg
[unknown]               457610  923720  49.5% -lh5- 4c27 Jul  1 16:33 Chocolate/HERETIC/HERETIC
[unknown]                  324    1472  22.0% -lh5- 9afe Apr 24 00:13 Chocolate/HERETIC/heretic.cfg
[unknown]                 9926   14829  66.9% -lh5- ef9f May  4 21:46 Chocolate/HERETIC/HERETIC.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/HERETIC/music/place_music_files_here.txt
[unknown]                  389    1363  28.5% -lh5- 3ab0 Apr 24 00:15 Chocolate/DOOM/default.cfg
[unknown]               462057  925596  49.9% -lh5- 16c4 Jul  1 15:54 Chocolate/DOOM/DOOM
[unknown]                13411   15937  84.2% -lh5- 1794 May  4 21:44 Chocolate/DOOM/DOOM.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/DOOM/music/place_music_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/DOOM/place_wad_files_here.txt
[unknown]               129312  303380  42.6% -lh5- 9888 Jul  1 16:32 Chocolate/DOOM/Setup
[unknown]                 6127    8932  68.6% -lh5- 215e Apr 24 00:29 Chocolate/DOOM/Setup.info
[unknown]                  733    2739  26.8% -lh5- 8830 Apr 24 00:15 Chocolate/DOOM/chocolate-doom.cfg
[unknown]               129312  303380  42.6% -lh5- 9888 Jul  1 16:32 Chocolate/STRIFE/Setup
[unknown]                 5951    8939  66.6% -lh5- 4aa7 Apr 24 00:34 Chocolate/STRIFE/Setup.info
[unknown]                  450     906  49.7% -lh5- 1639 Apr  1 23:17 Chocolate/STRIFE/stdout.txt
[unknown]               467111  950596  49.1% -lh5- 4f29 Jul  1 16:41 Chocolate/STRIFE/STRIFE
[unknown]                  542    1973  27.5% -lh5- 72b8 Apr 24 00:22 Chocolate/STRIFE/strife.cfg
[unknown]                11883   15291  77.7% -lh5- b0f6 May  4 21:46 Chocolate/STRIFE/STRIFE.info
[unknown]                 2731    6669  41.0% -lh5- 7ac0 Mar  8 14:41 Chocolate/NOT-BUGS.txt
[unknown]                 1713    3887  44.1% -lh5- 6602 Mar  8 14:41 Chocolate/README.txt
[unknown]                 1851    2811  65.8% -lh5- 6b47 Apr 24 00:38 Chocolate/STRIFE.info
[unknown]                  761    2895  26.3% -lh5- 4f4b Apr 24 00:22 Chocolate/STRIFE/chocolate-strife.cfg
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/STRIFE/music/place_music_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/STRIFE/place_wad_files_here.txt
[unknown]                 1865    2808  66.4% -lh5- 7773 Apr 24 00:38 Chocolate/Chocolate.readme.info
[unknown]              1897874 1897874 100.0% -lh0- 93fa Apr  3 20:35 Chocolate/ChocolateDOOM_src.zip
[unknown]                 3176   10348  30.7% -lh5- 1349 Mar  8 14:41 Chocolate/CMDLINE.txt
[unknown]                 7096   18431  38.5% -lh5- bfac Mar  8 14:41 Chocolate/COPYING.txt
[unknown]                 1851    2811  65.8% -lh5- 79bb Apr 24 00:38 Chocolate/DOOM.info
[unknown]                 1848    2811  65.7% -lh5- 46d9 Apr 24 00:38 Chocolate/HERETIC.info
[unknown]                 1849    2811  65.8% -lh5- 79f9 Apr 24 00:38 Chocolate/HEXEN.info
[unknown]                22123   58802  37.6% -lh5- 48d5 Mar  8 14:41 Chocolate/NEWS.txt
[unknown]                 2077    4262  48.7% -lh5- a833 Jul  1 16:37 Chocolate/Chocolate.readme
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        48 files 4417777 7173106  61.6%            Jul  2 01:18