Building Chocolate Doom on Linux (generic)

From Chocolate Doom
Jump to: navigation, search

These are generic build instructions for building Chocolate Doom on Linux.

GEBB cover.png For a good introductory guide to the Doom source code, check out the Doom Game Engine Black Book!

Setting up a build environment[edit]

Before Chocolate Doom can be built, a working build environment needs to be set up. The following packages need to be installed:

  1. gcc, the GNU C Compiler
  2. wget
  3. git
  4. Development libraries for the X Window system - may be called 'libx11-dev', 'x-devel' or similar.

The way to install these differs according to your distribution. On many systems these are standard components that are installed by default when you install the system. If not, you should install them using the package system for your distribution.

Build using chocpkg[edit]

Chocpkg is the recommended tool used to build Chocolate Doom.

From a terminal, first clone the chocpkg repository:

git clone

Then to build:

cd chocpkg
./chocpkg/chocpkg build chocolate-doom

or for the latest version from Git:

./chocpkg/chocpkg build chocolate-doom/latest

If build failures occur, it may be because of missing library dependencies. It's hard to give generic recommendations on how to resolve these as the solution depends on the Linux distribution. But if a required library is missing, check your system package manager to see if it is possible to install it; you may need to look for the "dev" or "devel" version of the package as well.