Tree [a15bc6] master build1790 /

File Date Author Commit
 attic 2013-07-14 danij danij [c8fda0] Cleanup: Moved masterxml2xhtml.xsl to the attic
 distrib 2 days ago Jaakko Keränen Jaakko Keränen [5378d5] Documentation: libdoomsday is a major part of t...
 doomsday 9 hours ago Jaakko Keränen Jaakko Keränen [a15bc6] Documentation|Cleanup: Fixed some Doxygen warnings
 packs 2008-06-25 danij danij [ae5067] jDoom64: Big update to the IWAD (doom64.wad) re...
 snowberry 2015-05-15 Jaakko Keränen Jaakko Keränen [906e8e] Snowberry: All WAD addons except hexdd.wad are ...
 web 12 hours ago Jaakko Keränen Jaakko Keränen [2040d1] Homepage|Forums: Fixed post attachments and pol...
 .gitignore 2015-05-24 Jaakko Keränen Jaakko Keränen [63b67f] Git: Updated ignored files
 .gitmodules 2014-04-28 Jaakko Keränen Jaakko Keränen [e4f5da] Git: Added Open Asset Import Library as a Git s... 2015-06-06 Jaakko Keränen Jaakko Keränen [fdf57d] Git: Updated repository readme regarding Assimp

Read Me

Doomsday Engine

This is the source code for Doomsday Engine: a portable, enhanced source port of id Software's Doom I/II and Raven Software's Heretic and Hexen. The sources are under the GNU General Public license (see doomsday/gpl-3.0.txt), with the exception of the Doomsday 2 libraries that are under the GNU Lesser General Public License (see doomsday/lgpl-3.0.txt).

For compilation instructions and other details, see the documentation wiki:


libcore is the core of Doomsday 2. It is a C++ class framework containing functionality such as the file system, plugin loading, Doomsday Script, network communications, and generic data structures. Almost everything relies or will rely on this core library.

liblegacy is a collection of C language routines extracted from the old Doomsday 1 code base. Its purpose is to (eventually) act as a C wrapper for libcore. (Game plugins are mostly in C.)

libgui builds on libcore to add low-level GUI capabilities such as OpenGL graphics, fonts, images, and input devices.

libappfw contains the Doomsday UI framework: widgets, generic dialogs, abstract data models. libappfw is built on libgui and libcore.

libshell has functionality related to connecting to and controlling Doomsday servers remotely.

External Dependencies


Doomsday is compiled using CMake. Version 3.1 or later is required.


Using the latest version of Qt 5 is recommended. The minimum required version is Qt 4.8. See Supported platforms in the wiki for details about which version is being used on which platform.

Open Asset Import Library

libgui requires the Open Asset Import Library for reading 3D model and animation files. It is compiled automatically as part of the build and is expected to be present as a Git submodule in doomsday/external/assimp. Source tarballs come with the Assimp sources included.


SDL 2 is needed for game controller input (e.g., joysticks and gamepads). Additionally, SDL2_mixer can be used for audio output (not required).


The optional FMOD audio plugin requires the FMOD Ex Programmer's API.


The following branches are currently active in the repository.

  • master: Main code base. This is where releases are made from on a biweekly basis. Bug fixing is done in this branch, while larger development efforts occur in separate work branches.
  • stable: Latest stable release. Patch releases can be made from this branch when necessary.
  • stable-x.y: Stable release x.y.
  • legacy: Old stable code base. Currently at the 1.8.6 release.