Welcome to Dynamite's Tutorial for installing GTK Radiant on Mac OSX

Many Thanks to David Still on a hosting plan from www.safetechs.com (for hosting the lost .info file) the MacRadiant community for their interest, help, tips, and to Redsaurus for hosting a forum and helping me on the hardest problems, as well as Bonesetter (who was here before me) and Macusernick for keeping up activity and of course to Qeradiant (www.qeradiant.com) for porting GtkRadiant to Mac at all, regardless of the lack of developpers!

also access this page by going to http://macinradiant.cjb.net (if that's not what you have done)

NEW: Anything to say about all this? go to the macradiant forum now! http://redsaurus.net/gtkradiant/

Radiant, a mapping program valid for a variety of games, has been developped for Windows, Linux and Mac. Unfortunately, it seems that the number of volunteers to develop Radiant for the Mac is not high enough to obtain a simple double-click installation. This installation in fact, involves a lot of tweaking strange files, installing strange applications, entering strange commands in the console and solving over-strange problems. As a matter of fact, this version of Radiant has been named "unstable".

"First make sure you understand what 'unstable' means. Packages in the unstable tree usually have not been tested by more than a few people." Fink's Webpage

Fink, one of the strange programs you will have to install if you "have the guts" to proceed... Nah, its not so terrible, but its a frustrating pain. And I am always happy to help anyway! I can proudly say that I am included in the list of "few people" who have tested this "unstable" package. And in my opinion, the only "unstable" part here is the installation, as the OSX Radiant program runs much faster than the pc version, and I am really happy with it!

I have helped already 3 or 4 persons to sort out their problems before writing this tutorial. The last, Pim, after almost 2 days (and 1 night, but I wasn't helping him during the night) of following my orders through an instant messenger, is now welcome to the list of the "few people"! So with this tutorial, I want to change the "few people" to "quite a nice bunch of Mac users!". You can visit the GTK Radiant Forum at MapCenter , there was a lot of mac stuff going on there (before the MacRadiant forum), and you'll find a lot of nice people. Long live Macs! WOHOO!

If you have any questions, think there is a mistake, Give me a shout at daniellasry@mi.madritel.es in msn or e-mail or go to http://redsaurus.net/gtkradiant/

Alright, supposing that you are ready, here starts the adventure!

First, let's gather what you need. Note that Radiant only works with Quake 3 and Return to Castle Wolfenstein, if you want to map for other games, check this out. If it doesn't work, you could copy the textures and models to Quake 3 or RTCW's base folders, but you will have to compile the map on a pc or on Virtual PC.

Mac OS X 10.3 Panther is required to install Radiant. If you do not have 10.3 or later, there is a big chance that you can encounter problems. If you do not know what version of OSX you have go to the little apple menu, "About This Mac".

aaaaaaaaaaaaaaaaaa

You will need quite some hard drive space, I recommend 3GB free.

You will need Developper tools, I highly recommend Xcode, from Apple because that's what I used and it works perfectly (you can also use GCC but alot of people are having very BLAAAÂÂÂÂÂÂHH problems with GCC) there are two ways of installing Xcode: If you have bought OSX Panther or if it came with your computer you should have an Extra CD labeled: "Developper Tools" Double click on the installer and install!

If you do not have the Developper Tools CD, Download Xcode from: Apple Developper Connection you will have to subscribe to ADC if you do not have an Apple ID. When you click on the download link, an FTP disk will appear on your desktop. Xcode is divided in parts so you can download part by part. You must copy every single part (and the installer) to a folder on your hard drive and then double-click on the installer, it should unstuff with Stuffit Expander. I think you need to unstuff all the parts by the way. It's a big download and it takes a lot of disk space when installed, but I *think* you can delete it once you have Radiant.

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

Next, you will need X11. It is possible that you already have this too (comes with the system if you have chosen to install it). You can check by going to /Applications/Utilities/ if there is no application there named X11, then you have to install it. You can find it in the Panther Disc 3 or download it at http://www.apple.com/macosx/x11/download/ .

Next, you need Fink. Download it at http://prdownloads.sourceforge.net/fink/Fink-0.7.0-Installer.dmg?download Double click on the installer package to install.

And finally, you MAY need the Tinker Tool http://www.versiontracker.com/dyn/moreinfo/macosx/11967 you don't need to do any fancy installation here.

X11 gives you a console. As Fink is a command-line program, it will run in X11. Now we need to tell fink that he must use "unstable" programs. This is quite simple: go to /sw/etc/ on your hard drive and open "fink.conf" with the application TextEdit (in your Applications folder). This is what you shoud see:

Look at the line that starts with "Trees:" the word "stable" is mentioned twice. You must replace that word with "unstable". You should get this:

Save the file and quit TextEdit.

The next step is upgrading "scons", if necessary. You must first check if you need to do it: open X11 located in /Applications/Utilities/ , a window named "xterm" should appear. If it does not, go to "Terminal" in the menu "Applications". In that window, you can type in commands and press enter (if ever X11 asks for a password, put in your login password and press enter even if you don't see the letters when you type). Now we are going to type a command to open the Fink application: type exactly: source /sw/bin/init.sh Don't forget the space between "source" and the rest. Press enter. Nothing should appear to happen or change. now type: fink list scons and press enter. You should see something SIMILAR to this:

As you can see, I have the last version (0.95) If you see another number that is not 0.95 or do not see any number at all, you need to upgrade scons and here's how: do not close X11, go to http://zerowing.idsoftware.com/osx/scons.info the file may just display on the browser's window instead of downloading itself so control-click on the text and do "Save Page". Save it on your desktop with the name "scons.info". Next, move that file to the directory /sw/fink/10.3/unstable/main/finkinfo/devel/ . In X11, type exactly: fink index . then fink update-all . It may download stuff, check some files... just let him do its job.

Now you need to do something similar with the file http://zerowing.idsoftware.com/osx/radiant-1.4.0-0.info (if you see that the hard disk is still down, download from here: http://david.safetechs.com/files/radiant-1.4.0-0.info Many thanks again to David Still and his hosting plan from www.safetechs.com) you must save it and move it to /sw/fink/dists/local/main/finkinfo/games/ , if the end of this path does not exist, create the necessary folders yourself. In X11 type : fink index and press enter.

I think this deserves a separation because the next part is so frustrating that you find yourself glued to your chair with one leg sticking out in a weird posture, your nails bitten up to the bone and you stare eternally at the sea of text, flooding your dear Mac's screen. And you look for a sign of life, just the word, "Radiant" or "GTK" or "quake3" or even "3D". But none of these wishes come true. Until, with a bit of luck, the completiton message appears...

Question: Why is the installation so long?

Answer: Because it has to compile the whole of Radiant (wich is a quite big 3D program) into a language that OSX can understand.

Question: Why do you say it's so frustrating?

Answer: Because there is a big risk of problems that may come out and the installation desn't seem to work at all... but surprisingly it does.

Anyway, enough bla, bla, BLA, BLAAÂÂÂÂÂAAH ... all you have to do it type: fink install radiant in X11 and you're in for hours and hours of text..."C'mon mate, just resist until the end!"

Oh great! Is this how it ends?.... NO sir!

This is hours of BLAAÂÂÂAAH... but when i mean hours, it's hours, 6, 7 or 8 rather...

Any problems, yes, I fear...

OK. problems:

At the beginning, you will be asked if you want to use (1) giflib: GIF image format handling library, LZW-enabled version (2) libungif: GIF image format handling library, LZW-free version then (1) python23: Interpreted, object-oriented language(2) python23-nox: Interpreted, object-oriented language. In both cases choose (1). If you see more choices like this, also choose (1).

At the beginning, you will notice that it will be downloading some files. It sometimes happens that one file fails to download. X11 should come up with a choice APROXIMATIVELY like this:

1)skip file

2)find another mirror

