# kateusz/gameengine architecture

> Architecture diagram of the GitHub repository kateusz/gameengine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kateusz/gameengine
- Repository: https://github.com/kateusz/gameengine

## Overview

MulEngine is a component-based game engine with a docked visual editor and a standalone player. The main workflow is to open a project, load or edit a scene, then enter Play or run the player: scenes and systems operate on ECS entities, script assemblies supply game logic, and rendering/audio produce the result. The README also documents physics, prefabs, asset/model import, and publishing. Source excerpts establish the core loop and selected wiring; other capability links are documented by the README, not independently verified in source.

Main entry points: [`Engine/Scene/Scene.cs`](https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Scene.cs) (Scene and hierarchy), [`Engine/Core/Application.cs`](https://github.com/kateusz/gameengine/blob/main/Engine/Core/Application.cs) (Application loop), [`Editor/Features/Scene/SceneManager.cs`](https://github.com/kateusz/gameengine/blob/main/Editor/Features/Scene/SceneManager.cs) (Scene workflow), [`Engine/Core/DI/EngineIoCContainer.cs`](https://github.com/kateusz/gameengine/blob/main/Engine/Core/DI/EngineIoCContainer.cs) (Engine composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hosts["Hosts and composition"]
  node_editor_app["Visual editor<br/>[Editor.cs]"]
  node_player["Standalone player<br/>[Program.cs]"]
  node_app_loop["Application loop<br/>[Application.cs]"]
  node_composition["Engine composition"]
end

subgraph group_world["Scenes and gameplay"]
  node_ecs["Entities and components<br/>[Entity.cs]"]
  node_ecs_context[("Entity context<br/>[Context.cs]")]
  node_scene["Scene and hierarchy<br/>[Scene.cs]"]
  node_scene_systems["Scene systems"]
  node_serialization["Scene and prefab files<br/>[SceneSerializer.cs]"]
  node_physics["2D physics"]
  node_scripting["Game scripting<br/>[ScriptEngine.cs]"]
end

subgraph group_editor["Editor workflow"]
  node_editor_project["Project workflow<br/>[ProjectManager.cs]"]
  node_editor_scene["Scene workflow<br/>[SceneManager.cs]"]
  node_editor_viewport["Viewport tools"]
  node_editor_history["Undo history<br/>[EditorHistory.cs]"]
  node_asset_browser["Asset browser"]
  node_publisher["Build and publish<br/>[GamePublisher.cs]"]
end

subgraph group_render["Rendering and assets"]
  node_render_pipeline["Scene rendering"]
  node_graphics_api["Graphics interfaces<br/>[IGraphics3D.cs]"]
  node_opengl["OpenGL backend"]
end

subgraph group_services["Runtime services"]
  node_window_input["Window and input"]
  node_project["Project context<br/>[ProjectContext.cs]"]
  node_asset_paths["Asset path resolution<br/>[PathBuilder.cs]"]
  node_audio["Audio playback"]
end

node_user(("Project user"))

node_user -->|"edits project"| node_editor_app
node_user -->|"runs build"| node_player
node_editor_app -->|"inherits loop"| node_app_loop
node_player -->|"starts application"| node_app_loop
node_composition -->|"registers backend"| node_opengl
node_composition -->|"registers context"| node_project
node_composition -->|"wires context"| node_asset_paths
node_app_loop -->|"receives events"| node_window_input
node_app_loop -->|"updates audio"| node_audio
node_editor_project -->|"applies project"| node_project
node_editor_project -->|"coordinates scenes"| node_editor_scene
node_editor_scene -->|"loads scenes"| node_scene
node_scene -->|"registers entities"| node_ecs_context
node_ecs_context -->|"indexes components"| node_ecs
node_scene -.->|"runs systems"| node_scene_systems
node_scene -.->|"serializes scene"| node_serialization
node_scene -.->|"simulates physics"| node_physics
node_scene -.->|"loads game logic"| node_scripting
node_editor_scene -.->|"records changes"| node_editor_history
node_editor_viewport -.->|"edits entities"| node_scene
node_asset_browser -->|"resolves assets"| node_asset_paths
node_asset_browser -.->|"imports models"| node_editor_scene
node_editor_app -->|"publishes builds"| node_publisher
node_scene -.->|"renders scene"| node_render_pipeline
node_render_pipeline -->|"issues draw calls"| node_graphics_api
node_graphics_api -.->|"implemented by"| node_opengl
node_scene -.->|"plays component audio"| node_audio

click node_editor_app "https://github.com/kateusz/gameengine/blob/main/Editor/Editor.cs"
click node_player "https://github.com/kateusz/gameengine/blob/main/Runtime/Program.cs"
click node_app_loop "https://github.com/kateusz/gameengine/blob/main/Engine/Core/Application.cs"
click node_composition "https://github.com/kateusz/gameengine/blob/main/Engine/Core/DI/EngineIoCContainer.cs"
click node_window_input "https://github.com/kateusz/gameengine/tree/main/Engine/Platform/SilkNet"
click node_project "https://github.com/kateusz/gameengine/blob/main/Engine/Project/ProjectContext.cs"
click node_asset_paths "https://github.com/kateusz/gameengine/blob/main/Engine/Project/PathBuilder.cs"
click node_ecs "https://github.com/kateusz/gameengine/blob/main/ECS/Entity.cs"
click node_ecs_context "https://github.com/kateusz/gameengine/blob/main/ECS/Context.cs"
click node_scene "https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Scene.cs"
click node_scene_systems "https://github.com/kateusz/gameengine/blob/main/Engine/Scene/SceneSystemsFactory.cs"
click node_serialization "https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Serializer/SceneSerializer.cs"
click node_physics "https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Systems/PhysicsSimulationSystem.cs"
click node_scripting "https://github.com/kateusz/gameengine/blob/main/Engine/Scripting/ScriptEngine.cs"
click node_editor_project "https://github.com/kateusz/gameengine/blob/main/Editor/Features/Project/ProjectManager.cs"
click node_editor_scene "https://github.com/kateusz/gameengine/blob/main/Editor/Features/Scene/SceneManager.cs"
click node_editor_viewport "https://github.com/kateusz/gameengine/blob/main/Editor/Features/Viewport/ViewportToolManager.cs"
click node_editor_history "https://github.com/kateusz/gameengine/blob/main/Editor/Features/History/EditorHistory.cs"
click node_asset_browser "https://github.com/kateusz/gameengine/blob/main/Editor/AssetPicker/AssetPickSession.cs"
click node_publisher "https://github.com/kateusz/gameengine/blob/main/Editor/Publisher/GamePublisher.cs"
click node_render_pipeline "https://github.com/kateusz/gameengine/blob/main/Engine/Scene/SceneRenderPipeline.cs"
click node_graphics_api "https://github.com/kateusz/gameengine/blob/main/Engine/Renderer/Pipeline/IGraphics3D.cs"
click node_opengl "https://github.com/kateusz/gameengine/blob/main/Engine/Platform/OpenGL/OpenGLRendererApi.cs"
click node_audio "https://github.com/kateusz/gameengine/blob/main/Engine/Platform/OpenAL/OpenALAudioEngine.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_editor_app,node_player,node_app_loop,node_composition,node_user toneBlue
class node_ecs,node_ecs_context,node_scene,node_scene_systems,node_serialization,node_physics,node_scripting toneAmber
class node_editor_project,node_editor_scene,node_editor_viewport,node_editor_history,node_asset_browser,node_publisher toneMint
class node_render_pipeline,node_graphics_api,node_opengl toneRose
class node_window_input,node_project,node_asset_paths,node_audio toneIndigo
```

## Components

### Hosts and composition

- [Visual editor](https://github.com/kateusz/gameengine/blob/main/Editor/Editor.cs): `Editor/Editor.cs`
- [Standalone player](https://github.com/kateusz/gameengine/blob/main/Runtime/Program.cs): `Runtime/Program.cs`
- [Application loop](https://github.com/kateusz/gameengine/blob/main/Engine/Core/Application.cs): `Engine/Core/Application.cs`
- [Engine composition](https://github.com/kateusz/gameengine/blob/main/Engine/Core/DI/EngineIoCContainer.cs): `Engine/Core/DI/EngineIoCContainer.cs`

### Scenes and gameplay

- [Entities and components](https://github.com/kateusz/gameengine/blob/main/ECS/Entity.cs): `ECS/Entity.cs`
- [Entity context](https://github.com/kateusz/gameengine/blob/main/ECS/Context.cs): `ECS/Context.cs`
- [Scene and hierarchy](https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Scene.cs): `Engine/Scene/Scene.cs`
- [Scene systems](https://github.com/kateusz/gameengine/blob/main/Engine/Scene/SceneSystemsFactory.cs): `Engine/Scene/SceneSystemsFactory.cs`
- [Scene and prefab files](https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Serializer/SceneSerializer.cs): `Engine/Scene/Serializer/SceneSerializer.cs`
- [2D physics](https://github.com/kateusz/gameengine/blob/main/Engine/Scene/Systems/PhysicsSimulationSystem.cs): `Engine/Scene/Systems/PhysicsSimulationSystem.cs`
- [Game scripting](https://github.com/kateusz/gameengine/blob/main/Engine/Scripting/ScriptEngine.cs): `Engine/Scripting/ScriptEngine.cs`

### Editor workflow

- [Project workflow](https://github.com/kateusz/gameengine/blob/main/Editor/Features/Project/ProjectManager.cs): `Editor/Features/Project/ProjectManager.cs`
- [Scene workflow](https://github.com/kateusz/gameengine/blob/main/Editor/Features/Scene/SceneManager.cs): `Editor/Features/Scene/SceneManager.cs`
- [Viewport tools](https://github.com/kateusz/gameengine/blob/main/Editor/Features/Viewport/ViewportToolManager.cs): `Editor/Features/Viewport/ViewportToolManager.cs`
- [Undo history](https://github.com/kateusz/gameengine/blob/main/Editor/Features/History/EditorHistory.cs): `Editor/Features/History/EditorHistory.cs`
- [Asset browser](https://github.com/kateusz/gameengine/blob/main/Editor/AssetPicker/AssetPickSession.cs): `Editor/AssetPicker/AssetPickSession.cs`
- [Build and publish](https://github.com/kateusz/gameengine/blob/main/Editor/Publisher/GamePublisher.cs): `Editor/Publisher/GamePublisher.cs`

### Rendering and assets

- [Scene rendering](https://github.com/kateusz/gameengine/blob/main/Engine/Scene/SceneRenderPipeline.cs): `Engine/Scene/SceneRenderPipeline.cs`
- [Graphics interfaces](https://github.com/kateusz/gameengine/blob/main/Engine/Renderer/Pipeline/IGraphics3D.cs): `Engine/Renderer/Pipeline/IGraphics3D.cs`
- [OpenGL backend](https://github.com/kateusz/gameengine/blob/main/Engine/Platform/OpenGL/OpenGLRendererApi.cs): `Engine/Platform/OpenGL/OpenGLRendererApi.cs`

### Runtime services

- [Window and input](https://github.com/kateusz/gameengine/tree/main/Engine/Platform/SilkNet): `Engine/Platform/SilkNet`
- [Project context](https://github.com/kateusz/gameengine/blob/main/Engine/Project/ProjectContext.cs): `Engine/Project/ProjectContext.cs`
- [Asset path resolution](https://github.com/kateusz/gameengine/blob/main/Engine/Project/PathBuilder.cs): `Engine/Project/PathBuilder.cs`
- [Audio playback](https://github.com/kateusz/gameengine/blob/main/Engine/Platform/OpenAL/OpenALAudioEngine.cs): `Engine/Platform/OpenAL/OpenALAudioEngine.cs`

### Other components

- **Project user**

## Connections

- Project user → Visual editor: edits project
- Project user → Standalone player: runs build
- Visual editor → Application loop: inherits loop (evidence: `Editor/Editor.cs`)
- Standalone player → Application loop: starts application (evidence: `Runtime/Program.cs`)
- Engine composition → OpenGL backend: registers backend (evidence: `Engine/Core/DI/EngineIoCContainer.cs`)
- Engine composition → Project context: registers context (evidence: `Engine/Core/DI/EngineIoCContainer.cs`)
- Engine composition → Asset path resolution: wires context (evidence: `Engine/Core/DI/EngineIoCContainer.cs`)
- Application loop → Window and input: receives events (evidence: `Engine/Core/Application.cs`)
- Application loop → Audio playback: updates audio (evidence: `Engine/Core/Application.cs`)
- Project workflow → Project context: applies project (evidence: `Editor/Features/Project/ProjectManager.cs`)
- Project workflow → Scene workflow: coordinates scenes (evidence: `Editor/Features/Project/ProjectManager.cs`)
- Scene workflow → Scene and hierarchy: loads scenes (evidence: `Editor/Features/Scene/SceneManager.cs`)
- Scene and hierarchy → Entity context: registers entities (evidence: `Engine/Scene/Scene.cs`)
- Entity context → Entities and components: indexes components (evidence: `ECS/Context.cs`)
- Scene and hierarchy → Scene systems: runs systems
- Scene and hierarchy → Scene and prefab files: serializes scene
- Scene and hierarchy → 2D physics: simulates physics
- Scene and hierarchy → Game scripting: loads game logic
- Scene workflow → Undo history: records changes
- Viewport tools → Scene and hierarchy: edits entities
- Asset browser → Asset path resolution: resolves assets (evidence: `Editor/AssetPicker/AssetPickSession.cs`)
- Asset browser → Scene workflow: imports models
- Visual editor → Build and publish: publishes builds
- Scene and hierarchy → Scene rendering: renders scene (evidence: `Engine/Scene/SceneRenderPipeline.cs`)
- Scene rendering → Graphics interfaces: issues draw calls (evidence: `Engine/Scene/SceneRenderPipeline.cs`)
- Graphics interfaces → OpenGL backend: implemented by
- Scene and hierarchy → Audio playback: plays component audio
