Coreverse Engine is a next-generation, open-source game development ecosystem engineered for uncompromised performance, modular scalability, and developer ergonomics.
By bridging the absolute memory safety and modern concurrency of Rust with the raw computational power and industry-standard ecosystem of C++, Coreverse delivers a hybrid architecture capable of powering everything from lightweight 2D indie titles to complex, high-fidelity 3D simulations.
- 🦀 Rust + C++ Hybrid Core: Critical path memory safety combined with zero-overhead C++ rendering and physics execution.
- 🧱 Data-Oriented ECS: High-performance Entity Component System built for CPU cache locality and parallel processing.
- 🔄 Asynchronous Event Queue: Thread-safe, non-blocking message passing across engine subsystems.
- 📦 Virtual File System (VFS): Seamless asset packaging, mounting, and streaming with full UTF-8 filesystem support.
- ⚡ Modern Vulkan Renderer: Primary backend built for low-overhead, multi-threaded command buffer generation.
- 🖥️ OpenGL Fallback: Broad legacy and cross-platform compatibility.
- 📜 Advanced Asset Pipeline: Asynchronous asset compilation, optimization, and hot-reloading.
- 🎨 Native Qt Editor: Professional-grade, customizable C++ editor interface with docking, scene inspection, and profiling tools.
- 🚀 Tauri-Powered Launcher: Ultra-lightweight desktop launcher built with React, TypeScript, and Tauri.
- 🧩 Modular Plugin Architecture: Extend engine functionality dynamically without modifying core source code.
- ☁️ Cloud-Ready Infrastructure: Built-in integration support for backend services, telemetry, and multiplayer persistence.
- 🧠 Local & API AI Workflows: Native interfaces to plug into powerful LLMs and neural networks (via cloud APIs like OpenAI and Anthropic, or local inference runtimes like ONNX and llama.cpp).
- 🎮 Smart Game Mechanics: Seamlessly integrate AI for dynamic NPC behavior trees, real-time dialogue generation, and adaptive game systems without the overhead of training foundation models locally.
- 🛠️ Editor Copilot Support: AI-assisted scene generation, automated debugging, and intelligent asset tagging directly within the editor environment.
| Subsystem | Primary Technology | Responsibility |
|---|---|---|
| Engine Core | Rust + C++ (C++20) | Memory management, VFS, ECS, math library, and job system |
| Rendering | Vulkan / OpenGL | Scene graph execution, shader compilation, and post-processing |
| Editor | C++ / Qt6 | Tooling, scene manipulation, and development environment |
| Launcher | TypeScript / React / Tauri | Project management, engine versioning, and news feed |
| Backend / Server | Go | Authoritative networking, matchmaking, and state synchronization |
| AI Integration | Python / ONNX / REST APIs | Local inference runtime and cloud AI service connectors |
| Database & Cloud | PostgreSQL / Supabase | Player persistence, telemetry, and cloud asset storage |
| Build System | Cargo + CMake | Unified cross-language compilation and dependency management |
| Platform | Status | Notes |
|---|---|---|
| Windows | ✅ Fully Supported | Windows 10/11 (x64) |
| Linux | ✅ Fully Supported | Tested on Ubuntu 22.04+ / Arch Linux |
| macOS | 🚧 In Progress | Apple Silicon (M-Series) & Intel support |
| Android / iOS | 🔮 Planned | Mobile deployment via Vulkan/Metal backends |
| API | Status | Target Platforms |
|---|---|---|
| Vulkan 1.3 | ✅ Primary | Windows, Linux, Android |
| OpenGL 4.6 | ✅ Supported | Cross-platform legacy support |
| DirectX 12 | 🔮 Planned | Windows, Xbox |
| Metal 3 | 🔮 Planned | macOS, iOS |
coreverse-engine/
├── .github/ # CI/CD workflows and issue templates
├── applications/ # End-user applications and tools
│ ├── editor/ # Qt6-based visual editor
│ ├── launcher/ # Tauri + React desktop launcher
│ └── server/ # Go-based dedicated server node
├── assets/ # Default engine shaders, icons, and fonts
├── docs/ # Technical documentation and architecture specifications
├── engine/ # Engine core libraries
│ ├── cpp/ # Rendering, physics, and platform APIs
│ └── rust/ # ECS, VFS, job system, and core logic
├── scripts/ # Build utilities and environment setup scripts
├── third_party/ # Submodules and external dependencies
├── Cargo.toml # Rust workspace configuration
├── CMakeLists.txt # C++ build configuration
├── LICENSE # GNU General Public License v3.0
└── README.md
- Performance First: Abstractions must never come at the cost of runtime CPU/GPU cycles.
- Memory Safety by Design: Leverage Rust's ownership model for core subsystems to eliminate data races and memory leaks.
- Modular Extensibility: Every system is a plugin. Use only what your project requires.
- Fast Iteration: Hot-reloading for assets and shaders to keep creative workflows uninterrupted.
- Open Source Forever: Built by developers, for developers, with complete transparency.
Ensure you have the following toolchains installed on your system:
- Rust Toolchain (2024 Edition / Latest Stable)
- CMake (3.24 or newer)
- C++20 compatible compiler (MSVC v143+, Clang 15+, or GCC 12+)
- Node.js (v20+) & pnpm (for the Tauri Launcher)
- Qt 6.5+ (for the Editor)
-
Clone the Repository
git clone https://github.com/KING-MASTER2012/Coreverse-Engine.git cd coreverse-engine -
Build the Rust Core
cargo build --release
-
Build the C++ Engine & Editor
cmake -B build -DCMAKE_BUILD_TYPE=Release cmake --build build --config Release -j$(nproc) -
Run the Launcher (Tauri)
cd applications/launcher npm install npm run tauri dev
Comprehensive technical documentation can be found in the docs/ directory.
- Getting Started Guide
- Engine Architecture Specification
- ECS & Memory Model
- AI Integration Cookbook
- Plugin Development API
The roadmap below outlines major architectural milestones and upcoming features scheduled for implementation.
💡 Looking for completed tasks and granular progress? To keep this README clean and focused on the future, we track all daily progress, completed development phases, and version changelogs separately. Please see
PROGRESS.mdfor detailed tracking.
- Advanced Renderer: Hardware ray-tracing support via Vulkan Ray Tracing pipelines.
- Physics Integration: Native 3D rigid-body and fluid dynamics simulation integration.
- Audio Engine: Spatial 3D audio processing using OpenAL / FMOD architecture.
- AI Asset Tagging: Automated semantic asset categorization in VFS via local ONNX models.
- Visual Scripting: Node-based gameplay scripting integrated directly into the Qt Editor.
- Netcode Subsystem: Client-side prediction and server reconciliation modules in Rust.
- Plugin Marketplace: Decentralized community package registry within the Tauri launcher.
Coreverse Engine thrives on community collaboration. Whether you are fixing bugs, optimizing rendering pipelines, improving documentation, or suggesting features, your contributions are welcome!
- Fork the repository.
- Create a feature branch (
git checkout -b feature/amazing-feature). - Commit your changes following our conventional commit guidelines (
git commit -m 'feat(renderer): add vulkan validation layers'). - Push to your branch (
git push origin feature/amazing-feature). - Open a Pull Request.
Please review our Contribution Guidelines and Code of Conduct before submitting changes.
This software is open-source and released under the GNU General Public License v3.0 (GPL-3.0).
You are free to use, modify, and distribute this software in accordance with the terms of the license. See the LICENSE file for full legal details.
Coreverse Engine Core & Universe — Build Worlds Without Limits.