Difference between revisions of "Building Bitfighter"

From Bitfighter
(Linux)
(Windows)
 
(180 intermediate revisions by 35 users not shown)
Line 1: Line 1:
=Windows=
+
{{TOC right}}
Bitfighter can be built with MS Visual C++ 2005 Express Edition, a free download from Microsoft.  Game builds with VC++ 2008, but causes odd runtime error when exiting.  Public compiled versions of the game will continue to be compiled on VC++ 2005 until that issue is worked out.
+
  
Currently investigating porting of Win compilation with MinGW, to make cross-platform maintenance easier.
+
This page is dedicated to getting Bitfighter to build on your system of choice.  Some useful links:
 +
*[https://github.com/bitfighter/bitfighter Browse source]
 +
*[https://github.com/bitfighter/bitfighter/commits/master Changelog]
  
MinGW progress:
+
Also, please see the README.txt included in the source.
  
Install mingw
+
===Source Code===
 +
Bitfighter has migrated to Git to manage the source code, on the GitHub website.  Here is some useful Git information:
 +
*[https://try.github.io Intro to Git]
 +
*[https://guides.github.com/activities/hello-world/ Simple GitHub usage]
 +
*[https://guides.github.com/ Other GitHub guides]
  
Edit various makefiles and ensure that compiler options are correct (i.e. comment/uncomment makefile lines according to the comments)
+
The Bitfighter code can be found here:
 +
*[https://github.com/bitfighter/bitfighter Source Checkout (Click 'Clone or download')]
  
use c:\MinGW\bin\mingw32-make
+
If you have Git installed, you can easily check out a copy of the source code by running this command in a terminal in a folder of your chosing:
 +
git clone https://github.com/bitfighter/bitfighter.git bitfighter
  
<ul>
+
After checking out the code, if you don't want to compile the current development version, you can update to a specific released version.  To see a list of released versions, type in:
<li>libtomcrypt builds
+
git tag
<li>tnl builds
+
<li>master builds
+
</ul>
+
  
The game itself is not compiling with MinGW, though the problem seems to be the new Lua supportI'm going to migrate from using Luna to LuaPlus, and see if that helps things. I'll update this page as appropriate.
+
We recommend to always chose the latest release as the build instructions for older releases will be different that what is shown here on this wiki pageUpdate to a release that you want:
 +
  git checkout bitfighter-019f
  
=Linux=
+
===Windows===
Bitfighter should build on any major flavor of Linux.  It has been tested and is known to work on Ubuntu and Centos. 
+
  
The Bitfighter client depends on Freeglut and the Lua development libraries. Freeglut is not needed to build a Bitfighter dedicated server (whithout client portions).
+
We have migrated to [CMake http://www.cmake.org/] for Windows builds in version 019 and later (and currently in the most recent development code). Note that we recommend using Visual Studio 2017 (though other versions will work) for the building environment on Windows. To build:
  
Bitfighter must be compile with the g++ compiler, which is not included in many Linux distributionsSVN is required to obtain the source code.
+
# Install CMake from http://www.cmake.org/
 +
# In a terminal, change to the 'build' directory in the bitfighter source code tree.
 +
# Run the following command (A list of CMake 'generators' for different build environments can be found [here http://www.cmake.org/cmake/help/v3.8/manual/cmake-generators.7.html#manual:cmake-generators(7)]): 
 +
#* '''cmake -G "Visual Studio 17 2022" -A x64 ..'''  # Substitute a different generator if you like
 +
#** To target Windows XP, add the proper toolset to the CMake command: '''cmake -G "Visual Studio 15 2017" -T "v141_xp" ..'''
 +
# Open the resulting Visual Studio solution file
 +
# To run and debug, you may need to right click "Bitfighter" in solution explorer, and choose "Set as StartUp Project"  (the active project is shown in bold text)
 +
# If the game starts, but you can't find the window, try running the debug build from the cmdline (in the exe folder) like this: '''bitfighter_debug.exe -window -winwidth 600 -winpos 4 28'''; then quit the game and it should run fine moving forwardThis is a rare issue.
  
To get the Bitfighter source, use SVN (check the repository for the latest version):
+
===Linux===
  
svn co https://zap.svn.sourceforge.net/svnroot/zap/release-012a bitfighter
+
====Detailed Instructions====
 +
Bitfighter should build on any major flavor of Linux.  It has been tested and is known to work on Ubuntu, LinuxMint, Centos, Fedora, Debian, Mandriva and openSUSE. If you can not get it to work, you can try running it in wine: [http://www.winehq.org/
  
 +
Bitfighter has several common, open source dependencies, which can be easily installed:
  
'''Building full game client on a clean install of Ubuntu'''
+
* sudo apt-get install cmake libphysfs-dev libsdl2-dev libopenal-dev libvorbis-dev libmodplug-dev libspeex-dev
sudo apt-get update
+
sudo apt-get install subversion
+
sudo apt-get install g++
+
sudo apt-get intall freeglut-dev
+
sudo apt-get liblua5.1-0
+
  
# Build the dedicated server (called bitfighterd)
+
You must install these '''and their development headers''' using your distribution's preferred method.  The development headers for these libraries have similar names with a suffix, for example:
cd bitfighter
+
* libvorbis-dev or vorbis-devel
make  # Standard build options should work
+
  
# Copy required files into exe folder:
 
cd exe
 
cp -r ../installer/levels .
 
cp -r ../installer/robots .
 
  
 +
You will also need the following to compile:
 +
* cmake version 3+ (sometimes called cmake3)
 +
* make
 +
* gcc / g++
  
 +
Once your dependencies are installed, you can build bitfighter with these steps:
 +
# cd build
 +
# cmake ..  [or cmake3 ..]
 +
# make
  
'''Building a dedicated server on a clean ServerHitch virtual server instance'''
+
If you want to build a dedicated server (with no GUI), replace the 'make' step above with:
yum -y --disableplugin=fastestmirror update
+
# make bitfighterd
yum -y --disableplugin=fastestmirror install subversion
+
yum -y --disableplugin=fastestmirror install gcc
+
yum -y --disableplugin=fastestmirror install gcc-c++
+
yum -y --disableplugin=fastestmirror install zip        # For archiving purposes
+
  
# Special steps are needed to get Lua:
+
Next, you'll need to copy the resources to where the executable was built:
# From http://wiki.centos.org/AdditionalResources/Repositories/RPMForge?action=show&redirect=Repositories%2FRPMForge
+
# cd ../exe
yum -y --disableplugin=fastestmirror install yum-priorities
+
# cp -r ../resource/* .
 +
 
 +
And if you wish to run in standalone mode, create a standalone.txt file in the 'exe' folder to trigger this mode:
 +
# touch standalone.txt
 +
 
 +
====Centos Dedicated Server Instructions (Easy!)====
 +
'''Building a dedicated server on a typical clean Centos 5 or 6 virtual server instance'''
 +
<nowiki>
 +
 
 +
# We recommend that you install and run a dedicated bitfighter server with a special
 +
# user account used only for this purpose, that does not have root access.
 +
 
 +
# First, create a bitfighter user; you can skip this step if you want to use an
 +
# existing account
 +
useradd bitfighter      # Create the account
 +
passwd bitfighter        # Set the password.  Pick a good one!
 +
 
 +
# Do the following as a user that has sudo privileges
 +
 
 +
sudo yum update    # system should be up to date
 +
 
 +
# The following sets up the EPEL repository for extra packages (needed for newer git)
 +
# Choose one based on your server architecture
 +
# 32 bit:
 +
sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
 +
# 64 bit:
 +
sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/x86_64/epel-release-5-4.noarch.rpm
 +
 
 +
sudo yum install git gcc gcc-c++ zip ncurses-devel readline-devel patch cmake3 screen
 +
 
 +
 
 +
# Do the following as the bitfighter user
 +
su bitfighter
 
cd ~
 
cd ~
wget http://apt.sw.be/redhat/el5/en/i386/RPMS.dag/rpmforge-release-0.3.6-1.el5.rf.i386.rpm
 
rpm -i rpmforge-release-0.3.6-1.el5.rf.*.rpm
 
  
yum -y --disableplugin=fastestmirror install lua-devel
+
# Get the source code -- this will create a folder called bitfighter in your
 +
# current location.  This may take a couple of minutes!
 +
git clone https://github.com/bitfighter/bitfighter.git bitfighter
  
# Get the source code
+
# Update to the tag/revision you want
svn co https://zap.svn.sourceforge.net/svnroot/zap/release-012a bitfighter
+
cd bitfighter
 +
git checkout bitfighter-019f
  
 
# Build the dedicated server (called bitfighterd)
 
# Build the dedicated server (called bitfighterd)
cd bitfighter
+
cd build
make dedicated LUALIB=/usr/lib/liblua.a   # Lua libs are given non-standard name
+
cmake3 ..          # Creates a Makefile for the next step; may emit warnings
 +
make bitfighterd
 +
 
 +
# Copy required files into exe folder (found at the root of the code tree):
 +
cd ../exe
 +
cp -r ../resource/* .
 +
touch standalone.txt   # Tell bitfighterd to run in portable mode (don't skip this!!)
 +
</nowiki>
 +
 
 +
===OS X===
 +
 
 +
We have migrated to CMake for OS X as well.  You must have the following software installed (in addition to the bitfighter source code):
 +
# CMake
 +
# XCode (includes development libraries and compilers)
 +
 
 +
To build:
 +
# Open a terminal
 +
# Set up the compatibility environment by running:
 +
#* export MACOSX_DEPLOYMENT_TARGET=10.6
 +
# change into the 'build' directory within the Bitfighter source
 +
# Run CMake:
 +
#* cmake ..
 +
# Build with 'make':
 +
#* make Bitfighter
 +
# The .app will be built in the 'exe' sub-folder of the main bitfighter source directory
  
 +
Building with XCode is supported with CMake, but it is untested with Bitfighter.  To do so:
 +
# Open a terminal
 +
# Set up the compatibility environment by running:
 +
#* export MACOSX_DEPLOYMENT_TARGET=10.6
 +
# change into the 'build' directory within the Bitfighter source
 +
# Run CMake using the Xcode generator:
 +
#* cmake -G Xcode ..
 +
# This will create an Xcode project within the 'build' directory that you can open
  
# Copy required files into exe folder:
 
cd exe
 
cp -r ../installer/levels .
 
cp -r ../installer/robots .
 
  
=OS X=
+
====Notes====
Version 009 builds on OS X.  Subsequent work (Lua integration) may have broken this, needs further testing.
+
# Bitfighter user settings are found in $HOME/Library/Application Support/Bitfighter

Latest revision as of 02:37, 9 January 2023

This page is dedicated to getting Bitfighter to build on your system of choice. Some useful links:

Also, please see the README.txt included in the source.

Source Code

Bitfighter has migrated to Git to manage the source code, on the GitHub website. Here is some useful Git information:

The Bitfighter code can be found here:

If you have Git installed, you can easily check out a copy of the source code by running this command in a terminal in a folder of your chosing:

git clone https://github.com/bitfighter/bitfighter.git bitfighter

After checking out the code, if you don't want to compile the current development version, you can update to a specific released version. To see a list of released versions, type in:

git tag

We recommend to always chose the latest release as the build instructions for older releases will be different that what is shown here on this wiki page. Update to a release that you want:

git checkout bitfighter-019f

Windows

We have migrated to [CMake http://www.cmake.org/] for Windows builds in version 019 and later (and currently in the most recent development code). Note that we recommend using Visual Studio 2017 (though other versions will work) for the building environment on Windows. To build:

  1. Install CMake from http://www.cmake.org/
  2. In a terminal, change to the 'build' directory in the bitfighter source code tree.
  3. Run the following command (A list of CMake 'generators' for different build environments can be found [here http://www.cmake.org/cmake/help/v3.8/manual/cmake-generators.7.html#manual:cmake-generators(7)]):
    • cmake -G "Visual Studio 17 2022" -A x64 .. # Substitute a different generator if you like
      • To target Windows XP, add the proper toolset to the CMake command: cmake -G "Visual Studio 15 2017" -T "v141_xp" ..
  4. Open the resulting Visual Studio solution file
  5. To run and debug, you may need to right click "Bitfighter" in solution explorer, and choose "Set as StartUp Project" (the active project is shown in bold text)
  6. If the game starts, but you can't find the window, try running the debug build from the cmdline (in the exe folder) like this: bitfighter_debug.exe -window -winwidth 600 -winpos 4 28; then quit the game and it should run fine moving forward. This is a rare issue.

Linux

Detailed Instructions

Bitfighter should build on any major flavor of Linux. It has been tested and is known to work on Ubuntu, LinuxMint, Centos, Fedora, Debian, Mandriva and openSUSE. If you can not get it to work, you can try running it in wine: [1]

Bitfighter has several common, open source dependencies, which can be easily installed:

  • sudo apt-get install cmake libphysfs-dev libsdl2-dev libopenal-dev libvorbis-dev libmodplug-dev libspeex-dev

You must install these and their development headers using your distribution's preferred method. The development headers for these libraries have similar names with a suffix, for example:

  • libvorbis-dev or vorbis-devel


You will also need the following to compile:

  • cmake version 3+ (sometimes called cmake3)
  • make
  • gcc / g++

Once your dependencies are installed, you can build bitfighter with these steps:

  1. cd build
  2. cmake .. [or cmake3 ..]
  3. make

If you want to build a dedicated server (with no GUI), replace the 'make' step above with:

  1. make bitfighterd

Next, you'll need to copy the resources to where the executable was built:

  1. cd ../exe
  2. cp -r ../resource/* .

And if you wish to run in standalone mode, create a standalone.txt file in the 'exe' folder to trigger this mode:

  1. touch standalone.txt

Centos Dedicated Server Instructions (Easy!)

Building a dedicated server on a typical clean Centos 5 or 6 virtual server instance


# We recommend that you install and run a dedicated bitfighter server with a special 
# user account used only for this purpose, that does not have root access.

# First, create a bitfighter user; you can skip this step if you want to use an 
# existing account
useradd bitfighter       # Create the account
passwd bitfighter        # Set the password.  Pick a good one!

# Do the following as a user that has sudo privileges

sudo yum update    # system should be up to date

# The following sets up the EPEL repository for extra packages (needed for newer git)
# Choose one based on your server architecture
# 32 bit:
sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
# 64 bit:
sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/x86_64/epel-release-5-4.noarch.rpm

sudo yum install git gcc gcc-c++ zip ncurses-devel readline-devel patch cmake3 screen


# Do the following as the bitfighter user
su bitfighter
cd ~

# Get the source code -- this will create a folder called bitfighter in your 
# current location.  This may take a couple of minutes!
git clone https://github.com/bitfighter/bitfighter.git bitfighter

# Update to the tag/revision you want
cd bitfighter
git checkout bitfighter-019f

# Build the dedicated server (called bitfighterd)
cd build
cmake3 ..          # Creates a Makefile for the next step; may emit warnings
make bitfighterd

# Copy required files into exe folder (found at the root of the code tree):
cd ../exe
cp -r ../resource/* .
touch standalone.txt   # Tell bitfighterd to run in portable mode (don't skip this!!)

OS X

We have migrated to CMake for OS X as well. You must have the following software installed (in addition to the bitfighter source code):

  1. CMake
  2. XCode (includes development libraries and compilers)

To build:

  1. Open a terminal
  2. Set up the compatibility environment by running:
    • export MACOSX_DEPLOYMENT_TARGET=10.6
  3. change into the 'build' directory within the Bitfighter source
  4. Run CMake:
    • cmake ..
  5. Build with 'make':
    • make Bitfighter
  6. The .app will be built in the 'exe' sub-folder of the main bitfighter source directory

Building with XCode is supported with CMake, but it is untested with Bitfighter. To do so:

  1. Open a terminal
  2. Set up the compatibility environment by running:
    • export MACOSX_DEPLOYMENT_TARGET=10.6
  3. change into the 'build' directory within the Bitfighter source
  4. Run CMake using the Xcode generator:
    • cmake -G Xcode ..
  5. This will create an Xcode project within the 'build' directory that you can open


Notes

  1. Bitfighter user settings are found in $HOME/Library/Application Support/Bitfighter