Ekosystem

Ekosystem is a C++ 3D "game" focused around simulating a simple data-driven ecosystem of animals.

It is built using suprengine, my custom engine which uses OpenGL and SDL2.

Dependencies

Project

• C++20 compiler
• OpenGL 3.3.0
• CMake 3.11

Libraries

• cpp-suprengine

Features

• Data-driven simulation: each animal type is defined by a data asset to specify behavior, movement and visuals (which means you can easily make rabbits carnivore and wolves photosynthetic)
• Serialization of animals data asset with JSON files.
• Animals eat according to their metabolism, reproduce within their own species, wander around and flee from their predators.
• Animals have 3D models and movement animations.
• Finite State Machine for AI logic, designed mixing with a Behavior Tree.
• Complete user interface tool using ImGui for both system balancing and debugging

Project Structure

This project only holds the engine code since it is de-coupled from games code.

Folder structure:

• assets/ contains game assets, such as data defining pawns, curves, etc.
• src/ contains source files of the game.

Build the project

This project is built using CMake 3.11, ensure you have already installed a compatible version.

Steps

0. Create a folder anywhere for the installation, we'll name it ekosystem. The reason for this is that the game's CMakeLists.txt will attempt to finds the engine's folder directly from its own parent folder, if you don't want that, look at the Troubleshooting section.
1. Clone the engine's repository in ekosystem/cpp-suprengine.
2. Run command git submodule update --init in the engine's folder.
3. Clone the game's repository (this one) in ekosystem/cpp-ekosystem.
4. Run the game's CMakeLists.txt either by using CMake's command line interpreter, CMake's GUI or your favorite IDE.

Troubleshooting

Change engine's folder location

If for some reasons you want to move the engine's or game's folder apart from each other, you can configure the location of the engine using the CMake variable SUPRENGINE_PATH.

Using command line:

cd build
cmake .. -DSUPRENGINE_PATH=C:/Path/To/Engine/

You can also use cmake-gui to change this variable.

Couldn't update engine's Git Submodules

If running the git submodule update command didn't work for any reasons, replace the folder libs/curve-x by cloning arkaht/cpp-curve-x.

Need administrator privileges to run the CMakeLists.txt

I'm using symbolic links to avoid having to copy the assets folder each time I compile. The problem is that on Windows, the symlink command requires administrator privileges. To resolve that, you can either:

• Enable Windows developper mode (not recommended).
• Run your IDE or CLI with administrator privileges.
• Edit the CMakeLists.txt by replacing suprengine_symlink_assets with suprengine_copy_assets

Credits

• Wolf model by Ezgarth from Sketchfab
• Hare model by 616 from Sketchfab
• Dirt texture by Cethiel from OpenGameArt