144 lines
5.2 KiB
Text
144 lines
5.2 KiB
Text
|
|
Chocolate Doom installation
|
|
===========================
|
|
|
|
These are instructions for how to install Chocolate Doom on Unix-like
|
|
Operating Systems.
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
Chocolate Doom requires the following to be installed:
|
|
|
|
* A C compiler (gcc is recommended)
|
|
* make (GNU make is recommended)
|
|
* LibSDL (see http://www.libsdl.org/)
|
|
* SDL_mixer (see http://www.libsdl.org/projects/SDL_mixer/)
|
|
* SDL_net (see http://www.libsdl.org/projects/SDL_net/)
|
|
* Python (optional)
|
|
|
|
Building Chocolate Doom
|
|
-----------------------
|
|
|
|
On a Unix system, follow the standard instructions for installing an
|
|
autotools-based package:
|
|
|
|
1. Run './configure' to initialize the package.
|
|
2. Run 'make' to compile the package.
|
|
3. Run 'make install' to install the package.
|
|
|
|
Advanced topics such as cross-compilation are beyond the scope of this
|
|
document. Please see the GNU autoconf / automake documentation for more
|
|
information.
|
|
|
|
Installing an IWAD file
|
|
-----------------------
|
|
|
|
To play Doom, an IWAD file is needed. This contains the Doom game data. The
|
|
file usually has one of the following filenames:
|
|
|
|
doom1.wad (Shareware Doom)
|
|
doom.wad (Registered / Ultimate Doom)
|
|
doom2.wad (Doom 2)
|
|
tnt.wad (Final Doom: TNT: Evilution)
|
|
plutonia.wad (Final Doom: Plutonia Experiment)
|
|
|
|
When you have this file (see the next section, "Obtaining an IWAD file", for
|
|
how to get this file), install it through one of the following methods:
|
|
|
|
* Put the file into the /usr/share/games/doom or
|
|
/usr/local/share/games/doom directories.
|
|
* Install it into a directory and set the environment variable DOOMWADDIR to
|
|
be the path to that directory.
|
|
* Install multiple IWADs into separate directories and set the environment
|
|
variable DOOMWADPATH to be a colon-separated list of directories to search
|
|
(similar to the Unix PATH environment variable).
|
|
* Run Chocolate Doom with the '-iwad' command line parameter to specify the
|
|
IWAD file to use, eg.
|
|
|
|
chocolate-doom -iwad /root/doom2.wad
|
|
|
|
Obtaining an IWAD file
|
|
----------------------
|
|
|
|
Obtaining the IWAD file may be a complicated process under Unix. The method
|
|
depends on how you obtained your copy of the game:
|
|
|
|
* There have been several CD-based versions of Doom. Generally, the IWAD
|
|
files can be found on the CD and copied off directly.
|
|
|
|
* The IWAD files may not be directly available on the CD. Look for a program
|
|
named "deice.exe". In the same directory, there should be a single large
|
|
file with a numbered extension (eg. "resource.1"); to extract this, follow
|
|
the same instructions as for the floppy disk version (see below).
|
|
|
|
* If you have the floppy disk version of Doom, first copy the contents of all
|
|
the floppy disks into a directory together. You will have several large
|
|
files with numbered extensions. Concatenate these into a single file, eg.
|
|
|
|
cat doom_se.1 doom_se.2 doom_se.3 doom_se.4 doom_se.5 > doom_se.exe
|
|
|
|
The resulting file is self-extracting LHA file. If you have a DOS emulator
|
|
(such as DOSbox), you can run it to extract the files; alternatively, you
|
|
can use the Unix LHA tool to extract the archive.
|
|
|
|
* The Doom games are also available for download on Steam
|
|
(http://www.steampowered.com/). To find the IWAD files, look in your Steam
|
|
directory, under the "steamapps/common" path.
|
|
|
|
Playing with Chex Quest
|
|
-----------------------
|
|
|
|
Chex Quest is a game based on Doom with some minor modifications that was
|
|
distributed with boxes of Chex cereal in 1997. It is possible to play
|
|
Chex Quest using Chocolate Doom. To do this, the following files are
|
|
needed:
|
|
|
|
* The IWAD file 'chex.wad', from the Chex Quest CD.
|
|
* The dehacked patch 'chex.deh', which can be found in the /idgames
|
|
repository in utils/exe_edit/patches/chexdeh.zip.
|
|
|
|
Copy these files into a directory together and use the '-iwad' command
|
|
line parameter to specify the Chex Quest IWAD file:
|
|
|
|
chocolate-doom -iwad chex.wad
|
|
|
|
Installing upgrades
|
|
-------------------
|
|
|
|
Chocolate Doom requires a Doom 1.9 IWAD file. Generally, if you install a
|
|
recent version of Doom you should automatically have a 1.9 IWAD. However, if
|
|
you are installing from a very old CD version or from floppy disks, you might
|
|
find you have an older version.
|
|
|
|
The most obvious symptom of an out of date IWAD file is that the game will
|
|
exit at the title screen before the demo starts, with the message "Demo is
|
|
from a different game version!". If this happens, your IWAD file is out of
|
|
date and you need to upgrade.
|
|
|
|
Id Software released upgrade patches that will update your game to 1.9. The
|
|
following sites have the patches:
|
|
|
|
http://www.doomworld.com/files/patches.shtml
|
|
http://www.doom2.net/doom2/utils.html
|
|
ftp://ftp.idsoftware.com/idstuff/doom2
|
|
|
|
As the patches are binary patches that run as DOS executables, you will
|
|
need a DOS emulator (such as DOSBox) to install them.
|
|
|
|
Music support
|
|
-------------
|
|
|
|
Support for Doom's MIDI music is available through timidity:
|
|
|
|
http://timidity.sourceforge.net/
|
|
|
|
A good set of patches for Timidity is the eawpats collection, which can
|
|
be found here:
|
|
|
|
http://www.doomworld.com/idgames/index.php?id=13928
|
|
(Doom idgames archive, /sounds/eawpats.zip)
|
|
|
|
If compiling from source, be sure to compile and install timidity
|
|
before installing SDL_mixer.
|
|
|