Compiling The Engine

For Linux

If you are on Ubuntu or Debian, the easiest way to compile this the following:

$ sudo aptitude build-dep ioquake3
$ sudo apt-get install libsdl1.2-dev libxmp-dev libsdl2-dev
$ git clone git://github.com/q3shafe/trepidation.git
$ cd trepidation/trep-engine
$ make

For Windows: =

1. Install Cygwin Download the Cygwin setup package from http://cygwin.com/install.html.

Choose either the 32-bit or 64-bit environment. 32-bit will work fine on both 32 and 64 bit versions of Windows. The setup program is also your Cygwin environment updater. If you have an existing Cygwin environment, the setup program will, by default, update your existing packages.

Choose where you want to install Cygwin. The entire environment is self-contained in it's own folder, but you can also interact with files from outside the environment if you want to as well. The default install path is C:\Cygwin. Choose a mirror to download packages from, such as the kernel.org mirrors.

Choose a "storage area" for your package downloads.

2. Package selection The next screen you see will be the package selections screen. In the upper left is a search box. This is where you will want to search for the necessary packages.

These are the package names you'll want to search for:

mingw64-i686-gcc-core (For building 32bit binaries)
mingw64-i686-gcc-g++ (Also for 32bit... C++ support... not required for ioquake3, but useful for compiling other software)
mingw64-x86_64-gcc-core (For building 64bit binaries)
mingw64-x86_64-gcc-g++ (For 64bit, same as above)
make
bison
git

When you search for your packages you'll see category listings. These packages would all be under the 'Devel' category.

To select a package, change the 'Skip' to the version of the package you want to install. The first click will be the newest version and subsequent clicks will allow you to choose older versions of the package. In our case here, you're probably good choosing the latest and greatest.

3. Install packages After you have selected your packages, just hit 'Next' in the lower right. Cygwin will automatically add package dependencies. Hit next again to let the install run. Done.

The entire environment uses about 1GB of disk space (as opposed to about 6GB for a Visual Studio install).

4. Using Cygwin to check out and build the engine After the install has completed you should have a 'Cygwin Terminal' icon on your Desktop. This is the bash shell for Cygwin, so go ahead and run it.

At the command prompt type: git clone git://github.com/q3shafe/trepidation.git

This will download the trepidation master branch source into a new trepidation folder.

Change to the new trepidation engine folder that was created: cd trepidation/trep-engine

You can build trepidation for 32 or 64 bit Windows by running one of the following

make ARCH=x86 (32 bit)
make ARCH=x86_64 (64 bit)

After the build completes the output files will be in the 'build' folder. For the default Cygwin install the path it would be C:\Cygwin\home\Your_Username\ioq3\build\release-mingw32-arch.