q3rally/engine

Q3Rally engine

Q3Rally is a standalone game based on ioquake3.

There are enhancements and customizations to the engine. It is prefered to use Q3Rally engine instead of ioquake3 to run the game.

Engine changes compared to ioquake3:

• Added Theora video playback for the Q3Rally intro video
• Changed various cvar defaults
• Changed the fallback missing sound filename
• Modified mouse handling in menus
• Changed invalid default pk3 checksums to use sv_pure 0
• Added baseq3r pk3 checksums

(This list may be incomplete.)

Compiling

Q3Rally is compiled using GNU Make (make) from a terminal while in the engine directory.

make ARCH=x86, make ARCH=x86_64, make ARCH=arm64 (ARM64/Apple Silicon) specify compiling for a specific architecture instead of the host architecture. (Windows ARM64 is unsupported.)

Compiling Linux arm64 from a x86_64 host requires CC=aarch64-linux-gnu-gcc. Compiling for a different architechture than the host on Linux requires setting SDL_CFLAGS=... SDL_LIBS=... (see output of pkg-config sdl2 --cflags and --libs) with the paths to a build of SDL2 for that architechture.

If you have commit access and use an SSH key use git clone git@github.com:Q3Rally-Team/q3rally.git instead.

Windows

There is several ways to get an MinGW-w64 build environment.

MSYS2

1. Install MSYS2 with packages: git, make, mingw-w64-i686-gcc mingw-w64-x86_64-gcc
2. Open "MSYS2 MinGW 64-bit"
3. Get the Q3Rally source code with git clone https://github.com/Q3Rally-Team/q3rally.git
4. Change to the engine directory using cd q3rally/engine
5. Run make

Cygwin

This was more relevant before MSYS2 was made.

1. Install Cygwin with packages: git, make, mingw64-i686-gcc-core, mingw64-x86_64-gcc-core
2. Open "Cygwin"
3. Get the Q3Rally source code with git clone https://github.com/Q3Rally-Team/q3rally.git
4. Change to the engine directory using cd q3rally/engine
5. Run make

WSL

1. Install Windows Subsystem for Linux.
2. Install a Linux distribution from the Windows store (e.g., Ubuntu).
3. Open the start menu entry for the distribution (e.g., Ubuntu).
4. Install Git, Make, GCC, and MinGW-w64 packages, for Ubuntu run: sudo apt install git make gcc mingw-w64
5. Get the Q3Rally source code with git clone https://github.com/Q3Rally-Team/q3rally.git
6. Change to the engine directory using cd q3rally/engine
7. Run make PLATFORM=mingw32

It's possible to compile for Linux under WSL using make or ./make-linux-portable.sh. Compiling for macOS using osxcross is not supported under WSL as of writting.

Linux

1. Install git make gcc libsdl2-dev packages for your Linux distribution.
2. Get the Q3Rally source code with git clone https://github.com/Q3Rally-Team/q3rally.git
3. Change to the engine directory using cd q3rally/engine
4. Run make

To make a release which includes SDL2 run: ./make-linux-portable.sh x86_64 (also with x86).

make PLATFORM=mingw32 and make PLATFORM=darwin can be used to cross-compile for Windows and macOS from Linux, if mingw-w64 and osxcross are installed.

macOS

1. Install Xcode from the AppStore (the GUI is optional, only the command-line tools are required).
2. Open Terminal app.
3. Get the Q3Rally source code with git clone https://github.com/Q3Rally-Team/q3rally.git
4. Change to the engine directory using cd q3rally/engine
5. Run make

To create an AppBundle:

• Single architecture: ./make-macosx.sh x86_64 (if needed, replace x86_64 with arm64 (Apple Silicon), x86, or ppc).
• Modern macOS 10.9+ (Apple Silicon, x86_64): ./make-macosx-ub2.sh
• Legacy macOS 10.5+ (x86_64, x86, ppc): ./make-macosx-ub.sh

Modern AppBundle requires macOS 11.0 SDK or later to be installed. Legacy AppBundle must be compiled on macOS 10.6 with 10.5 and 10.6 SDKs installed.

Release builds

Assuming you have everything set up; release builds could be done like this.

clean is used to do a fresh build to be sure VERSION, etc from Makefile are applied to the build.

-j# is the number of CPUs thread to use. Set it to your CPU cores/threads for faster compiling.

# Windows; run on Windows or Linux with mingw-w64
make PLATFORM=mingw32 ARCH=x86 clean release -j8
make PLATFORM=mingw32 ARCH=x86_64 clean release -j8

# Linux; run on Linux or Windows (WSL)
./make-linux-portable.sh ARCH=x86 clean release -j8
./make-linux-portable.sh ARCH=x86_64 clean release -j8

# macOS Modern; run on macOS or Linux with osxcross
make PLATFORM=darwin ARCH=arm64 clean
make PLATFORM=darwin ARCH=x86_64 clean
./make-macosx-ub2.sh

# macOS Legacy: run on macOS 10.6
make PLATFORM=darwin ARCH=x86_64 clean
make PLATFORM=darwin ARCH=x86 clean
make PLATFORM=darwin ARCH=ppc clean
./make-macosx-ub.sh