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) OGG compressed music packs for music playback (see links section below)
6) AHI installed and configured (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.


Limitations:

1) No network or multi-player support
2) No Joystick support
3) No window mode support (during gameplay)
4) Only OGG/WAV music supported


Version History:

2.3.1 - Initial release
2.3.2 - Fixed Tooltype defaults


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://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]               438678  880924  49.8% -lh5- b03f Apr  1 23:17 Chocolate/DOOM/DOOM
[unknown]                46503   59067  78.7% -lh5- 432d Apr  6 10:27 Chocolate/DOOM/DOOM.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/DOOM/music/place_ogg_or_wav_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/DOOM/place_wad_files_here.txt
[unknown]               130468  305224  42.7% -lh5- 4783 Apr  1 23:17 Chocolate/DOOM/Setup
[unknown]                42735   64034  66.7% -lh5- 6a7e Apr  6 10:27 Chocolate/DOOM/Setup.info
[unknown]                  657    1397  47.0% -lh5- 26fc Apr  2 21:17 Chocolate/DOOM/stdout.txt
[unknown]                  729    2707  26.9% -lh5- eb72 Apr  2 21:27 Chocolate/DOOM/chocolate-doom.cfg
[unknown]                  389    1362  28.6% -lh5- 4d9d Apr  2 21:17 Chocolate/DOOM/default.cfg
[unknown]                42739   64041  66.7% -lh5- 8f7d Apr  1 17:26 Chocolate/STRIFE/Setup.info
[unknown]                  450     906  49.7% -lh5- 1639 Apr  1 23:17 Chocolate/STRIFE/stdout.txt
[unknown]               444031  905924  49.0% -lh5- 5d84 Apr  1 23:17 Chocolate/STRIFE/STRIFE
[unknown]                  542    1973  27.5% -lh5- 72b8 Apr  1 23:17 Chocolate/STRIFE/strife.cfg
[unknown]                43604   58291  74.8% -lh5- f9c8 Apr  1 17:26 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]                  754    2863  26.3% -lh5- a9b8 Apr  1 23:17 Chocolate/STRIFE/chocolate-strife.cfg
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/STRIFE/music/place_ogg_or_wav_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/STRIFE/place_wad_files_here.txt
[unknown]               130468  305224  42.7% -lh5- 4783 Apr  1 23:17 Chocolate/STRIFE/Setup
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/HEXEN/music/place_ogg_or_wav_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/HEXEN/place_wad_files_here.txt
[unknown]               130468  305224  42.7% -lh5- 4783 Apr  1 23:17 Chocolate/HEXEN/Setup
[unknown]                42736   64040  66.7% -lh5- 8b08 Apr  1 17:18 Chocolate/HEXEN/Setup.info
[unknown]                  617    1321  46.7% -lh5- e1e7 Apr  1 17:39 Chocolate/HEXEN/stdout.txt
[unknown]                22123   58802  37.6% -lh5- 48d5 Mar  8 14:41 Chocolate/NEWS.txt
[unknown]               130468  305224  42.7% -lh5- 4783 Apr  1 23:17 Chocolate/HERETIC/Setup
[unknown]                42737   64042  66.7% -lh5- b614 Apr  1 17:32 Chocolate/HERETIC/Setup.info
[unknown]                   52      52 100.0% -lh0- bd8c Apr  1 17:38 Chocolate/HERETIC/stdout.txt
[unknown]                  811    3067  26.4% -lh5- a154 Apr  2 21:28 Chocolate/HEXEN/chocolate-hexen.cfg
[unknown]               465989  980920  47.5% -lh5- 808b Apr  1 23:17 Chocolate/HEXEN/HEXEN
[unknown]                  492    1770  27.8% -lh5- 6b65 Apr  1 17:39 Chocolate/HEXEN/hexen.cfg
[unknown]                39797   58121  68.5% -lh5- aca5 Apr  1 17:34 Chocolate/HEXEN/HEXEN.info
[unknown]                  324    1472  22.0% -lh5- 9afe Apr  1 17:38 Chocolate/HERETIC/heretic.cfg
[unknown]                  668    1085  61.6% -lh5- ac5c Apr  1 17:32 Chocolate/HERETIC/heretic.cfg.info
[unknown]                40074   57241  70.0% -lh5- 3cca Apr  1 17:32 Chocolate/HERETIC/HERETIC.info
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:42 Chocolate/HERETIC/music/place_ogg_or_wav_files_here.txt
[unknown]                    0       0 ****** -lh0- 0000 Mar 27 16:17 Chocolate/HERETIC/place_wad_files_here.txt
[unknown]              1897874 1897874 100.0% -lh0- 93fa Apr  3 20:35 Chocolate/ChocolateDOOM_src.zip
[unknown]                 1895    3833  49.4% -lh5- 24a9 Apr  6 10:26 Chocolate/Chocolate_DOOM.readme
[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]                  728    2707  26.9% -lh5- 3e0f Apr  2 21:27 Chocolate/HERETIC/chocolate-heretic.cfg
[unknown]               434254  878592  49.4% -lh5- 87a0 Apr  1 23:17 Chocolate/HERETIC/HERETIC
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        44 files 4589570 7378659  62.2%            Apr  6 04:05