# immedved/epidemic architecture

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

- Interactive diagram: https://gitdiagram.com/immedved/epidemic
- Repository: https://github.com/immedved/epidemic

## Overview

Epidemic Engine is a Windows-focused C++ game-engine foundation, runtime, and reusable gameplay framework. Its broad workflow is to compose gameplay services over the runtime through a bridge, while the runtime supplies world, simulation, presentation, and other engine capabilities atop EngineBase. README documents the layer boundaries and runtime support role; the sampled bridge backend confirms connections to world, physics, navigation, and environment contracts. Many individual runtime and gameplay implementations were not sampled, so their internal call paths are not inferred.

Main entry points: [`EngineBase/Support/src`](https://github.com/immedved/epidemic/tree/main/EngineBase/Support/src) (Base support), [`EngineFramework/RuntimeBoundary/RuntimeBridge/src`](https://github.com/immedved/epidemic/tree/main/EngineFramework/RuntimeBoundary/RuntimeBridge/src) (Runtime bridge), [`EngineBase/Core/src`](https://github.com/immedved/epidemic/tree/main/EngineBase/Core/src) (Core lifecycle), [`EngineFramework/BaseInfrastructure/Foundation/src`](https://github.com/immedved/epidemic/tree/main/EngineFramework/BaseInfrastructure/Foundation/src) (Gameplay foundation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_base["EngineBase"]
  node_base_core["Core lifecycle"]
  node_base_platform["Windows platform"]
  node_base_input["Raw input"]
  node_base_rhi["RHI backends"]
  node_base_support["Base support"]
end

subgraph group_runtime["EngineRuntime"]
  node_resources["Resources"]
  node_persistence["Persistence"]
  node_time_environment["Time and environment"]
  node_scene["Scene"]
  node_world["World and streaming"]
  node_physics["Physics"]
  node_navigation["Navigation"]
  node_renderer["Renderer"]
  node_animation_audio["Animation and audio"]
  node_simulation["Simulation"]
end

subgraph group_framework["GameFramework"]
  node_framework_foundation["Gameplay foundation"]
  node_gameplay_owners["Gameplay systems"]
  node_framework_integrations["Gameplay adapters"]
  node_runtime_bridge["Runtime bridge"]
end

subgraph group_runtime_support["Runtime composition"]
  node_runtime_support_node["Runtime support"]
end

node_game_client(("Game composition"))

node_game_client -->|"composes gameplay"| node_framework_foundation
node_framework_foundation -.->|"supports systems"| node_gameplay_owners
node_gameplay_owners -.->|"adapts domains"| node_framework_integrations
node_framework_integrations -.->|"connects runtime"| node_runtime_bridge
node_runtime_bridge -->|"uses world services"| node_world
node_runtime_bridge -->|"uses physics services"| node_physics
node_runtime_bridge -->|"uses navigation services"| node_navigation
node_runtime_bridge -->|"uses environment runtime"| node_time_environment
node_framework_foundation -->|"bridges engine runtime"| node_runtime_bridge
node_runtime_bridge -.->|"consumes runtime contracts"| node_runtime_support_node
node_base_core -.->|"runs platform"| node_base_platform
node_base_core -.->|"hosts input"| node_base_input
node_base_core -.->|"hosts rendering"| node_base_rhi
node_base_core -.->|"uses support"| node_base_support
node_base_support -->|"composes runtime majors"| node_resources
node_base_support -->|"composes runtime majors"| node_persistence
node_base_support -->|"composes runtime majors"| node_time_environment
node_base_support -->|"composes runtime majors"| node_scene
node_base_support -->|"composes runtime majors"| node_world
node_base_support -->|"composes runtime majors"| node_physics
node_base_support -->|"composes runtime majors"| node_navigation
node_base_support -->|"composes runtime majors"| node_renderer
node_base_support -->|"composes runtime majors"| node_animation_audio
node_base_support -->|"composes runtime majors"| node_simulation
node_base_core -->|"underpins runtime"| node_runtime_support_node
node_runtime_support_node -->|"underpins framework"| node_framework_foundation

click node_base_core "https://github.com/immedved/epidemic/tree/main/EngineBase/Core/src"
click node_base_platform "https://github.com/immedved/epidemic/tree/main/EngineBase/Platform/src/Windows"
click node_base_input "https://github.com/immedved/epidemic/tree/main/EngineBase/Input/src"
click node_base_rhi "https://github.com/immedved/epidemic/tree/main/EngineBase/RHI/src"
click node_base_support "https://github.com/immedved/epidemic/tree/main/EngineBase/Support/src"
click node_resources "https://github.com/immedved/epidemic/blob/main/EngineRuntime/Resources/src/resource_manager.cpp"
click node_persistence "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Persistence/src"
click node_time_environment "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Environment/src"
click node_scene "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Scene/src"
click node_world "https://github.com/immedved/epidemic/tree/main/EngineRuntime/World/src"
click node_physics "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Physics/src"
click node_navigation "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Navigation/src"
click node_renderer "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Renderer/src"
click node_animation_audio "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Animation/src"
click node_simulation "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Simulation/src"
click node_runtime_support_node "https://github.com/immedved/epidemic/tree/main/EngineRuntime/Support/src"
click node_framework_foundation "https://github.com/immedved/epidemic/tree/main/EngineFramework/BaseInfrastructure/Foundation/src"
click node_gameplay_owners "https://github.com/immedved/epidemic/tree/main/EngineFramework/GameplayWorldStateOwners"
click node_framework_integrations "https://github.com/immedved/epidemic/tree/main/EngineFramework/IntegrationLayer"
click node_runtime_bridge "https://github.com/immedved/epidemic/tree/main/EngineFramework/RuntimeBoundary/RuntimeBridge/src"

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_base_core,node_base_platform,node_base_input,node_base_rhi,node_base_support toneBlue
class node_resources,node_persistence,node_time_environment,node_scene,node_world,node_physics,node_navigation,node_renderer,node_animation_audio,node_simulation toneAmber
class node_framework_foundation,node_gameplay_owners,node_framework_integrations,node_runtime_bridge toneMint
class node_runtime_support_node toneRose
class node_game_client toneIndigo
```

## Components

### EngineBase

- [Core lifecycle](https://github.com/immedved/epidemic/tree/main/EngineBase/Core/src): `EngineBase/Core/src`
- [Windows platform](https://github.com/immedved/epidemic/tree/main/EngineBase/Platform/src/Windows): `EngineBase/Platform/src/Windows`
- [Raw input](https://github.com/immedved/epidemic/tree/main/EngineBase/Input/src): `EngineBase/Input/src`
- [RHI backends](https://github.com/immedved/epidemic/tree/main/EngineBase/RHI/src): `EngineBase/RHI/src`
- [Base support](https://github.com/immedved/epidemic/tree/main/EngineBase/Support/src): `EngineBase/Support/src`

### EngineRuntime

- [Resources](https://github.com/immedved/epidemic/blob/main/EngineRuntime/Resources/src/resource_manager.cpp): `EngineRuntime/Resources/src/resource_manager.cpp`
- [Persistence](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Persistence/src): `EngineRuntime/Persistence/src`
- [Time and environment](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Environment/src): `EngineRuntime/Environment/src`
- [Scene](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Scene/src): `EngineRuntime/Scene/src`
- [World and streaming](https://github.com/immedved/epidemic/tree/main/EngineRuntime/World/src): `EngineRuntime/World/src`
- [Physics](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Physics/src): `EngineRuntime/Physics/src`
- [Navigation](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Navigation/src): `EngineRuntime/Navigation/src`
- [Renderer](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Renderer/src): `EngineRuntime/Renderer/src`
- [Animation and audio](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Animation/src): `EngineRuntime/Animation/src`
- [Simulation](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Simulation/src): `EngineRuntime/Simulation/src`

### GameFramework

- [Gameplay foundation](https://github.com/immedved/epidemic/tree/main/EngineFramework/BaseInfrastructure/Foundation/src): `EngineFramework/BaseInfrastructure/Foundation/src`
- [Gameplay systems](https://github.com/immedved/epidemic/tree/main/EngineFramework/GameplayWorldStateOwners): `EngineFramework/GameplayWorldStateOwners`
- [Gameplay adapters](https://github.com/immedved/epidemic/tree/main/EngineFramework/IntegrationLayer): `EngineFramework/IntegrationLayer`
- [Runtime bridge](https://github.com/immedved/epidemic/tree/main/EngineFramework/RuntimeBoundary/RuntimeBridge/src): `EngineFramework/RuntimeBoundary/RuntimeBridge/src`

### Runtime composition

- [Runtime support](https://github.com/immedved/epidemic/tree/main/EngineRuntime/Support/src): `EngineRuntime/Support/src`

### Other components

- **Game composition**

## Connections

- Game composition → Gameplay foundation: composes gameplay
- Gameplay foundation → Gameplay systems: supports systems
- Gameplay systems → Gameplay adapters: adapts domains
- Gameplay adapters → Runtime bridge: connects runtime
- Runtime bridge → World and streaming: uses world services (evidence: `EngineFramework/RuntimeBoundary/RuntimeBridge/src/engine_runtime_bridge_backend.h`)
- Runtime bridge → Physics: uses physics services (evidence: `EngineFramework/RuntimeBoundary/RuntimeBridge/src/engine_runtime_bridge_backend.h`)
- Runtime bridge → Navigation: uses navigation services (evidence: `EngineFramework/RuntimeBoundary/RuntimeBridge/src/engine_runtime_bridge_backend.h`)
- Runtime bridge → Time and environment: uses environment runtime (evidence: `EngineFramework/RuntimeBoundary/RuntimeBridge/src/engine_runtime_bridge_backend.h`)
- Gameplay foundation → Runtime bridge: bridges engine runtime
- Runtime bridge → Runtime support: consumes runtime contracts
- Core lifecycle → Windows platform: runs platform
- Core lifecycle → Raw input: hosts input
- Core lifecycle → RHI backends: hosts rendering
- Core lifecycle → Base support: uses support
- Base support → Resources: composes runtime majors
- Base support → Persistence: composes runtime majors
- Base support → Time and environment: composes runtime majors
- Base support → Scene: composes runtime majors
- Base support → World and streaming: composes runtime majors
- Base support → Physics: composes runtime majors
- Base support → Navigation: composes runtime majors
- Base support → Renderer: composes runtime majors
- Base support → Animation and audio: composes runtime majors
- Base support → Simulation: composes runtime majors
- Core lifecycle → Runtime support: underpins runtime
- Runtime support → Gameplay foundation: underpins framework
