- CMake
- Python 3.10
- py7zr Python Module
- git
- git-lfs (used in KTX)
- Vulkan SDK
- Visual Studio 2022
- Install these packages:
build-essential cmake libsdl2-dev libglm-dev libvorbis-dev libogg-dev
- Make a folder to place this repo in
- Clone the "chocolate_output" repo first in that folder: https://github.com/ChocolateEngine/chocolate_output
- Enter
chocolate/thirdpartyand run thethirdparty.pyscript to download and compile thirdparty stuff - Compile shaders with
chocolate/src/render/shaders_glsl/_compile.bat(or _compile.sh on linux) - OPTIONAL - If you want to run render3, compile render3 shaders here as well:
chocolate/src/render3/shaders_glsl/_compile.bat - Make a folder called
buildin thechocolatefolder (chocolate/build) - Enter that folder and in cmd/terminal, run
cmake ..on Windows, orcmake -DCMAKE_BUILD_TYPE=Debug ..on Linux (also Release is an option) - Finish with standard cmake build stuff (Open ChocolateEngine.sln on Windows and build,
make -j8on linux, -j selects the number of threads to use for building) - Run any of the exe's in
chocolate_outputto run an app (toolkit_win64.exe requires --game sidury as a launch option, as it's an editor for games on the engine, so this option selects a game to use)
Current CMake Options:
| Option | Default Value | Description |
|---|---|---|
| RENDER3 | ON | Build Render3 |
| RENDER2 | ON | Build Render2 |
| STEAM | OFF | Steam Game Abstraction, Requires the Steamworks SDK placed in the apps/steam folder |
| GAME | ON | Build Sidury |
| TOOLKIT | ON | Build the toolkit |
| RENDER_TEST | ON | Build Render 3 Test App |