# hisham-css/gameengineframework architecture

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

- Interactive diagram: https://gitdiagram.com/hisham-css/gameengineframework
- Repository: https://github.com/hisham-css/gameengineframework

## Overview

Cat Splat Engine combines a scene-authoring editor, a standalone runtime and asset cooker, a modular game engine, and the Untitled Fighter showcase. The principal workflow is authoring scenes and build settings in the editor, producing a player build, then running a game through the engine; the fighter adds deterministic simulation and rollback networking. The graph preserves the README’s major rendering, UI, backend, and authoring capabilities. Several subsystems are documented but unsampled, so their links use README evidence rather than implying inspected implementation details.

Main entry points: [`Engine/src/core/Application.cpp`](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Application.cpp) (Application Host), [`Editor/src/EditorApplication.cpp`](https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/EditorApplication.cpp) (Scene Editor), [`Engine/src/core/Renderer.h`](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Renderer.h) (Renderer), [`Engine/src/core/AssetManager.cpp`](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/AssetManager.cpp) (Asset Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Editor and Builds"]
  node_author["Scene Editor"]
  node_inspector["Inspector<br/>[InspectorPanel.cpp]"]
  node_undo["Undo History<br/>[UndoHistory.cpp]"]
  node_buildsettings["Build Settings<br/>[BuildSettings.h]"]
  node_buildpipeline["Build Pipeline<br/>[BuildPipeline.cpp]"]
  node_player["Standalone Player<br/>[PlayerMain.cpp]"]
  node_cooker["Asset Cooker<br/>[CookerMain.cpp]"]
end

subgraph group_engine["Engine Runtime"]
  node_application["Application Host<br/>[Application.cpp]"]
  node_scene["Scene and ECS<br/>[Scene.h]"]
  node_loader["Scene Loader<br/>[SceneLoader.h]"]
  node_serializer["Scene Serialization<br/>[SceneSerializer.h]"]
  node_assets["Asset Manager<br/>[AssetManager.cpp]"]
  node_model["Model Import<br/>[Model.h]"]
  node_jobs["Job System<br/>[JobSystem.h]"]
  node_camera["Camera System<br/>[Camera.h]"]
  node_backend["Swappable Backends<br/>[PhysicsWorld.cpp]"]
end

subgraph group_render["Rendering and UI"]
  node_renderer["Renderer<br/>[Renderer.h]"]
  node_passes["Render Passes<br/>[RenderPipeline.h]"]
  node_ui["Game UI Toolkit<br/>[UIWorld.cpp]"]
  node_renderer2d["2D Renderer<br/>[Renderer2D.cpp]"]
end

subgraph group_fighter["Fighter Gameplay"]
  node_kernel["Combat Kernel<br/>[Simulate.cpp]"]
  node_fight["Fight Session<br/>[FightSession.cpp]"]
  node_sessiondriver["Session Driver<br/>[SessionDriver.cpp]"]
  node_witness["Witness Cursor<br/>[WitnessCursor.h]"]
  node_characterdata["Character Data<br/>[CharacterData.cpp]"]
  node_combo["Combo Search<br/>[ComboSearch.cpp]"]
end

subgraph group_network["Rollback Networking"]
  node_session["Rollback Session<br/>[GekkoSession.cpp]"]
  node_transport["Network Transport<br/>[UdpTransport.cpp]"]
end

node_user(("Game Author"))
node_peer(("Remote Peer"))

node_user -->|"authors scenes"| node_author
node_author -->|"edits entities"| node_inspector
node_inspector -->|"records edits"| node_undo
node_author -->|"configures build"| node_buildsettings
node_author -->|"starts build"| node_buildpipeline
node_buildsettings -->|"provides settings"| node_buildpipeline
node_buildpipeline -->|"builds executable"| node_player
node_player -->|"hosts runtime"| node_application
node_application -->|"loads scenes"| node_loader
node_loader -->|"reads scene data"| node_serializer
node_loader -->|"loads assets"| node_assets
node_assets -->|"dispatches decode"| node_jobs
node_assets -->|"creates models"| node_model
node_application -->|"runs rendering"| node_renderer
node_renderer -->|"executes passes"| node_passes
node_application -->|"owns camera"| node_camera
node_renderer -->|"renders scene"| node_scene
node_renderer -->|"draws game UI"| node_ui
node_ui -->|"draws through"| node_renderer2d
node_application -.->|"hosts services"| node_backend
node_characterdata -.->|"supplies behavior data"| node_fight
node_sessiondriver -->|"pumps session"| node_session
node_sessiondriver -->|"applies session events"| node_fight
node_fight -->|"advances simulation"| node_kernel
node_fight -.->|"notifies observers"| node_witness
node_combo -->|"reads evidence"| node_witness
node_session -->|"sends packets"| node_transport
node_peer -.->|"exchanges packets"| node_transport
node_cooker -.->|"validates assets"| node_assets

click node_author "https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/EditorApplication.cpp"
click node_inspector "https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/panels/InspectorPanel.cpp"
click node_undo "https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/UndoHistory.cpp"
click node_buildsettings "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/BuildSettings.h"
click node_buildpipeline "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/BuildPipeline.cpp"
click node_player "https://github.com/hisham-css/gameengineframework/blob/master/Player/src/PlayerMain.cpp"
click node_cooker "https://github.com/hisham-css/gameengineframework/blob/master/Cooker/src/CookerMain.cpp"
click node_application "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Application.cpp"
click node_scene "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Scene.h"
click node_loader "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/SceneLoader.h"
click node_serializer "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/SceneSerializer.h"
click node_assets "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/AssetManager.cpp"
click node_model "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Model.h"
click node_jobs "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/JobSystem.h"
click node_camera "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Camera.h"
click node_renderer "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Renderer.h"
click node_passes "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/render/RenderPipeline.h"
click node_ui "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/ui/UIWorld.cpp"
click node_renderer2d "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/render2d/Renderer2D.cpp"
click node_backend "https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/physics/PhysicsWorld.cpp"
click node_kernel "https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Kernel/src/Simulate.cpp"
click node_fight "https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Game/src/FightSession.cpp"
click node_sessiondriver "https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Modes/src/SessionDriver.cpp"
click node_witness "https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Game/include/cse/game/WitnessCursor.h"
click node_characterdata "https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Data/src/CharacterData.cpp"
click node_combo "https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Game/src/ComboSearch.cpp"
click node_session "https://github.com/hisham-css/gameengineframework/blob/master/Net/src/GekkoSession.cpp"
click node_transport "https://github.com/hisham-css/gameengineframework/blob/master/Net/src/UdpTransport.cpp"

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_author,node_inspector,node_undo,node_buildsettings,node_buildpipeline,node_player,node_cooker toneBlue
class node_application,node_scene,node_loader,node_serializer,node_assets,node_model,node_jobs,node_camera,node_backend toneAmber
class node_renderer,node_passes,node_ui,node_renderer2d toneMint
class node_kernel,node_fight,node_sessiondriver,node_witness,node_characterdata,node_combo toneRose
class node_session,node_transport,node_user,node_peer toneIndigo
```

## Components

### Editor and Builds

- [Scene Editor](https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/EditorApplication.cpp): `Editor/src/EditorApplication.cpp`
- [Inspector](https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/panels/InspectorPanel.cpp): `Editor/src/panels/InspectorPanel.cpp`
- [Undo History](https://github.com/hisham-css/gameengineframework/blob/master/Editor/src/UndoHistory.cpp): `Editor/src/UndoHistory.cpp`
- [Build Settings](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/BuildSettings.h): `Engine/src/core/BuildSettings.h`
- [Build Pipeline](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/BuildPipeline.cpp): `Engine/src/core/BuildPipeline.cpp`
- [Standalone Player](https://github.com/hisham-css/gameengineframework/blob/master/Player/src/PlayerMain.cpp): `Player/src/PlayerMain.cpp`
- [Asset Cooker](https://github.com/hisham-css/gameengineframework/blob/master/Cooker/src/CookerMain.cpp): `Cooker/src/CookerMain.cpp`

### Engine Runtime

- [Application Host](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Application.cpp): `Engine/src/core/Application.cpp`
- [Scene and ECS](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Scene.h): `Engine/src/core/Scene.h`
- [Scene Loader](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/SceneLoader.h): `Engine/src/core/SceneLoader.h`
- [Scene Serialization](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/SceneSerializer.h): `Engine/src/core/SceneSerializer.h`
- [Asset Manager](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/AssetManager.cpp): `Engine/src/core/AssetManager.cpp`
- [Model Import](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Model.h): `Engine/src/core/Model.h`
- [Job System](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/JobSystem.h): `Engine/src/core/JobSystem.h`
- [Camera System](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Camera.h): `Engine/src/core/Camera.h`
- [Swappable Backends](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/physics/PhysicsWorld.cpp): `Engine/src/physics/PhysicsWorld.cpp`

### Rendering and UI

- [Renderer](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/core/Renderer.h): `Engine/src/core/Renderer.h`
- [Render Passes](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/render/RenderPipeline.h): `Engine/src/render/RenderPipeline.h`
- [Game UI Toolkit](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/ui/UIWorld.cpp): `Engine/src/ui/UIWorld.cpp`
- [2D Renderer](https://github.com/hisham-css/gameengineframework/blob/master/Engine/src/render2d/Renderer2D.cpp): `Engine/src/render2d/Renderer2D.cpp`

### Fighter Gameplay

- [Combat Kernel](https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Kernel/src/Simulate.cpp): `Games/UntitledFighter/Kernel/src/Simulate.cpp`
- [Fight Session](https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Game/src/FightSession.cpp): `Games/UntitledFighter/Game/src/FightSession.cpp`
- [Session Driver](https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Modes/src/SessionDriver.cpp): `Games/UntitledFighter/Modes/src/SessionDriver.cpp`
- [Witness Cursor](https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Game/include/cse/game/WitnessCursor.h): `Games/UntitledFighter/Game/include/cse/game/WitnessCursor.h`
- [Character Data](https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Data/src/CharacterData.cpp): `Games/UntitledFighter/Data/src/CharacterData.cpp`
- [Combo Search](https://github.com/hisham-css/gameengineframework/blob/master/Games/UntitledFighter/Game/src/ComboSearch.cpp): `Games/UntitledFighter/Game/src/ComboSearch.cpp`

### Rollback Networking

- [Rollback Session](https://github.com/hisham-css/gameengineframework/blob/master/Net/src/GekkoSession.cpp): `Net/src/GekkoSession.cpp`
- [Network Transport](https://github.com/hisham-css/gameengineframework/blob/master/Net/src/UdpTransport.cpp): `Net/src/UdpTransport.cpp`

### Other components

- **Game Author**
- **Remote Peer**

## Connections

- Game Author → Scene Editor: authors scenes (evidence: `README.md`)
- Scene Editor → Inspector: edits entities (evidence: `Editor/src/EditorApplication.cpp`)
- Inspector → Undo History: records edits
- Scene Editor → Build Settings: configures build (evidence: `README.md`)
- Scene Editor → Build Pipeline: starts build
- Build Settings → Build Pipeline: provides settings (evidence: `Engine/src/core/BuildPipeline.cpp`)
- Build Pipeline → Standalone Player: builds executable
- Standalone Player → Application Host: hosts runtime (evidence: `Player/src/PlayerMain.cpp`)
- Application Host → Scene Loader: loads scenes
- Scene Loader → Scene Serialization: reads scene data (evidence: `Engine/src/core/SceneLoader.h`)
- Scene Loader → Asset Manager: loads assets (evidence: `Engine/src/core/SceneLoader.h`)
- Asset Manager → Job System: dispatches decode (evidence: `Engine/src/core/AssetManager.cpp`)
- Asset Manager → Model Import: creates models (evidence: `Engine/src/core/AssetManager.cpp`)
- Application Host → Renderer: runs rendering
- Renderer → Render Passes: executes passes (evidence: `Engine/src/core/Renderer.h`)
- Application Host → Camera System: owns camera
- Renderer → Scene and ECS: renders scene (evidence: `Engine/src/core/Renderer.h`)
- Renderer → Game UI Toolkit: draws game UI
- Game UI Toolkit → 2D Renderer: draws through
- Application Host → Swappable Backends: hosts services (evidence: `README.md`)
- Character Data → Fight Session: supplies behavior data (evidence: `README.md`)
- Session Driver → Rollback Session: pumps session
- Session Driver → Fight Session: applies session events
- Fight Session → Combat Kernel: advances simulation
- Fight Session → Witness Cursor: notifies observers (evidence: `Games/UntitledFighter/Game/src/FightSession.cpp`)
- Combo Search → Witness Cursor: reads evidence (evidence: `Games/UntitledFighter/Game/src/ComboSearch.cpp`)
- Rollback Session → Network Transport: sends packets
- Remote Peer → Network Transport: exchanges packets
- Asset Cooker → Asset Manager: validates assets (evidence: `README.md`)
