GtkRadiant 1.2

How to install GtkRadiant 1.2 for use with Tremulous in Windows 32.

Getting GtkRadiant

GtkRadiant 1.2 is available for download from the Files section of qeradiant.com.

The newest version available is 1.2.13 for which you will need to download both the 1.2.11 installer and the 1.2.13 patch. These files are available from the following links:

• GtkRadiantSetup-1.2.11-All.exe - qeradiant.com mirrors
• GtkRadiantSetup-1.2.11-All.exe - FileFront mirrors
• GtkRadiantSetup-1.2.11-All.exe - FilePlanet (free membership required)

• GtkRadiantSetup-1.2.13-update.exe - qeradiant.com mirrors
• GtkRadiantSetup-1.2.13-update.exe - FileFront
• GtkRadiantSetup-1.2.13-update.exe - FilePlanet (free membership required)

Installing the editor

Open GtkRadiantSetup-1.2.11-All.exe and follow the instructions. You may install GtkRadiant anywhere you choose. Default paths may be left for all games. At the Setup Type screen choose Custom. Uncheck every game you do not wish GtkRadiant to support including Quake III Arena. Continue on until installation completes.

Then open GtkRadiantSetup-1.2.13-update.exe and direct it to install into the same directory as 1.2.11. Default paths may be used again for all games. Once again select Custom from the Setup Type screen. Uncheck unneeded games (once again including Quake III Arena). Continue until installation completes.

Setting up the editor

For the purposes of this guide we will assume that you have installed Tremulous to a directory named tremulous/ (Example: c:/games/tremulous/) and that you have installed GtkRadiant to a directory named GtkRadiant/ (Example: c:/Program Files/GtkRadiant/).

The ".game" file

Once you have GtkRadiant 1.2 installed you will need to add a game file for Tremulous. In your GtkRadiant/games directory create a text document named trem.game. This contents of this file should be as follows:

An example file can be downloaded here.

The project file

The project file contains a number of important paths as well as compiler command-lines. This file belongs in your tremulous/base/scripts/ directory. Create this directory if it does not already exist. Inside this directory create a text document with the extention .qe4. Example: tremulous.qe4 (NOTE: If you name your project file quakev3.qe4 you can avoid having to select a project file on first run as this is the default project file name)

This contents of this file should be as follows:

An example file can be downloaded here.

Common files

Because GtkRadiant does not natively support Tremulous, there are a number of necessary files missing. These files can be downloaded in a zip file here or here.

This zip file contains:

• entities.def: Entity definition file with all the tremulous specific entities.
• common-spog.pk3: Contains all the editor images for the common shaders.
• common.shader: All the common shaders, caulk, nonsolid, nodraw, etc.
• shaderlist.txt: Lists all the shaders to be loaded by the editor and q3map2.

Extract this archive to tremulous/base/.

If everything is in the right place you should find common-spog.pk3 in tremulous/base/. The rest of the files, entities.def', common.shader and shaderlist.txt, should be in tremulous/base/scripts/.

Running & configuring the editor

Upon running the editor for the first time you should be confronted by a window asking you to select a game. If you have performed the steps in The ".game" File correctly then you should be able to select Tremulous from the drop-list. Optionally check off Auto load selected game on startup to avoid seeing this window again on each successive run. Click OK to continue.

Unless you have named your project file quakev3.qe4, the next window you see will be a small error dialog alerting you that GtkRadiant can not find the default project file. Click OK and in the following window point to the project file you created in "<path to tremulous>/base/scripts/".

After this step you should see GtkRadiant briefly open and then crash. Some versions of Windows will create an Error Report dialog when this happens. This report can be safely left unsent.

Run GtkRadiant again. If you did not select Auto load selected game on startup you will once again be asked to select a game. Tremulous should still be selected. Click OK. This time GtkRadiant should run successfully and stay open.

From here you can modify program settings by selecting Preferences from the Edit menu or by simply pressing P.

At this point you should be able to begin mapping using the textures included with the default Tremulous maps.