This is the repository of the CMEP project. A scriptable game engine written in C++, using the Vulkan API for rendering.
This project is currently in early stages of development and although basic demos (as shown in the ./examples/ subdirectory) can be made with it, the API often goes through changes and lacks in functionality.
Before you build the engine you first have to install the Vulkan SDK, download it from https://vulkan.lunarg.com/ and install it/unpack it.
Depending on your platform (Linux needs this, untested on MacOS), it might be necessary to set the VULKAN_SDK environment variable to a valid Vulkan SDK location so cmake finds all includes. Use either the setup-env.sh script (source path/to/vulkansdk/setup-env.sh) that comes with the Vulkan SDK or set it manually.
First use git clone "https://github.com/Snezhnaya-chan/CMEP.git" in a new clean directory to clone repository.
Then git submodule init and git submodule update --recursive to initialize and clone dependency submodules.
To build the project, use the following steps, depending on your selected generator:
Single-config (Makefiles, Ninja)
cmake -DCMAKE_BUILD_TYPE=<CONFIG> .
cmake --build . --target rungameMulti-config (Visual Studio)
cmake .
cmake --build . --target rungame --config <CONFIG>The rungame target will also build all of it's dependencies.
Important
Where <CONFIG> should be replaced with a valid configuration value (Either Debug or Release, case-sensitive)
Warning
By default most generators build the Debug configuration if none is specified, this may not be what you want.
There are CMake targets provided for every example:
cmake --build . --target <examplename>
Important
Where <examplename> is a name of a subdirectory under ./examples/ (e.g. floppybirb)
To start the engine use the rungame executable. This is located under the ./build/ subdirectory if the build is successful.¨
A ./build/game/ directory with valid content is necessary for startup, this can be created by building an example.
HTML documentation can be generated using doxygen, the build_docs cmake target is provided for this purpose, output is by default generated in the ./docs/output directory.
This project depends on:
- LuaJIT and the Lua programming language
- GLFW library
- lodepng
- tinyobjloader
- nlohmann-json
- Vulkan SDK
- glslang
All except the Vulkan SDK are prepackaged or built automatically once the build script is run. These projects are external to this one and are not affiliated with this project in any way, when using this project take care to follow licenses of the dependencies.
This project is licensed under the MIT license (see the LICENSE file for more information). For licenses of the dependencies, see the ./external/ directory