gkNextEngine

English | 简体中文

gkNextEngine是什么？

一个跨平台 3D 游戏引擎，基于现代 C++ 与 Vulkan。聚焦“可学习、可验证”的现代渲染与游戏技术实践。

亮点

• 多平台： Windows x86_64 / Linux x86_64 / macOS arm64 / Android arm64 / iOS arm64
• 现代渲染： 硬件/软件光追，实时全局光照，Visibility Buffer，GPU‑Driven，全 Bindless
• 时域技术： 时域重投影、双边滤波去噪，OpenImageDenoise
• 资产与场景： 完整 glTF（网格/纹理/材质/动画），以 Blender 为主的前置流程
• 引擎能力： 多线程任务调度、打包文件系统、HDR 显示与截图（AVIF/JPG）
• 编辑器： 全ImGui管线，节点式材质编辑器
• 编码哲学： 核心目标 < 50k 行（当前 ~15k，2025/09）；拥抱成熟三方库，拒绝重复造轮子

子项目

• gkNextRenderer：主渲染器（路径追踪/混合渲染）
• gkNextEditor：ImGui 编辑器，基于 GLB 读写的场景编辑
• MagicaLego：Voxel/乐高风格原型，实时路径追踪验证场景
• gkNextBenchmark：静态与实时场景基准程序
• Packager：资产打包为 .pkg，便于分发与加载
• Portal：（规划）可视化部署与调试入口

图库 / 视频

githubShow2.mp4

MagicaLego 片段

githubShow.mp4

10 秒展示视频

• 更多截图见 gallery/ 目录（含 Android 混合渲染）

快速开始

项目使用 CMake + Ninja / VS2022 构建，三方依赖由 vcpkg 管理。建议部署良好网络环境(可完整访问github)，并已安装 Git。

Windows（Visual Studio 2022）：

rem windows前置安装: 
rem 确保安装3.31版本的cmake，不要安装4.x版本的cmake
rem 确保安装Visual Studio 2022并选择c++工作负载
rem 如果使用Insider 2026版本，也需要至少安装VS2022 BuildTool
rem 确保安装VulkanSDK 1.4.313.2
rem 由于vcpkg部分tar包解压有乱码，请确保打开windows语言设置中的[使用Unicode UTF-8提供全球语言支持]
vcpkg.bat windows
build.bat windows
run.bat windows

Windows（MSYS2 MinGW）：

# 无需前置安装
pacman -S --needed git mingw-w64-x86_64-ninja mingw-w64-x86_64-cmake mingw-w64-x86_64-toolchain
./vcpkg.sh mingw
./build.sh mingw
./run.sh mingw

Linux（示例：Ubuntu）：

# 无需前置安装
sudo apt install build-essential cmake ninja-build curl zip unzip tar libxi-dev libxinerama-dev libxcursor-dev xorg-dev autoconf autoconf-archive automake libtool
./vcpkg.sh linux
./build.sh linux
./run.sh linux

macOS：

# 无需前置安装
brew install molten-vk glslang ninja
./vcpkg.sh macos
./build.sh macos
./run.sh macos

Android（在 Windows）：

rem 需 JDK 17+，安装 Android SDK 与 NDK r27（示例：27.0.12077973）
set ANDROID_HOME=C:\Android\Sdk
set ANDROID_NDK_HOME=C:\Android\Sdk\ndk\27.0.12077973
vcpkg.bat android
build.bat android
run.bat android

更多用法与约定请见仓库脚本与 .github/workflows。

技术要点（概览）

• 重要性采样（BRDF/Light），GGX VNDF
• 时域重投影（含多样本复用），高速双边滤波去噪，OpenImageDenoise
• Visibility Buffer（主命中），路径追踪/软追踪/探针 GI（后续命中），渲染器热切换/对照渲染
• 全流程 GPU‑Driven + Bindless 管线

参考与感谢

• RayTracingInVulkan — https://github.com/GPSnoopy/RayTracingInVulkan
• Vulkan Tutorial — https://vulkan-tutorial.com/
• Vulkan‑Samples — https://github.com/KhronosGroup/Vulkan-Samples

参与贡献

• 欢迎 Issue / PR
• 思考与记录见 doc/Thoughts.md
• 开发协作与命名规范：见 AGENTS.md