This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.

Compiling: Difference between revisions

From BZFlagWiki
Jump to navigation Jump to search
← Older edit
TJ13820 (talk | contribs)
8 edits
Zehra (talk | contribs)
988 edits
we got official documentation covering it
 
(36 intermediate revisions by 12 users not shown)
Line 1: Line 1:
==Overview==
BZFlag is well supported on 3 major operating systems. (Please consult with other platform specific readme's, if available, otherwise consult general build instructions.)
Compiling BZFlag is the act of taking the raw source codes for the game and using tools to build an executable application(s) for a target system.


==Source Code==
{|{{Prettytable}}
In order to compile a user must have his or her own copy of the [[BZFlag_Source|Source Code]]. The code can be obtained from a source archive from the [[Download]] page, or from the [[BZFlag_SVN]] server.
|-
| {{Hl3}} |'''Operating System:'''
|-
| [https://www.bzflag.org/documentation/developer/compiling/windows/ Windows]
|-
| [https://www.bzflag.org/documentation/developer/compiling/linux/ Linux]
|-
| [https://www.bzflag.org/documentation/developer/compiling/macos/ macOS]
|-
|}


==Readme Files==
=Compiling Misc:=
Users should always read the README files for the appropriate operating system. These files are located in the root directory of the source code tree.
==Simple plugin compiling==
Simple bash script which can sometimes simplify writing very basic plugins.


==Compilers==
'''plugin.sh'''
BZFlag is capable of being built on a number of compilers. The compiler used will depend in some way on the operating system of the computer doing the build.
#!/bin/bash
compiler="g++"
options="-I "
headers="/path/to/bzflag/include"
options2="-fPIC -shared -o"
$compiler $options $headers $options2 $1.so $1.cpp
Compile a plugin with:
./plugin.sh myPlugin.cpp


Linux computers, use the GCC compiler.
==Simple [[Modeltool|modeltool]] compiling==
Macintosh Computers use the XCode compiler
This usual covers building modeltool on recent releases:
Windows Computers can use the Visual C++ compiler, or the MinGW compiler (based on GCC)
g++ -o modeltool modeltool.cxx -include SimpleTextUtils.h model.h wavefrontOBJ.h Q3BSP.h Q3BSP.cxx wavefrontOBJ.cxx SimpleTextUtils.cxx
 
===GCC===
The GCC build as a number of requirements;
* Automake X.XX
* Autoconf X.XX
* Autotools X.XX
* SDL Development libraries 1.2.10 or greater
* OpenGL Development libraries 1.1 or greater
 
If the required dependencies are installed, the user must then run the following commands from at root level of the source tree
 
  ./autogen.sh
  ./configure
  make
  make install
 
Please note that depending on permissions levels the '''make install''' command may need to be run as an administrator or root.
 
===XCode===
Launch XCode and open the '''bzflag/BZFlag.xcodeproj''' project. Note that XCode should have '''BZFlag''' selected as the active target and '''Development''' as the active build configuration. Click on '''Targets''' then click the '''Build''' icon. When this process completes, your application will be in '''bzflag/build/Development'''. You can then move it wherever you like.
 
===Visual C++===
 
==== 2.0.x ====
Requires
Visual Studio .net 2003
Visual Studio .net 2005
Visual C++ Express 2003 (With extra packages for dependencies)
 
Microsoft Direct X SDK for April 2007
WIndows Server 2003 System SDK
 
==== 2.99.x =====
Requires
Visual Studio 2008
Open the readme in the source file for information on Libraries and SDK's
 
===Other build systems===
Other build systems may be supported in the various readme files (minGW, IRIX, SOLARIS,etc..)




Latest revision as of 02:07, 10 November 2025

BZFlag is well supported on 3 major operating systems. (Please consult with other platform specific readme's, if available, otherwise consult general build instructions.)

Operating System:
Windows
Linux
macOS

Compiling Misc:

Simple plugin compiling

Simple bash script which can sometimes simplify writing very basic plugins.

plugin.sh 

#!/bin/bash
compiler="g++"
options="-I "
headers="/path/to/bzflag/include"
options2="-fPIC -shared -o"
$compiler $options $headers $options2 $1.so $1.cpp

Compile a plugin with: 

./plugin.sh myPlugin.cpp

Simple modeltool compiling

This usual covers building modeltool on recent releases: 

g++ -o modeltool modeltool.cxx -include SimpleTextUtils.h model.h wavefrontOBJ.h Q3BSP.h Q3BSP.cxx wavefrontOBJ.cxx SimpleTextUtils.cxx
Retrieved from "https://wiki.bzflag.org/index.php?title=Compiling&oldid=9760"