Doom

Playing Classic Doom on Funtoo

A big upgrade to Funtoo's Doom-playing ability has been merged into `next`!

This page will document how to use it.

Quickstart

Environment variables

Set DOOMWADPATH in `~/.bashrc` like

 DOOMWADPATH="/usr/share/doom:${HOME}/.local/share/games/doom/wads:${DOOMWADPATH}"

This variable determines the default location that other Doom software will look for game data.

Don't forget to refresh your environment after changing your ~/.bashrc.

Singleplayer

Fix USE flags for sda2-mixer by adding to `/etc/portage/package.use/doom`:

 media-libs/sdl2-mixer midi timidity

Install packages

 $ emerge -v doomrunner gzdoom freedoom-data

Start DoomRunner

Configure the engines

1. Add engine by clicking the '+' icon
2. Navigate in the file picker to `/usr/bin/gzdoom` (or type it in the text field)

Configure search paths

1. maps: set it to `/usr/share/doom` or `~/.local/share/games/doom/maps`, wherever you will put your maps. Ebuilds that install maps put them in `/usr/share/doom`, so that's a good choice if you don't have any yourself yet.
2. mods: set it to `~/.local/share/games/doom/mods`

Close the initial config window.

Configure a profile for single player

1. Create preset: Rename "Default" to "GZDoom singleplayer"
2. Select engine: gzdoom
3. Select IWAD: Pick whichever game you intend to play.
4. Select map pack: Leave this alone unless you downloaded maps.
5. Select config (optional): Leave this alone.
6. Add mods: Leave this alone unless you have mods to play.

Start the game!

Multiplayer

Fix USE flags for sda2-mixer by adding to `/etc/portage/package.use/doom`:

 media-libs/sdl2-mixer midi timidity

Copy your IWAD file(s) to `/usr/share/doom`. It is rare to find a Freedoom server, so you will need a commercial DOOM2.WAD file.

Install packages

 $ emerge -v odamex

Fix timidity

 $ eselect timidity set freepats

Find a game to play. Join it with

 $ odamex +connect doom.funtoo.org

Set DOOMWADPATH in `~/.bashrc` like

 DOOMWADPATH="/usr/share/doom:${HOME}/.local/share/games/doom/wads:${DOOMWADPATH}"

Ignore the wxWidgets messages and optionally uncheck the box to continue showing them. They are a BUG and should be reported and fixed.

Choose a game from the list and begin playing.

Source ports

• games-engines/gzdoom: Good for playing single player.
• games-engines/odamex: Preferred for multiplayer; enables an Online Doom Advanced Multiplayer EXperience.

Game data

Doom data files are organized inside a type of archive called a WAD (pronounced like the word "wad") file. The term 'WAD' is an acronym representing "Where's All [the] Data?".

In order to play Doom with a Doom source port, a WAD file for the internal game data, called an IWAD, is required. Commercial IWADs for the original Doom games come with modern Doom games; so it's possible you have one already. See https://doomwiki.org/wiki/IWAD for reference.

Another way to acquire Classic Doom IWADs is to purchase them directly from Steam or GOG.

• The original Doom from 1993, containing four episodes each with eight maps: https://www.gog.com/en/game/doom_1993
• Doom II: https://www.gog.com/en/game/doom_ii

Most current-day maps and mods are based on the Doom II IWAD.

Doom source ports can be played without commercial IWADs by using Freedoom.

• https://freedoom.org
• games-fps/freedoom-data

Ebuilds that install free IWADs place them in `/usr/share/doom`. It is a good idea to place commercial IWADs there, too.

Maps

The commercial and free IWADs come with a lot of great maps. In addition, the community has been making Doom maps and mods for almost thirty years.

A selection of community-produced maps are available in Funtoo's tree. It is easy to add them, and Doom resources traditionally are distributed freely; so more can be made available directly in Funtoo upon request.

Eviternity was created as a 25th birthday gift to Doom and was released on Doom's 25th release anniversary. It's sequel, Eviternity II, coincided with Doom's 30th birthday.

