Unhuman Engine Editor Interface


Real-time Rendering & Physics Demo

Unhuman Engine (UHE) is a lightweight, highly extensible C++ game engine designed for real-time applications and game development. It utilizes a modern Vulkan RHI backend, compiles shaders via Slang, and features a fully integrated ImGui editor.

• Modern Graphics Backend: Fully abstracted Render Hardware Interface (RHI) running on Vulkan.
• Slang Shader Compiler: Next-generation shading language support with dynamic compilation and SPIR-V generation.
• UHE Editor: A robust, dockable ImGui-based editor (UHE_EDITOR) for scene inspection, profiling, and asset management.
• Entity Component System: A fast, data-driven scene system (entt) supporting native script components and serialization.
• 2D & 3D Physics: Integrated physics handling with Box2D and jolt(in future).
• AAA Dependency Management: No bloated submodules or slow package managers. The engine fetches precompiled binaries (Slang, GLFW) automatically for zero-compile-time dependencies.
• Cross-Platform Tooling: Generates Ninja builds for Linux and Visual Studio 2022 solutions for Windows with a single click.

• Vulkan Refactor & AMD Stability: Resolved texture dynamic indexing validation issues on AMD/RADV drivers by manually binding texture slots in Slang.
• Color Accuracy & Aesthetics: Restored pure black ImGui docking themes and fixed sRGB gamma-correction bugs that were washing out linear textures.
• Improved UI Workflows: Added full Drag-and-Drop payload support for textures directly into the 3D Viewport and Scene Hierarchy component inspectors.

The repository is logically split to ensure the core engine remains separate from the application logic:

• UHE/ — The core engine, platform abstraction (Windows/Linux), Vulkan RHI, and vendor libraries.
• UHE_EDITOR/ — The standalone editor application built on top of the engine.
• sandbox/ — A lightweight testing application for running isolated scenes.
• script/Setup.py — The automated dependency fetcher that pulls heavy OS-specific binaries (like Slang) into UHE/vendor/bin/.

UHE uses a fully automated bootstrap system. You do not need to manually configure CMake or download binaries.

• A C++20 compatible compiler (GCC, Clang, or MSVC)
• CMake 3.16+
• Python 3 (Used for fetching precompiled binaries)
• Vulkan SDK

1. Clone the repository recursively (to fetch the lightweight submodules like glm and spdlog):

   git clone --recursive https://github.com/rajaryan2007/unhuman.git
   cd unhuman

2. Run the generation script. This will download the Windows binaries for Slang and generate a .sln file:

   GenerateProject.bat

3. Open build/UHE.sln in Visual Studio 2022 and hit Build.

1. Clone the repository recursively:

   git clone --recursive https://github.com/rajaryan2007/unhuman.git
   cd unhuman

2. Run the generation script. This will download the Linux binaries for Slang and generate build.ninja:

   ./GenerateProject.sh

3. Compile the engine using CMake:

   cmake --build build -j$(nproc)

Note: The built executables (UHE_EDITOR, Sandbox) will be placed in the bin/ directory.

Contributions are always welcome! If you want to contribute to the engine:

1. Ensure your code complies with the project's .clang-format and .clang-tidy rules. (If using Neovim/VS Code with clangd, this will be automatic).
2. Avoid adding heavy binaries directly to the repository. If you need a new dependency (like Assimp), add its download URL to the DEPENDENCIES dictionary in script/Setup.py.

Unhuman Engine is licensed under the MIT License. See the LICENSE file for more details.