One of the biggest problems for newcomers who want to contribute code to free software projects is that they have no idea where to start.
Reading, understanding and finding the relevant code part is hard.
This file explains the modular structure of the project.
The overall architecture describes the conceptual overview.
We use Python, Cython and C++.
| Extension | Language | Usage |
|---|---|---|
.py |
Python | Everything that does not crunch data |
.pyx .pxd |
Cython | Fast Python code, glue between C/C++ and Python |
.h .cpp |
C++ | Data crunching code: simulation, graphics, sound, ... |
Each folder in the root of the project contains fundamentally different contents. This ensures separation of components and defines the base structure of the project.
Game assets required at run time are placed in here. This includes everything
that is converted from the original assets (see asset conversion)
and other input like shaders etc. The directory is assets for local builds or
installed to /usr/share/openage/assets or whatever the platform recommends.
Buildsystem components, namely cmake scripts and configuration
templates, are placed in this folder. This includes scripts for test
integration, python module definition, source file gathering and
executable definitions are placed in this directory.
The code compliance checker also lives here.
Contains the standard configuration of the engine, e.g. keybindings.
Files for package distribution.
In the doc/ folder is conceptual documentation, ideas, algorithms, etc.
The code itself is commented with /** doxygen comments */.
See doc/README.md for documentation guidelines.
Additional resources for development tools, e.g. pylint and valgrind configs.
Our license (GPLv3+) and licenses of other projects' components that are integrated into openage.
Source files written in C++20 live here. All engine components, data structures and C++ tests are located in this folder, each subsystem resides in its own subfolder.
Contains the Python3 auxiliary components of openage. Python3 is used for non-data-crunching tasks, like converting original assets, scripting and modding.
The main entry point for openage is in __main__.py.
CMake script for creating a package for distribution.