mirror of
https://github.com/Q3Rally-Team/q3rally.git
synced 2024-11-24 12:51:54 +00:00
107 lines
4.6 KiB
Markdown
107 lines
4.6 KiB
Markdown
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
|
|
```
|