Compiling

= Things you will need =

All Operating Systems

 * An Internet connection


 * An SVN Client


 * About 200MB free space

Windows

 * Microsoft DirectX SDK


 * MinGW (with PATH enviroment variable set, eg: C:\MinGW\bin )


 * MSys (can be installed with mingw-get, must be in a directory with no spaces in its path)

Linux/BSD

 * A Linux kernel 2.4 or higher.
 * The X Windows Server or the header files
 * OpenGL support and headers.
 * A current version of make.

Mac OS X

 * Admin access
 * XCode, which is available here or on the OS X installation disk.

= How to compile =

Get the source from SVN the repository is found at svn://svn.icculus.org/tremulous/trunk Most likely, you'll get the source by typing "svn co svn://svn.icculus.org/tremulous/trunk ."

Or from the Tremulous .zip package, which includes a file named tremulous-1.1.0-src.tar.gz. This is what you want.

If you don't want to compile the QVMs create a Makefile.local file that contains 'BUILD_GAME_QVM=0', otherwise add 'INCLUDE=' and 'LIBRARY=' (original fix). Add 'USE_CURL=1' if you want WWW redirection support.

Windows

 * 1) Move the files to the home directory of your MinGW Tree, or mount a remote location.
 * 2) Open MSys and change your current directory to the source location or the mount point of your checkout. (Use the "cd" command, followed by the directory. For example: cd waffle would move you to the "waffle" directory.)
 * 3) Run GNU Make using the "make" command.

Vista (x64)
Windows Vista x64 (and possibly Vista 32 bit as well) requires several fixes before it is able to compile Tremulous. Several MSYS files must first be replaced otherwise MSYS will spawn many windows before quitting. Download the files from here and replace the files in in your MSYS directory.

Due to new security changes in Vista the command prompt must be run with administrator privileges. Once the command prompt has been opened you should change to the directory in which msys.bat is located (default is C:\msys\1.0). Execute msys.bat from the command prompt.

Linux/BSD

 * 1) Change directory to the checkout location using the cd command (cd directory).
 * 2) Run the command make
 * If compiling for Win32 using MinGW32, use instead the cross-make-mingw.sh script, by executing ./cross-make-mingw.sh (you might have to make this executable first with chmod u+x cross-make-mingw.sh)
 * If you have built some components previously, it won't re-build those unless they've been modified since then. To reset the destination entirely, use make clean. This fixes sometimes-obscure linking issues.
 * 1) Your compiled binaries will be in build/buildtype-architecture/
 * For example, compiling on 64-bit linux might give you build/release-linux-x86_64/

Mac OS X

 * 1) Make sure XCode is installed.
 * 2) Open the terminal (/Applications/Utilities/Terminal.app)
 * 3) Enter cd X, where "X" is the location of your source code.
 * 4) Type "make install clean"

= Running the game =

If all has gone well you will find your executable under the directory "build/your-system-here/." Now go kill some aliens (or humans)!