Lumos Engine

Cross-platform 2D and 3D Game Engine written in C++ that supports both OpenGL and Vulkan.

Screenshots | Building | Features | Dependencies

Screenshots

Building 🔨

git clone https://github.com/jmorton06/Lumos.git

Linux

sudo apt-get install -y g++-8 libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libopenal-dev mesa-common-dev
cd Lumos
Tools/premake5 gmake2
cd build
make -j8

Windows

Run Scripts/GenerateVS.bat to generate a visual studio project.

cd Lumos
msbuild /p:Platform=x64 /p:Configuration=Release build/Lumos.sln

Mac

cd Lumos
Tools/premake5 xcode4
xcodebuild -project build/Sandbox.xcodeproj

iOS

cd Lumos
Tools/premake5 xcode4 --os=ios
xcodebuild -project build/Sandbox.xcodeproj CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

To run on apple devices with Vulkan ( MoltenVK ), disable Metal API Validation here : Product > Scheme > Edit Scheme… > Run > Options > Metal API Validation

Features

Support for Windows, Linux, macOS.
Support for OpenGL/Vulkan.
3D audio using OpenAL.
Rendering 3D models with deferred PBR shading.
Debug gui using ImGui
Custom maths library with simd optimisation.
3D collision detection - cuboid/sphere/pyramid.
2D collision detection - Box2D.
Basic lua scripting support.

Contributing

Contributions are welcome. Both new features and bug fixes. Just open a pull request.

Dependencies

imgui : Dear ImGui: Bloat-free Immediate Mode Graphical User interface for C++ with minimal dependencies.
imguizmo : Immediate mode 3D gizmo for scene editing and other controls based on Dear Imgui.
entt : Fast and reliable entity-component system (ECS)
glfw : A multi-platform library for OpenGL, OpenGL ES, Vulkan, window and input.
spdlog : Fast C++ logging library.
stb : Single-file public domain (or MIT licensed) libraries for C/C++.
tinygltf : Header only C++11 tiny glTF 2.0 library
tinyobjloader : Tiny but powerful single file wavefront obj loader
volk : Meta loader for Vulkan API.
glad : Meta loader for OpenGL API.
Box2D : 2D physics engine.
sol2 : C++ <-> Lua API wrapper
cereal : A C++11 library for serialization

setheclark/Lumos