Radiant is the open source cross platform level editor for idTech games like Quake III Arena.

There are at least three competing versions out there:

• ☐ GtkRadiant build 1.6 (a continuation of GtkRadiant 1.4, maintained by TTimo);
• ☐ NetRadiant build 1.5 a continuation of the GtkRadiant 1.5, maintained by Xonotic);
• ☑ NetRadiant-custom build 1.5 (an early fork of NetRadiant, maintained by Garux).

(There are more versions, including DarkRadiant which actually ships in the Ubuntu universe.)

This repository contains build tools to build Debian/Ubuntu packages for NetRadiant-custom along with the q3map2 compiler and bspc bot file builder.

To get a glimpse of what NRC/nrcradiant can do, check out the features presentation.

In the releases section, you might find some precompiled debian packages... if you're lucky. But if there aren't any, building for your specific Debian derivative should be a breeze.

Using Docker:

./Dockerfile.build [ubuntu/jammy]

If the build succeeds, the built Debian packages are placed inside (a subdirectory of) Dockerfile.out/.

The files may look similar to these:

-     14,596  nrcradiant_1.5.0+20220528+1-0wjd1+ubu22.04_amd64.buildinfo
-      3,199  nrcradiant_1.5.0+20220528+1-0wjd1+ubu22.04_amd64.changes
-  4,935,336  nrcradiant_1.5.0+20220528+1-0wjd1+ubu22.04_amd64.deb
-      7,632  nrcradiant_1.5.0+20220528+1-0wjd1+ubu22.04.debian.tar.xz
-      1,305  nrcradiant_1.5.0+20220528+1-0wjd1+ubu22.04.dsc
- 85,897,202  nrcradiant_1.5.0+20220528+1.orig.tar.gz
- 64,066,598  nrcradiant-dbgsym_1.5.0+20220528+1-0wjd1+ubu22.04_amd64.ddeb
-  5,595,956  nrcradiant-game-quake3_1.5.0+20220528+1-0wjd1+ubu22.04_all.deb

The nrcradiant*.orig.tar.gz contains source files from multiple repositories. With SOURCE_VERSION files in the directories, recording the exact versions. (NOTE: For the gamepacks, exact versions might not be recorded.)

The nrcradiant*.deb holds files in:

- /usr/bin (nrcradiant)
- /usr/lib/x86_64-linux-gnu/nrcradiant (plugins/modules)
- /usr/lib/x86_64-linux-gnu/nrcradiant (also: mbspc, q2map, q3map2..)
- /usr/share/nrcradiant (arch independent data files, images)

The nrcradiant-game-quake3*.deb holds files in:

- /usr/share/nrcradiant/gamepacks/games/q3.game
- /usr/share/nrcradiant/gamepacks/q3.game (game data)

Starting should be a matter of running nrcradiant:

$ dpkg -L nrcradiant | grep ^/usr/bin/
/usr/bin/nrcradiant

Tools have been moved to the libdir, so they don't conflict with possible other radiant installs:

$ dpkg -L nrcradiant | grep '^/usr/lib/x86_64-linux-gnu/nrcradiant/[^/]*$'
/usr/lib/x86_64-linux-gnu/nrcradiant/h2data
/usr/lib/x86_64-linux-gnu/nrcradiant/mbspc
/usr/lib/x86_64-linux-gnu/nrcradiant/q2map
/usr/lib/x86_64-linux-gnu/nrcradiant/q3map2
/usr/lib/x86_64-linux-gnu/nrcradiant/qdata3

Game configuration will be stored in ~/.config/nrcradiant:

$ find ~/.config/nrcradiant -type f | sort
~/.config/nrcradiant/1.5.0/global.pref
~/.config/nrcradiant/1.5.0/prtview.ini
~/.config/nrcradiant/1.5.0/q3.game/local.pref
~/.config/nrcradiant/1.5.0/q3.game/shortcuts.ini
~/.config/nrcradiant/1.5.0/radiant.log

If you set paths as follows:

EnginePath = /usr/share/nrcradiant/gamepacks/q3.game/
ExtraResoucePath = ~/.q3a/  (yes, it's ExtraResourcePath withour 'r')

Then shader lists are scanned in this order (continues even when found):

/usr/share/nrcradiant/gamepacks/q3.game/baseq3/default_shaderlist.txt
/usr/share/nrcradiant/gamepacks/q3.game/baseq3/scripts/shaderlist.txt (read-write)
/usr/share/nrcradiant/gamepacks/q3.game/baseq3/scripts/shaderlist.txt
~/.q3a/baseq3/scripts/shaderlist.txt
~/.q3a/scripts/shaderlist.txt

And shader image locations are scanned in this order (stops when found):

~/.q3a/textures/common/watercaulk.jpg
~/.q3a/baseq3/textures/common/watercaulk.jpg
/usr/share/nrcradiant/gamepacks/q3.game/baseq3/textures/common/watercaulk.jpg
~/.q3a/textures/common/watercaulk.tga
~/.q3a/baseq3/textures/common/watercaulk.tga
/usr/share/nrcradiant/gamepacks/q3.game/baseq3/textures/common/watercaulk.tga

See README-quake3.rst for Quake3 specific setup.

• See if we can find an appropriate version better than 1.5.0+20220215+3.
• BUG: openat(AT_FDCWD, "/usr/share/nrcradiant/gamepacks/q3.game/baseq3/scripts/shaderlist.txt", O_WRONLY|O_CREAT|O_TRUNC, 0666) = -1 EACCES
• Document/decide on handling the gamepacks:
  • do we want to record source versions, we don't right now;
  • use quake3 instead of q3 for naming, because of better findability;
  • only put one game in a gamepack, we may want to manually create gamepacks: the gtkradiant versions contain more contents (example maps).
• Right now there is only a tiny index.html in /usr/share/nrcradiant/docs. We could move that to /usr/share/doc/nrcradiant.
• The nrcradiant-game-quake3 has plenty of docs in /usr/share/nrcradiant/gamepacks/q3.game/docs. Do we want to move that to /usr/share/doc/nrcradiant?