Step Four: Mapping I


Next up is mapping. In this part, I'll explain how to install GtkRadiant and how to compile a map. For tutorials on how to actually do the mapping, look in the JKHub mapping tutorial section.



Firstly, download the XQuartz installer and run it. It will need an administrator password to install. This is required for running Radiant.

Next download MacRadiant. Drag the MacRadiant 1.4 application and the Goodies folder to somewhere on your hard disk. Now, MacRadiant was really meant for earlier versions of OS X, so there are a couple of workarounds needed.

Right- or control- click on the MacRadiant 1.4 application, and select Show Package Contents. Open the Contents folder and then the Resources folder. Inside is a file named script. Open this up in TextEdit.

script file

Delete the lines from

### Work around open-x11's problem with whitespace


export DISPLAY=`cat "$display"`

so that you're left with something like:


CWD="`dirname \"$0\"`"

#export PATH=./sw/bin:$PATH
#export LANG=fr
#export LC_ALL=fr_FR
export PATH=/usr/bin:/bin/:/usr/sbin:/sbin:/usr/X11R6/bin

ulimit -n 512

exec "$CWD/sw/radiant14/radiant"

Save script.

Now open up the Terminal application in /Applications/Utilities/. Type cd into the Terminal window, then a space, and drag your MacRadiant 1.4 application into the window. It should now read something like:

cd /SOMEWHERE/MacRadiant\

Hit enter. Copy-paste:

cd Contents/Resources/sw/lib/

and hit enter again.

You'll also want to do the following commands, hit enter after each command (or, if you've copy-pasted the whole block, you just need to enter after the last one)

mv libiconv.2.dylib libiconv.2.dylib.orig
ln -s /usr/lib/libiconv.dylib libiconv.2.dylib
mv libxml2.2.dylib libxml2.2.dylib.orig
ln -s /usr/lib/libxml2.2.dylib libxml2.2.dylib

If there are any error messages, check for typos.

That's enough messing around with the files inside the application for today. Download Packs Installer and launch the installer in the disk image.

Before running the installer, you may want Radiant to be able to access the second GameData equivalent folder for your version of the game. This involves using symbolic links.

Fire up Terminal again. If you have the Steam or are mapping for singleplayer with the disc version, type

ln -s /Users/*YOURUSERNAME*/Library/Application\ Support/Jedi\ Academy/ ~/.ja

and hit enter. If you're mainly mapping for multiplayer with the disc version, type

ln -s /Users/*YOURUSERNAME*/Library/Application\ Support/Jedi\ Academy\ MP/ ~/.ja

and hit enter. If you have the App Store version, type

ln -s /Users/*YOURUSERNAME*/Library/Containers/com.aspyr.jediacademy.appstore/Data/Library/Application\ Support/Jedi\ Academy/ ~/.ja

and hit enter. This step is very much optional!

Select all games that you want to install the mapping files for. For Jedi Academy, if you have the disc version, click on Location and select your Jedi Academy folder. If you have the Steam version, type the path to the folder containing the main base folder in the text box. For the Steam version that's

/Users/*YOURUSERNAME*/Library/Application Support/Steam/SteamApps/common/Jedi Academy/

Hit Go ahead…, and, if you're running the disc version or Steam version, you should be done! Your base folder should now look something like this:

Base folder

If you're using the App Store version it's a little more complicated because of permissions issues with the base folder.

One way around the issue is to first choose a location such as Desktop to install the pack to. Next, move the contents of the created base folder into the base folder at


so that your base folder looks as above. You might need to enter a password to authenticate this step.

Another way around is, if you've done the optional step above, to type

/Users/*YOURUSERNAME*/Library/Containers/com.aspyr.jediacademy.appstore/Data/Library/Application Support/Jedi Academy/

in the Location text box and hit Go ahead…. Your second base folder should contain the extra mapping files.

Packs Installer

Whichever method you chose with the App Store version, you'll now have to click (Re)install from scratch. Select the Jedi Academy pack again, and this time the path you should enter in the text box:


Hit Go ahead… again. You should finally be done. Note that your main base folder may look slightly different to the above image if some files have been installed to the secondary base folder. Check that all the files are in one of the base folders!


Open the MacRadiant 1.4 application. If it's the first time that you've used an application that requires XQuartz or X11, it might take a few minutes to sort out some font related stuff.

The Select Game window should come up. Select Jedi Academy, and hit OK.

Select Game

Congratulations, you've installed radiant!

Radiant worked!

You might want to change things like mouse settings now in Edit->Preferences….


Now go and make a little map, like a box with a light entity and spawn point. Take a look at the tutorials on JKHub if you're not sure how to do this.

Basic map

Save it as something like

Now do Bsp->Q3Map2: (test) BSP -meta, -vis, -light -fast -filter to compile your map. It shouldn't take too long!

BSP menu

Find the mymap.bsp file where you saved it, and move it to the maps folder inside your base folder. If you saved the .map in your base folder originally, or saved it in /Users/*YOURUSERNAME*/.ja/base/ after following the symbolic linking step above, it's already there!

Open up multiplayer, bring down the game console (shift and ~) and type in

sv_pure 0

Hit return. Now do

devmap mymap

Hit return again, and your map should load.

Basic map in-game

This article is my 8th oldest. It is 927 words long, and it’s got 0 comments for now.