The Bitfighter source code
C++ C Lua Shell TeX Objective-C Other
Clone or download
raptor Merge remote-tracking branch 'origin/bitfighter-019x'
# Conflicts:
#	zap/CoreGame.cpp
#	zap/CoreGame.h
#	zap/UIMenuItems.cpp
#	zap/UIMenuItems.h
#	zap/teamInfo.cpp
#	zap/teamInfo.h
Latest commit 11f84fa Jul 9, 2018
Failed to load latest commit information.
alure Explicitly set CMake sub-projects to compile as static libs. This hel… Dec 31, 2015
bitfighter_test Merge branch 'bitfighter-019x'. Also replace other boost::shared_ptr … Mar 5, 2018
boost/boost Fix compile on vc++ 2013 Oct 18, 2013
build Merge remote-tracking branch 'origin/bitfighter-019x' Jun 2, 2018
doc Add some documentation Mar 12, 2017
lib Merge in mp3 support from 019x branch May 28, 2017
master Merge remote-tracking branch 'origin/bitfighter-019x' Mar 31, 2018
mysql++ OSX can use CMake to compile now. This is still primitive and doesn't… May 27, 2013
notifier Remove trailing spaces Apr 24, 2016
other Move dirent.h into its own directory so as to not conflict with addin… May 12, 2013
packaging/linux Install manpage in man6 which is games-specific Mar 11, 2017
poly2tri Fix warnings for travis build Apr 21, 2017
recast Fix warnings for travis build Apr 21, 2017
resource Add an example that would have been useful today May 1, 2017
tnl Merge branch 'bitfighter-019x' Jun 2, 2018
tomcrypt Fix tomcrypt build May 28, 2017
zap Merge remote-tracking branch 'origin/bitfighter-019x' Jul 9, 2018
.gitignore Add .gitignore to 019f branch Mar 11, 2017
.hgeol Line endings Oct 20, 2013
.travis.yml Copy travis files into branch Apr 24, 2017
LICENSE.txt Futureproof this baby! Mar 11, 2017
README.txt Integrate testing improvements from oskopek. Thanks!! Jan 21, 2014 Whitespace May 12, 2016 Copy travis files into branch Apr 24, 2017


Bitfighter README

   Many resources are found at:

   Most is still valid...   ;-)


   Bitfighter has several common, open source dependencies:
      * SDL
      * zlib
      * libpng
      * openal
      * libvorbis
      * libspeex
      * libmodplug

   These dependencies are provided for you on Windows and OSX.

   On Linux, you must install them using your distribution's preferred method.


   The CMake build system is used for compiling on Windows and Linux.  You
   will need to download and install CMake for these platforms.  
   On OSX, there is an Xcode project available.

 a) Linux

   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 and change to the 'build' directory within the extracted
   bitfighter sources.  Then run the following commands:

   1) cmake ..
   2) make

   To set up a debugging build do:  cmake -DCMAKE_BUILD_TYPE=Debug ..
   To build a dedicated server run 'make bitfighterd'.

   To build tests do: 'make test'. It will create a binary in 'exe/' called 'test'.
   Make sure to copy the resources over to 'exe/', as specified in step 3a), below.

 b) Windows

   Bitfighter can be built with at least the following build systems:
      * Visual Studio C++ IDE 
      * MingW/MSYS

   To generate the proper project files with CMake, go into the 'build' directory
   and type:
      * cmake -G "Visual Studio 10" ..
      * cmake -G "MSYS Makefiles" ..
   To see a list of generators for CMake, see here:
   Different versions of Visual Studio are known to work, but you need to use the
   correct generator with CMake.
   Microsoft Visual Studio:
   Start Visual C++.  Select Open Project, then navigate to the 'build' folder, 
   and open the bitfighter solution file.

   Right-click on the 'bitfighter' target and select 'build' to compile the game.  This 
   will take a few minutes the first time.

   To run:

   Click Debug > Start Debugging (or press F5) to run the game.

   MinGW / MSYS

   After generating the "MSYS Makefiles".  All you have to do is run 'make' to compile

 d) MacOS X (10.4 - 10.7)

   Bitfighter is built with the Xcode IDE.  The Xcode project is found in the directory:


   To compile, select 'Release' mode and build the Bitfighter target


 a) Linux

   There is no 'make install'.

   After running 'make', the bitfighter executable is put into the directory
   'exe/'.  Copy everything from the 'resources/' directory into the 'exe/'
   directory, keeping the folders intact (like sfx, scripts, etc.)

   Bitfighter can now be run from the 'exe/' folder.

   For distribution packaging, Bitfighter is built for a few distributions
   using the Open Build Service at:

 b) Windows

   An NSIS build script is found in the following directory:


   This will build a self-extracting installer for Bitfighter.  You will need to 
   build in 'Release' mode as the installer is looking for an executable named 

 c) MacOS X

   Run the target called "Create Bitfighter Game Release" to build a 
   distributable DMG.


   If you are building off of 'tip' then expect crashes and problems.
   Please don't report them via Google Code; instead join the IRC channel
   #bitfighter on freenode 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 at:

   For feature requests or similar, please post in the forums at:




   Come join us in the forums at:

   Enjoy Bitfighter!