Repository files navigation

The fast-paced team-based outer-space multi-player arcade game. Blast your friends, zap your enemies. Steal their flags and nuke their cores. Customize your ship to be sneaky, or overwhelm with superior firepower. It's fast, fun, and frenetic.

Bitfighter has several common, open source dependencies:

• SDL2
• zlib
• libpng
• openal
• libvorbis
• libspeex
• libmodplug

These dependencies are provided for you on Windows and macOS.

On Linux, you must install them using your distribution's preferred method. On Ubuntu, for instance, you need to runsudo apt-get install cmake libphysfs-dev libsdl2-dev libopenal-dev libvorbis-dev libmodplug-dev libspeex-dev.

The CMake build system is used for compiling on Windows, macOS and Linux. You will need to download and install CMake 3.1+ for these platforms.

We have additional information on our wiki.

You will need the development headers of the above dependencies installed as well as the following software to compile:

• cmake
• make
• gcc / g++

Open a terminal at the base of this repository. Then run the following commands:

1. cd build/
2. cmake ..
3. make

To set up a debugging build do:cmake -DCMAKE_BUILD_TYPE=Debug ..

To build a dedicated server do:make bitfighterd

Bitfighter can be built with at least the following build systems:

• Visual Studio
• MingW/MSYS

To generate the proper project files with CMake, open a command prompt andcd into this repository'sbuild directory. Then type ONE of the following:

• cmake -G "Visual Studio 15 2017" ..
• cmake -G "Visual Studio 15 2017" -T "v141_xp" ..
• cmake -G "MSYS Makefiles" ..

To see a list of generators for CMake, see here:

http://www.cmake.org/cmake/help/v2.8.11/cmake.html#section_Generators

Different versions of Visual Studio are known to work, but you need to use thecorrect generator with CMake.

Start Visual Studio. Select Open Project, then navigate to thebuild folder, and open the bitfighter solution file.

Right-click on thebitfighter target and selectbuild to compile the game. This will take a few minutes the first time.

To run, click Debug > Start Debugging (or press F5).

After generating the MSYS makefiles, all you have to do is runmake to compile

Similar to Linux, but with some additional steps. In a shell, in thebuild directory, run:

• export MACOSX_DEPLOYMENT_TARGET=10.7
• cmake ..
• make Bitfighter

After runningmake, the bitfighter executable is put into the directoryexe/. Copy everything from theresources/ directory into theexe/ directory, keeping the folders intact (like sfx, scripts, etc.).

Bitfighter can now be run from theexe/ folder with no changes to your system.

Alternatively, you can do a full install directly into your system withsudo make install.

For distribution packaging, Bitfighter is built using the Open Build Service at:https://build.opensuse.org/package/show/games/bitfighter

Run the PACKAGE project in the Visual Studio project.

Alternatively, an NSIS build script is found in the following directory:build/windows/installer.

This will build a self-extracting installer for Bitfighter. You will need to build inRelease mode as the installer is looking for an executable namedbitfighter.exe.

Runmake package to build a distributable DMG.

If you are building off of themaster branch, then expect crashes and problems. Feel free to report them via the Issues tab, but consider joining the Discord and checking in the dev_irc channel to ask a developer about it- we probably are already aware.

If you are building off of a release version, please make sure you can consistently reproduce the problem, then post it, with the steps to reproduce, on the Issues tab.