Radiant Level Design Tools

Installation

GtkRadiant supports Windows, Mac and Linux platforms. This is a guide to installing GtkRadiant 1.6 on these platforms.

Game Installation

On all platforms, GtkRadiant reads and writes game assets from within your game's directory. Before you start installing GtkRadiant, first make sure you have the game you want to edit for installed. GtkRadiant officially supports a number of different games. It is recommended to run a "clean" install: creating a separate installation of the game free of any third party custom content.

Windows

GtkRadiant 1.6 is packaged as a compressed zip file. Extract it somewhere on your system such as C:\GtkRadiant. Double-click on radiant.exe to start GtkRadiant, and be patient while the program initializes for the first time.

Some Windows users may find that they need to install the Visual C++ Redistributable for Visual Studio 2012. If you try to run GtkRadiant and you are getting an error message about missing .dll files, you will need to install this first. 32-bit users will need to download vcredist_x86.exe, 64-bit users will need to download both vcredist_x86.exe and vcredist_x64.exe.

Mac OS X

The Macintosh version of GtkRadiant relies on the Unix X11 system. For many OS X computers, X11 may already be installed with your operating system. It is recommended that you run a system update to make sure that you have the latest version. However if using OS X 10.8 (Mountain Lion) or later, Apple no longer packages X11 with the OS and is redirecting users to manually install X11 instead. The easiest way to do this is to download and install XQuartz, it is a simple .dmg file, just run it and follow the instructions.

GtkRadiant for Mac can be downloaded as a .dmg file. Just run the .dmg file and drag and drop the GtkRadiant.app to your Applications folder. Then double-click on GtkRadiant.app and wait for the program to initialize for the first time.

If using OS X 10.8 or later, you may have Gatekeeper enabled and you may receive the following message:

Gatekeeper

To override the Gatekeeper functionality for GtkRadiant, you can right-click on the GtkRadiant.app and select "Open", or follow the instructions here.

Linux

GtkRadiant for Linux comes in either 32 or 64-bit versions, make sure you download the right version for your system and extract it to the folder of your choice.

On some Linux distributions, GtkRadiant will require the installation of additional libs. You can get a list of libs that GtkRadiant requires by opening up a new Terminal session and typing in the following command:

ldd complete/path/to/GtkRadiant/radiant.bin

Once you know which libs are missing on your system, you can install them:

sudo apt-get install [missinglibname]

Here is a list of required libs for some distributions:

  • Ubuntu 10.10
    • libgtk2.0-0
    • libgtkglext1
    • libmhash2
    • zlib1g
    • zlibc
    • libpng12-0
    • libglib2.0-0
  • Ubuntu 12.04
    • In addition to the above, libjpeg62
  • Fedora
    • libxml2
    • glib2
    • gtk2
    • gtkglext-libs-1
    • mhash
    • libjpeg
    • zip
  • Open Linux (OS4)
    • None, should work as is.

Now that you have all the required dependencies installed, you can start running GtkRadiant. The executable is the file radiant.bin in your GtkRadiant folder.

  1. Open a terminal session in this folder (contextual menu "Open in Terminal" on most Linux systems).
  2. Launch the executable by drag-dropping it in the terminal window and then press the Enter key.

Optionally, you can create a bash script to make running GtkRadiant easier.

  1. Create a new text file and name it "radiant.sh".
  2. In this file, add the following lines:
    #!/bin/sh
    CompletePathToYourGtkRadiantFolder/radiant.bin
  3. Save the file.
  4. Make your script executable by typing the following in Terminal:
    chmod +x path/to/your/script/radiant.sh
  5. Double-click on the script and choose to execute it.
  6. Optionally, you can also add a menu shortcut to your applications menu by right-clicking on radiant.sh and choosing the appropriate menu option.

First Start

Starting GtkRadiant for the first time, the program needs to initialize and copy game-pack files to where you installed your game. You will see a dialog box.

Game setup dialog box

In the drop down menu, you will need to specify the game you are editing for. If more than one is required, just pick the first one to set up.

Then, tell GtkRadiant where you have the game installed. For most games, you will want to point the location to either the root of your game installation directory (eg. C:\Games\Quake3\). Click the OK button to proceed.

The game selection dialog now appears. Select the game you want to use or click on "Configure more games" to set up additional games. Click OK when done.

Game setup dialog box

You should now see the GtkRadiant main interface load up. Be sure to check though the preferences to set things up to your liking. For further reading, see the Documentation section for additional guides.