Skip to content
Free (as in freedom) open source clone of the Age of Empires II engine 🚀
C++ Python CMake QML Makefile GLSL Other
Branch: master
Clone or download

Latest commit

TheJJ Merge pull request #1264 from simonsan/buildsystem/Bump-CMake-Version
Bump CMake version to 3.16, buildsystem update to Python search
Latest commit d890a60 May 19, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Dejavu Sans got renamed, updated CI Apr 21, 2020
assets Adding favicon for webpages to assets Nov 11, 2019
buildsystem buildsystem: bump cmake to 3.16 and search numpy with python3.cmake May 19, 2020
cfg Remember previous asset location Oct 25, 2017
dist dist: gaben is no longer the desktop icon Jul 29, 2018
doc buildsystem: bump cmake to 3.16 and search numpy with python3.cmake May 19, 2020
etc kevin: migration for new build host May 17, 2020
legal legal: re-wrote, added 3rd-party licenses Oct 30, 2014
libopenage mingw: Fix errors encoutered while building May 19, 2020
openage openage: pylint beautifications May 17, 2020
packaging Fix version stuff for Cpack Oct 4, 2019
.gitignore buildsystem: Update Python.cmake to use Python3.cmake for searching p… Apr 29, 2020
.mailmap mailmap: fix github-autocreated squash-commit mail address May 29, 2019
CMakeLists.txt buildsystem: bump cmake to 3.16 and search numpy with python3.cmake May 19, 2020
Makefile make: Add 'all' target. Jan 12, 2020 Spelling fixes, update docs, correct documentation. Nov 3, 2019 doc: changelog of openage engine development up to version [0.4.0]. Sep 6, 2019
configure buildsystem: Fix CXX aliases for different clang-versions May 2, 2020 Change the copyright year of Apr 29, 2020
kevinfile kevin: migration for new build host May 17, 2020
openage_version bump version to 0.4.0 Jun 27, 2019 buildsystem: move `` to build directory Feb 27, 2019


openage: a volunteer project to create a free engine clone of the Genie Engine used by Age of Empires, Age of Empires II (HD) and Star Wars: Galactic Battlegrounds, comparable to projects like OpenMW, OpenRA, OpenSAGE, OpenTTD and OpenRCT2. At the moment we focus our efforts on the integration of Age of Empires II, while being primarily aimed at POSIX platforms such as GNU/Linux.

openage uses the original game assets (such as sounds and graphics), but (for obvious reasons) doesn't ship them. To play, you require an original AoE II: TC or AoE II: HD installation (via Wine or Steam-Linux).

github stars #sfttech on Freenode #sfttech on quality badge


Contact Where?
Issue Tracker SFTtech/openage
Development Blog
Forum reddit /r/openage
Matrix Chat
IRC Chat #sfttech
Money Sink money sink

Technical foundation

Technology Component
C++17 Engine core
Python3 Scripting, media conversion, in-game console, code generation
Qt5 Graphical user interface
Cython Glue code
CMake Build system
OpenGL3.3 Rendering, shaders
SDL2 Cross-platform Audio/Input/Window handling
Opus Audio codec
nyan Content Configuration and Modding
Humans Mixing together all of the above


  • Fully authentic look and feel
    • This can only be approximated, since the behaviour of the original game is mostly undocumented, and guessing/experimenting can only get you this close
    • We will not implement useless artificial limitations (max 30 selectable units...)
  • Multiplayer (obviously)
  • Matchmaking and ranking with a haskell masterserver
  • Optionally, improvements over the original game
  • AI scripting in Python, you can use machine learning
  • Re-creating free game assets
  • An easily-moddable content format: nyan yet another notation
  • An integrated Python console and API, comparable to blender
  • Awesome infrastructure such as our own Kevin CI service

But beware, for sanity reasons:

  • No network compatibility with the original game. You really wanna have the same problems again?
  • No binary compatibility with the original game. A one-way script to convert maps/savegames/missions to openage is planned though.

Current State of the Project

Installation Packages

Supported Platforms: Linux, Windows 10, MacOS X 10.14

  • For Linux check at repology if your distribution has any packages available or here for any future updates on *.deb and AppImage packages.

  • For Windows check our release page for the latest installer or here for nightly builds.

    NOTE: If you have any problems starting conversion or starting openage take a look into the package instructions and our troubleshooting guide.

    NOTE: For MacOSX we currently don't have any packages.

Dependencies, Building and Running

Operating System Build status
Debian Sid Todo: Kevin #11
MacOSX 10.14 Build Status
Windows 10 - x64 Build status
  • How do I get this to run on my box?

  • I compiled everything. Now how do I run it?

    • Execute ./run.
    • The convert script will transform original assets into openage formats, which are a lot saner and more moddable.
    • Use your brain and react to the things you'll see.
  • Waaaaaah! It

    • segfaults
    • prints error messages I don't want to read
    • ate my dog

All of those are features, not bugs.

To turn them off, use ./run --dont-segfault --no-errors --dont-eat-dog.

If this still does not help, try our troubleshooting guide, the contact section or the bug tracker.


  • Being typical computer science students, we hate people.
  • Please don't contact us.
  • Nobody likes Age of Empires anyway.
  • None of you are interested in making openage more awesome anyway.
  • We don't want a community.
  • Don't even think about trying to help.


  • No bug reports or feature requests, the game is perfect as is.
  • Don't try to fix any bugs, see above.
  • Don't implement any features, your code is crap.
  • Don't even think about sending a pull request.
  • Please ignore the easy tasks that could just be done.
  • Absolutely never ever participate in this boring community.
  • Don't note the irony, you idiot.

To prevent accidental violation of one of those guidelines, you should never

Cheers, happy hecking.

Development Process

What does openage development look like in practice?

Can I help?

All documentation is also in this repo:

  • Code documentation is embedded in the sources for Doxygen (see doc readme).
  • Have a look at the doc directory. This folder tends to get outdated when code changes.


GNU GPLv3 or later; see and legal/GPLv3.

I know that probably nobody is ever gonna look at the file, but if you want to contribute code to openage, please take the time to skim through it and add yourself to the authors list.

You can’t perform that action at this time.