Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

Open Engine logo

Open Engine

A modern, high-performance, open-source game engine built for the community, by the community, with the goals of bringing power, scale, ease of use and true ownership to game developers.

It also builds for the web: the same engine runs in the browser on WebGPU, shipped as the @game-crafters-guild/openengine-web package with live examples. Its Web API is designed to bring the capabilities and performance of the engine into an HTML canvas anywhere.

Platforms: Windows x64 and ARM64 (primary), macOS on Apple Silicon and Intel (native Metal renderer), Linux, Steam Deck.

The Open Engine editor on a stylized village scene at evening: long shadows across the houses, a lake below, and the post-processing inspector open

Foundation

  • Open source, MIT licensed.
  • A modern C++20 code base.
  • Hot-reloadable C# scripting on CoreCLR (.NET 10).
  • Native C++ scripting.
  • A modern renderer built on Vulkan, Metal and WebGPU.
  • A cross-platform editor for Windows, macOS, Linux and the web. Yes, the editor runs in the browser.
  • An ECS built on a true data-oriented design.
  • UI driven by CSS layout and XML, in the editor and in games.
  • Built for AI-assisted development: a bundled MCP server and CLI let AI agents drive the running editor, and an in-editor AI assistant ships as a preview. See docs/MCP_SETUP.md.

Try it in the browser

Live examples, built from the engine and published with each release (WebGPU):

The model viewer: a sample model under cascaded shadows and a physical sky

  • Model viewer: sample models or your own .glb, orbit and pan, time of day, exposure, and the model's animation clips.
  • Instancing: one model drawn up to 100,000 times, each copy an entity.

The library behind them is @game-crafters-guild/openengine-web (npm install @game-crafters-guild/openengine-web@alpha); its README is the guide. The examples' source and the built package live in opengine-web.

Build

Prerequisites on Windows: Visual Studio 2026 with the Desktop development with C++ workload (includes CMake, Ninja and Git), the .NET 10 SDK and a Vulkan-capable GPU driver.

git clone https://github.com/Game-Crafters-Guild/OpenEngine.git
cd OpenEngine
cmake --preset vs2026-x64-local
cmake --build --preset vs2026-x64-local --config DebugFast --target Editor -j 12
build\vs2026-x64-local\bin\DebugFast\Apps\Editor\Editor.exe

The first configure bootstraps vcpkg and builds the third-party dependencies once (expect tens of minutes); every build after that is incremental. macOS and Linux build the same Editor through their own presets (macos-arm64-local, linux-x64-local); platform prerequisites, the Ninja fast build, Steam Deck, tests and troubleshooting are in BUILD.md. With the editor running, Your first project creates a project, saves a scene and exports a game.

Repository layout

Engine/               The engine library: Include/, Source/, and one library per subsystem under Modules/
  Assets/             Engine content the build stages beside the Editor and the Player: materials, render pipelines, textures, UI, graphs
  ECSModules/         Shared ECS components (Audio, Components, Rendering)
Apps/Editor/          The editor (C++, with CSS/XML UI)
Apps/Player/          The game runtime the editor exports games with
Apps/WebLibrary/      The web build: the WebGPU engine module and the @game-crafters-guild/openengine-web library
Managed/              C# side: CoreBridge, HotReload, Scripting.ABI, CompileServerHost
Packages/             Add-on packages: the AI assistant, version-control integrations, post effects, import tools
Examples/             Standalone demos (BUILD_EXAMPLES)
Tests/                Integration tests (module unit tests live next to each module)
ThirdParty/           Bundled third-party code, each with its own license
cmake/                Build scripts, presets and ports
mcp/                  The MCP server and CLI that drive a running editor
docs/                 Documentation (start at docs/index.html)
Tools/                Developer tools and scripts
dependencies/         Auto-provisioned vcpkg checkout (gitignored)
build/                Build trees, one per preset (gitignored)

Community

This is an alpha: APIs and file formats may change between releases.

The engine is yours as much as ours: open issues, send pull requests, and help shape it. CONTRIBUTING.md and CodingStyle.md say how.

Join us on Discord: https://discord.gg/c8JASm4q8

A note on AI

AI tools were used in the development of Open Engine. The engine is not "vibe coded": every change draws on its developers' experience and passes human review before it lands, and the same review stands at the door for contributions. Pull requests are judged on design, correctness and evidence, whoever or whatever wrote them; generated code that is not understood, tested and explained by its author is not accepted.

The team welcomes the responsible use of AI. The engine ships with built-in MCP tools and integrations to enable agentic workflows driven by human creativity and design.

License

MIT, see LICENSE. The people behind the engine are named in AUTHORS.md. Third-party code keeps its own license, stated next to it: the libraries under Engine/Source/ThirdParty/ and ThirdParty/, the benchmark sources under Tools/Benchmarks/ECS/third_party/, and the dependencies installed through vcpkg.

Tests

Tests are Google Test executables, one per module; BUILD.md lists how to build and run them. Two package-manager tests clone a live git repository and are skipped unless GE_GIT_E2E=1 is set: PackageGitResolution.LiveEndToEndAgainstGameEnginePackagesRepo and PackageManagementLive.AddRepinCheckAgainstGameEnginePackagesRepo.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages