Compile
Currently, FreeOrion will compile in most recent Windows, Linux, and MacOSX. The *BSD genus of operating systems might also work; follow the Linux instructions in this case.
Contents
Overview
First of all, you will need to obtain the source. This can be grabbed from our project page or from Subversion (SVN). The versions available on the project page are official releases or point releases, and may be somewhat or very out of date. To help with programming FreeOrion, you will need to grab the SVN copy. Then you need to set up the required software, compile the game, download the missing artwork, and run it.
Hardware requirements
The FreeOrion code makes heavy use of templates, and requires much memory to compile; at least 1 GB of RAM is recommended.
On Linux, shutting down your X server and compiling from console may help on systems with little RAM. (If this doesn't mean anything to you, simply ignore this advice.)
You will also need a fast processor. Expect more than one hour for a first-time build on a 2 GHz processor (after building GG and any other necessary dependencies).
At least 2 GB of free disk space is also recommended.
Note that, while not required to compile FreeOrion, running the FreeOrion client requires a graphics card and drivers that support OpenGL 2.0.
Software requirements
Note: On Windows, most dependencies are available pre-compiled in the FreeOrion SDK.
- GiGi - Latest version from SourceForge SVN, will automatically be included in the FreeOrion/GG directory when checking out the FreeOrion Subversion archive
- Boost - version 1.42 (Other versions may also work)
- Ogre 3D - version 1.6.1 or later. 1.7 is known to work.
- Bullet - version 2.73
- FreeType2 - a GiGi dependency
- Python - version 2.4 or later (version 2.5 if using the FreeOrion Windows SDK) (version 2.x only; 3.x will not work)
- OpenAL and ALUT
- libogg - version 1.1.3
- libvorbis - version 1.1.2
- GraphViz - version 2.8 (version <2.22 on Linux)
- GLEW - (Windows only)
- zlib
- libpng
Getting the source
Subversion
The source code can be obtained from the sourceforge Subversion server, using this command from the Linux command prompt:
svn co https://freeorion.svn.sourceforge.net/svnroot/freeorion/trunk freeorion
For Windows, a graphical shell-extension SVN client, such as TortoiseSVN is recommended, with which the source can be obtained from https://freeorion.svn.sourceforge.net/svnroot/freeorion.
Alternatively, you can download the FreeOrion Windows SDK and update that directory tree with SVN.
Tarballs
The SourceForge Subversion web-client allows one to download numbered versions of the source code as a tarball.
The latest version can be obtained from the Download GNU tarball link on the bottom of this page: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/
You can also download source versions corresponding to previous releases:
FreeOrion v0.3.15
- FreeOrion v0.3.15 is FreeOrion SVN revision 3727: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3727 with GiGi SVN revision 813: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=813
FreeOrion v0.3.14
- FreeOrion v0.3.14 is FreeOrion SVN revision 3571: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3571 with GiGi SVN revision 812: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=812
FreeOrion v0.3.13
- FreeOrion v0.3.13
- On Windows is FreeOrion SVN revision 3094: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3094 with GiGi SVN revision 756: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=756
- On Linux is FreeOrion SVN revision 3103: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3103 with GiGi SVN revision 757: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=757
- On Mac OSX is FreeOrion SVN revision 3094: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3094 with GiGi SVN revision 757: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=757
FreeOrion v0.3.12.1 for Linux
- FreeOrion v0.3.12.1 for Linux is SVN revision 2918: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=2918 with GiGi revision 711: http://gigi.svn.sourceforge.net/viewvc/gigi/?pathrev=711
FreeOrion v0.3.12 for Windows
- FreeOrion v0.3.12 for Windows is SVN revision 2807: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=2807 with GiGi revision 710: http://gigi.svn.sourceforge.net/viewvc/gigi/?pathrev=710
FreeOrion v0.3.11
- FreeOrion v0.3.11
- On Windows is SVN revision 2729 http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/?pathrev=2729 with GiGi revision 695: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/GG/?pathrev=695
- On Linux is SVN revision 2732 http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/?pathrev=2732 with GiGi revision 695: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/GG/?pathrev=695
FreeOrion v0.3.10
- FreeOrion v0.3.10 is SVN revision 2607: http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/?pathrev=2607 with GiGi revision 651: http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/GG/?pathrev=651
Compilation
Compilation instructions and troubleshooting tips are available for the following operating systems: