Source code repository of the FreeOrion project.
Dilvish-fo Fix formatting in warn statement
- mismatched number of parameters was causing an exception
Latest commit 0ef9926 Sep 23, 2018
Failed to load latest commit information.
.github Update template for release management issue May 21, 2018
AI Move FleetMoveOrder wrapper function into AIWrapper.cpp Jul 22, 2018
Empire Make the default diplomatic status be war rather than peace Jun 17, 2018
GG Use future boost::gil 1.68 IO extensions instead of homegrown hack Aug 23, 2018
Installer Define config option group - video Dec 11, 2017
UI Clean up unused player status. Sep 15, 2018
Xcode Remove superceded Xcode/ Dec 6, 2017
check Format CMake files matching upstream Mar 19, 2017
client Ignore color from history for system messages. Jul 29, 2018
cmake Fixed compilation of required boost DLLs for NSIS installer package Sep 3, 2018
combat Fix argument order for some combat related visibility calls Jun 10, 2018
default Fix formatting in warn statement Sep 23, 2018
doc Generate brief doc from first comment sentence Jul 7, 2018
msvc2015 Add ConfigWrapper.cpp to MSVC2015 project Sep 9, 2018
msvc2017 Add ConfigWrapper.cpp to MSVC 2017 server and ai client projects, to … Sep 16, 2018
network Clean up unused player status. Sep 15, 2018
parse grooming Sep 9, 2018
python Use preprocessor defines to provide both camelCase and snake_case Pyt… Sep 9, 2018
server Don't set any roles when return to lobby. Sep 19, 2018
test Grooming. Jun 20, 2018
universe trivial grooming Sep 16, 2018
util Use boost::uuids for game UID when loading old savegame Sep 14, 2018
.gitattributes Add .gitattributes to enforce eol style Mar 26, 2015
.gitignore Add incremental build files to gitignore Sep 19, 2018
.travis.yml Upgrade travis pytest version to 3.6.3 Jul 7, 2018 Update required clang version on FreeBSD Jun 29, 2018
CMakeLists.txt Merge pull request #2214 from jbeich/boost Jul 14, 2018 Add build instructions manual Apr 15, 2018 Fixed year number of 0.4.8 release date in changelog Aug 31, 2018
FreeOrion.ico Fixed up FreeOrion.ico to have multiple resolutions (256x256, 48x48, … Apr 23, 2010 Add build instructions manual Apr 15, 2018
appveyor.yml Use Visual Studio 2017 with the v140_xp toolset on AppVeyor CI Jun 6, 2018
freeorion.desktop Requested tweaks to desktop file. Jun 10, 2013


FreeOrion is a free, Open Source, turn-based space empire and galactic conquest computer game.

FreeOrion is inspired by the tradition of the Master of Orion games, but does not try to be a clone or remake of that series or any other game. It builds on the classic 4X (eXplore, eXpand, eXploit and eXterminate) model.

By adding scripting capabilities to the game engine the FreeOrion project aims to give the community an easy way to customize the game mechanics and presentation to create a living, breathing universe in a grand campaign model.


FreeOrion requires an OpenGL 2.1 capable graphic card and a display with a minimum resolution of at least 800x600.

FreeOrion requires at least Windows XP with Service Pack 2 or later, Mac OSX 10.9 or later or any reasonably recent Linux distribution on x86 compatible processors. Other operating systems and architectures have reported to be working by users, but are not actively supported by the FreeOrion project.


FreeOrion Stable Releases are the recommended way to play FreeOrion. Stable Releases can be obtained as native installer binaries for Windows and Mac OSX or as source releases for Linux and other UNIX-ish platforms from GitHub.

Also some Linux distributions like Fedora, Debian and Arch do provide packages of FreeOrion.

FreeOrion Weekly Releases are in-development releases intended for enthusiasts and testers, who want to track or contribute to the development. Weekly Releases can be obtained as native installer binaries for Windows and Mac OSX from Sourceforge.


For Windows execute the native installer binary and follow the on-screen instructions of the installer to install FreeOrion.

For Mac OSX, open the downloaded DMG file and copy the contained FreeOrion application to your system Applications folder by Drag and Drop.

For Linux or other from-source installations in general please refer to the Build Instructions.

Various Linux distributions provide the stable release of FreeOrion in a prebuilt way. Usually you can install those packages by either using a graphical package manager and searching for FreeOrion or by installing the packages via the command line.


  • install directory
    The location of this file, called <install_dir> below.
  • config - game settings
    Called <config_dir> below.
    • linux
      $XDG_CONFIG_HOME/freeorion which defaults to ~/.config/freeorion
    • OSX
      $HOME/Library/Application Support/FreeOrion/ which defaults to ~/Library/Application Support/FreeOrion/
    • Windows
  • data - local user data, saved games, log files
    Called <data_dir> below.
    • linux
      $XDG_DATA_HOME/freeorion which defaults to ~/.config/freeorion
    • OSX
      $HOME/Library/Application Support/FreeOrion/ which defaults to ~/Library/Application Support/FreeOrion/
    • Windows
  • resource directory - audio, visual and textual UI content, python scripts
    Called <resource_dir> below.
    <resource_dir> can be redirected in <config_dir>/config.xml or <config_dir>/persistent_config.xml
  • stringtables - translation indices for various languages
  • scripting - FreeOrion Content Scripts (FOCS) describing game content (tech, species etc.)
  • AI - AI for computer controlled empires

Contact and Getting Help

Visit the FreeOrion Homepage to learn more about the project. Also you can get in touch with the FreeOrion developers and join the community in the FreeOrion Forum.


The FreeOrion project encourages anybody to contribute to FreeOrion. For more details please see the Contribution Guidelines.


The FreeOrion source code is licensed under the terms of GPL v2, game assets are licensed under the terms of CC-BY-SA-3.0 and game content scripts are licensed under the terms of both GPL v2 and CC-BY-SA-3.0. For more details please see the License File.

Additional to the immediate project sources, the FreeOrion source tree bundles some third party projects or assets which may be also licensed under different terms than the FreeOrion project. For more details please consult the accompanying license file.

  • GiGi library located within the GG/ directory.
  • Roboto font located within the default/data/fonts/ directory.
  • DejaVuSans located within the default/data/fonts/ directory.