• games-fps/eviternity
• games-fps/eviternity-ii

It is a good idea to put maps in their own directory, like `~/.local/share/games/doom/maps`. Ebuilds that install maps will add them to `/usr/share/doom`; this may change in the future to `/usr/share/games/doom/maps`.

Mods

Mods differ from maps in that they make use of features in a particular source port, rather than simply changing the game's internal data, or building something with components contained within it.

Most mods seem to work with GZDoom, so if you're interested in a particular mod, it's not a bad idea to start there.

One popular mod that introduces many modern game elements is Brutal Doom: https://www.moddb.com/mods/brutal-doom

DoomRunner

DoomRunner is a launcher that makes it easy to set up profiles for combinations of the various source ports, IWADs/PWADs, and mods. DoomRunner generates command line arguments for the source port, starts it, and offers a way to kill it if it misbehaves.

DoomRunner allows to configure profiles for different game modes, something that is very useful for playing single player games with a source port like GZDoom that sets everything from command line arguments.

• games-util/doomrunner

Configuring DoomRunner involves first organizing your files into directories that make it easy to find your files. The recommended setup looks like this, with files stored in subdirectories under `~/.local/share/games/doom`:

 $ ls ~/.local/share/games/doom
 maps
 mods

Various Doom-related ebuilds place files in `/usr/share/doom`

 $ ls /usr/share/doom

Multiplayer

Note: It is strongly recommended that you ensure that you can play Doom in a single-player mode with your chosen source port before attempting to play multiplayer.

Odamex is the preferred multiplayer engine. It is very easy to get started with Odamex on Funtoo.

With Odamex

A few methods exist:

Join a game directly from the command line, as with GZDoom, if you know the host to which you want to connect:

 $ odamex +connect doom.example.org

Use `odalaunch`, the Odamex Launcher, to find a game; ignore the warnings from wxWidgets:

 $ odalaunch

Or browse the available games at https://odamex.net/servers, choose one to join, and use its host:port combination as the argument to `odamex +connect`.

Operating a server

Useful resources:

• https://odamex.net/wiki/Server_variables

Master servers

Odamex master servers listen on `15000/udp` and maintain lists of the servers that are up and running, including information like how many players are logged in. Server operators should set a few relevant variables in the `odasrv` config file that affect the server's appearance in the list.

The master server can be installed by setting `USE="master"` and re-installing `games-engines/odamex`.

Optionally using Docker

• Use `boxer` to build a simple Funtoo docker container from a stage3
• Use that container as a base image and install `odamex` with `USE="server"`
• Save the container as a new image
• Use `slim-toolkit` to minify the odasrv container
• Sample `docker-compose.yaml`:
• Execute like `docker compose up -d`

Don't forget to open the relevant ports on your firewall.

• `10666/udp` is the listening port
• `15000/udp` is used as an outgoing port to contact master servers

With GZDoom

It is possible to play small multiplayer games with GZDoom, e.g. on a local network with 2-4 players. Problematically, if one player disconnects, they can never rejoin the game again unless everyone else quits and starts over.

Music

Note: To make the MIDI music work in various sourceports, it is necessary to set USE="midi timidity" for `media-libs/sdl2-mixer`. Then remember to run `eselect timidity set 1`. The ebuild for `games-engines/odamex` will require this condition to be true.

Alternative soundfonts exist for Timidity. A great one that is freely available is `8MBGSFX`, obtainable from https://www.doomworld.com/idgames/utils/sound_edit/8mbgmpat. It works easily with a few steps:

• Extract the contents to `/usr/share/tinidity/8mbgsfx`.
• Change all the filenames to lowercase; they seem to come from a case-insensitive Windows system.
• Edit `/usr/share/timidity/8mbgsfx/timidity.cfg` and change the `dir` path to the right place on a Funtoo machine.
• From `/usr/share/timidity`:

 $ sudo rm current
 $ sudo ln -sf /usr/share/timidity/8mbgsfx current

TODO: need to make an autogen for it to perform that procedure automatically