Skip to content

ChocolateEngine/chocolate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chocolate Engine

Required Software

  • CMake
  • Python 3.10
  • py7zr Python Module
  • git
  • git-lfs (used in KTX)
  • Vulkan SDK

Windows Software

  • Visual Studio 2022

Linux Software

  • Install these packages: build-essential cmake libsdl2-dev libglm-dev libvorbis-dev libogg-dev

Build Instructions

  • 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/thirdparty and run the thirdparty.py script 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 build in the chocolate folder (chocolate/build)
  • Enter that folder and in cmd/terminal, run cmake .. on Windows, or cmake -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 -j8 on linux, -j selects the number of threads to use for building)
  • Run any of the exe's in chocolate_output to 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