3)find another mirror in your country

Choose Find another mirror and continue.

Now this is a problem that comes out Almost Always, in wich you have to use the tinker tool. This message will appear, pausing the installation:

You have an existing X11 installation in /usr/X11R6 and/or /etc/X11.
This package refuses to overwrite these. Remove them, then tell Fink to
install xfree86 again. (The package won't be recompiled.) If you want
to keep your X11 installation, install system-xfree86 resp. system-xtools
instead to make this known to Fink's package system.
Press Return to continue.

what you must do: DO NOT QUIT X11. Press return to continue and dont touch X11. Open the tinker tool. Check the "Show Hidden and System Files" checkbox and click "Relaunch Finder".

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

On your hard disk you will see a folder named "usr". Open it. In there delete the whole folder named "X11R6"

On your hard disk you will see a folder named "etc". Open it. In there delete the whole folder named "X11"

In Tinker tool, uncheck "show hidden and Sytem files" and relaunch the finder.

Back to X11, type: fink install radiant again (if it says command not found type: source /sw/bin/init.sh and then fink install radiant) . The install should resume, overpassing the error.

VERY IMPORTANT: after doing this, if you close X11, to open it next time you will have to re-install the X11 application (only once).

You shouldnt come up with other problems until the installation finishes.

Congratulations, the horrible part is over!

Hurray!

OK. I'm not going to blablabla you again, here's what you must do next:

In X11 type sudo radiant-setup . If the command doesnt work type source /sw/bin/init.sh and then sudo radiant-setup.

If it still does not work, type /sw/games/radiant-setup/osx-radiant-1.4.0.run

Fink will start checking, a lot of points will come out

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

Radiant will ask the directory in wich you want to install Radiant. Choose whatever you like, choose the gamepacks you are going to use and click Begin Install.

NOTE: To avoid problems make sure Quake3 is installed in /Applications/Quake3/ and RTCW in /Applications/RTCW/

aaaaaaaaaaaa

Stuff will install quickly and radiant will start... ENJOY!

Fink different

To open back radiant next time there are two ways:

1) open X11 and type: source /sw/bin/init.sh
then type: radiant
2) go to the folder in wich you chose to install radiant and double-click the file named "radiant" with an icon like:

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

If you have any questions, think there is a mistake, Give me a shout at daniellasry@mi.madritel.es in msn or e-mail, or....

Check out the official Radiant webpage at www.qeradiant.com

NEW: Anything to say about all this? go to the macradiant forum now http://redsaurus.net/gtkradiant/