DarkRadiant is a level (map) editor for the The Dark Mod, an open-source Doom 3 modification which is available at www.thedarkmod.com. It's primary use is creating missions for The Dark Mod as well as maps for idTech4-based games like Doom 3, Quake 4 and Prey.
Get the latest DarkRadiant binaries from the releases page. We have binaries for Windows and macOS, plus compilation instructions for various Linux distributions.
DarkRadiant requires game resources to work with, these resources are not installed by this editor. You'll need to point DarkRadiant to one of these games (The Dark Mod, Doom 3, Quake 4, etc.) before you can start to work on your map. Visit www.thedarkmod.com for download instructions, then proceed with one of the tutorials available on the web.
For The Dark Mod mappers, there's an extensive Beginner's Guide on the project's wiki, which covers a lot of steps almost from scratch. Moreover, a couple of excellent video tutorials are available, linked from the top of that wiki article above.
DarkRadiant is built on Windows using Microsoft Visual Studio, the free Community Edition can be obtained here:
VC++ 2019: https://visualstudio.microsoft.com/downloads/ (Choose Visual Studio Community)
When installing Studio please make sure to enable the "Desktop Development with C++" workload.
Since DarkRadiant uses a couple of open-source libraries that are not available on Windows by default, you will also need to download and install the dependencies. A 7-Zip package containing the necessary files is available at the URL below (Get 7-zip here):
https://github.com/codereader/DarkRadiant/releases/download/2.10.0/windeps.7z
The dependencies packages need to be extracted into the main DarkRadiant
source directory, i.e. alongside the include/
and radiant/
directories.
Just drop the windeps.7z in the DarkRadiant folder and use 7-zip's "Extract to here"
The main Visual C++ solution file is located in:
tools/msvc/DarkRadiant.sln
Open this file with Visual Studio and start a build by right-clicking on the top-level
"Solution 'DarkRadiant'" item and choosing Build Solution. The DarkRadiant.exe file will be
placed into the install/
folder.
To compile DarkRadiant, a number of libraries (with development headers) and a standards-compliant C++17 compiler are required. On an Ubuntu system, the requirements may include any or all of the following packages:
- zlib1g-dev
- libjpeg-dev
- libwxgtk3.0-dev
- libxml2-dev
- libsigc++-2.0-dev
- libpng-dev
- libftgl-dev
- libglew-dev
- libalut-dev
- libvorbis-dev
- libgtest-dev
This does not include core development tools such as g++ or the git client to download the sources (use sudo apt-get install git for that). One possible set of packages might be:
sudo apt-get install git cmake g++ gettext pkg-config
More required package lists for various Linux distributions are listed in the Wiki Article.
To build DarkRadiant the standard CMake build process is used:
cmake .
make
sudo make install
To install somewhere other than the default of /usr/local
, use the CMAKE_INSTALL_PREFIX
variable.
cmake -DCMAKE_INSTALL_PREFIX=/opt/darkradiant
make
sudo make install
Other useful variables are CMAKE_BUILD_TYPE
to choose Debug or Release builds, ENABLE_DM_PLUGINS
to disable the building of Dark Mod specific plugins (enabled by default), and ENABLE_RELOCATION
to control whether DarkRadiant uses hard-coded absolute paths like /usr/lib
or paths relative to the binary (useful for certain package formats like Snappy or FlatPak).
To compile DarkRadiant, a number of libraries (with development headers) are required. You can obtain them by using MacPorts:
Install MacPorts, then open a fresh console and issue these commands:
sudo port install jpeg wxwidgets-3.0 pkgconfig libsigcxx2 freetype ftgl glew
sudo port install boost libxml2 freealut libvorbis libogg openal
Start Xcode and open the project file in tools/xcode/DarkRadiant.xcodeproj
.
Hit CMD-B to start the build, the output files will be placed to a folder
similar to this:
~/Library/Developer/Xcode/DerivedData/DarkRadiant-somethingsomething/Build/Products/Release
The DarkRadiant.app
package in that folder can be launched right away or
copied to some location of your preference.
A more detailed compilation guide can be found on The Dark Mod's wiki:
https://wiki.thedarkmod.com/index.php?title=DarkRadiant_-_Compilation_Guide
DarkRadiant Website: https://www.darkradiant.net
All discussion is ongoing primarily at The Dark Mod Forums, where you can get in touch with knowledgeable people and discuss changes or issues. If you happen to run into a bug, you're encouraged to report it to us, especially when running into application crashes (see also How to record a crashdump).
The issue tracker for DarkRadiant is also run by the Dark Mod folks: DarkRadiant Bugtracker.
The DarkRadiant source code is published under the GNU General Public License 2.0 (GPLv2), except for a few libraries which are using the BSD license, see the LICENSE file for further notes.