# furkankirat/deepbound-engine-core architecture

> Architecture diagram of the GitHub repository furkankirat/deepbound-engine-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/furkankirat/deepbound-engine-core
- Repository: https://github.com/furkankirat/deepbound-engine-core

## Overview

DeepBound Engine Core is a custom, data-oriented game-engine framework, with Unity described as a runtime for rendering and deployment. Its principal workflow is creating entities, attaching components, and querying matching entities; separate capabilities provide spatial partitioning, struct-based event messaging, and generated serialization/config registries. The graph includes the sampled ECS and tooling dependencies. Physics and some generator behavior are represented from the README; their internal call relationships were not sampled.

Main entry points: [`Sources/Ecs/EcsWorld.cs`](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/EcsWorld.cs) (ECS world), [`Sources/Ecs/FilterBuilder.cs`](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/FilterBuilder.cs) (Filter builder), [`Sources/Ecs/EntityEnumerator.cs`](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/EntityEnumerator.cs) (Entity enumerator), [`Sources/Event/GameEventBus.cs`](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/GameEventBus.cs) (Game event bus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ecs["Entity Component System"]
  node_world["ECS world<br/>[EcsWorld.cs]"]
  node_mask["Component mask<br/>[ComponentMask.cs]"]
  node_typeids["Component type IDs<br/>[ComponentType.cs]"]
  node_component["Component contract<br/>[IComponent.cs]"]
  node_filter["Filter builder<br/>[FilterBuilder.cs]"]
  node_enumerator["Entity enumerator"]
  node_systemcontract["System contract<br/>[ISystem.cs]"]
end

subgraph group_physics["Spatial Physics"]
  node_grid["Spatial hash grid<br/>[SpatialGrid.cs]"]
end

subgraph group_messaging["Event Messaging"]
  node_eventbus["Game event bus<br/>[GameEventBus.cs]"]
  node_eventcontract["Event bus contract<br/>[IEventBus.cs]"]
  node_eventmarker["Event marker<br/>[IEvent.cs]"]
end

subgraph group_tooling["Editor Code Generation"]
  node_classbuilder["Fluent class builder<br/>[ClassBuilder.cs]"]
  node_saver["Component saver generator"]
  node_registry["Config registry generator"]
end

node_developer(("Game developer"))
node_systems(("Game systems"))

node_systems -->|"creates and queries"| node_world
node_developer -->|"uses spatial partitioning"| node_grid
node_developer -->|"publishes events"| node_eventbus
node_world -->|"updates masks"| node_mask
node_world -->|"gets type IDs"| node_typeids
node_world -->|"constrains components"| node_component
node_world -->|"creates filters"| node_filter
node_filter -->|"gets type IDs"| node_typeids
node_filter -->|"returns enumerator"| node_enumerator
node_enumerator -->|"reads entity masks"| node_world
node_enumerator -->|"checks matches"| node_mask
node_eventbus -->|"implements"| node_eventcontract
node_eventbus -->|"constrains events"| node_eventmarker
node_eventcontract -->|"constrains events"| node_eventmarker
node_saver -->|"builds saver classes"| node_classbuilder
node_saver -->|"discovers components"| node_component
node_registry -->|"builds registry code"| node_classbuilder

click node_world "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/EcsWorld.cs"
click node_mask "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/ComponentMask.cs"
click node_typeids "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/ComponentType.cs"
click node_component "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/IComponent.cs"
click node_filter "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/FilterBuilder.cs"
click node_enumerator "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/EntityEnumerator.cs"
click node_systemcontract "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/ISystem.cs"
click node_grid "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Physics/SpatialGrid.cs"
click node_eventbus "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/GameEventBus.cs"
click node_eventcontract "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/IEventBus.cs"
click node_eventmarker "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/IEvent.cs"
click node_classbuilder "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Editor/ClassBuilding/ClassBuilder.cs"
click node_saver "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Editor/Ecs/ComponentSaverGenerator.cs"
click node_registry "https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Editor/Ecs/ConfigRegistryGenerator.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_world,node_mask,node_typeids,node_component,node_filter,node_enumerator,node_systemcontract toneBlue
class node_grid toneAmber
class node_eventbus,node_eventcontract,node_eventmarker toneMint
class node_classbuilder,node_saver,node_registry toneRose
class node_developer,node_systems toneIndigo
```

## Components

### Entity Component System

- [ECS world](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/EcsWorld.cs): `Sources/Ecs/EcsWorld.cs`
- [Component mask](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/ComponentMask.cs): `Sources/Ecs/ComponentMask.cs`
- [Component type IDs](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/ComponentType.cs): `Sources/Ecs/ComponentType.cs`
- [Component contract](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/IComponent.cs): `Sources/Ecs/IComponent.cs`
- [Filter builder](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/FilterBuilder.cs): `Sources/Ecs/FilterBuilder.cs`
- [Entity enumerator](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/EntityEnumerator.cs): `Sources/Ecs/EntityEnumerator.cs`
- [System contract](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Ecs/ISystem.cs): `Sources/Ecs/ISystem.cs`

### Spatial Physics

- [Spatial hash grid](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Physics/SpatialGrid.cs): `Sources/Physics/SpatialGrid.cs`

### Event Messaging

- [Game event bus](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/GameEventBus.cs): `Sources/Event/GameEventBus.cs`
- [Event bus contract](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/IEventBus.cs): `Sources/Event/IEventBus.cs`
- [Event marker](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Event/IEvent.cs): `Sources/Event/IEvent.cs`

### Editor Code Generation

- [Fluent class builder](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Editor/ClassBuilding/ClassBuilder.cs): `Sources/Editor/ClassBuilding/ClassBuilder.cs`
- [Component saver generator](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Editor/Ecs/ComponentSaverGenerator.cs): `Sources/Editor/Ecs/ComponentSaverGenerator.cs`
- [Config registry generator](https://github.com/furkankirat/deepbound-engine-core/blob/main/Sources/Editor/Ecs/ConfigRegistryGenerator.cs): `Sources/Editor/Ecs/ConfigRegistryGenerator.cs`

### Other components

- **Game developer**
- **Game systems**

## Connections

- Game systems → ECS world: creates and queries (evidence: `README.md`)
- Game developer → Spatial hash grid: uses spatial partitioning (evidence: `README.md`)
- Game developer → Game event bus: publishes events (evidence: `README.md`)
- ECS world → Component mask: updates masks (evidence: `Sources/Ecs/EcsWorld.cs`)
- ECS world → Component type IDs: gets type IDs (evidence: `Sources/Ecs/EcsWorld.cs`)
- ECS world → Component contract: constrains components (evidence: `Sources/Ecs/EcsWorld.cs`)
- ECS world → Filter builder: creates filters (evidence: `Sources/Ecs/EcsWorld.cs`)
- Filter builder → Component type IDs: gets type IDs (evidence: `Sources/Ecs/FilterBuilder.cs`)
- Filter builder → Entity enumerator: returns enumerator (evidence: `Sources/Ecs/FilterBuilder.cs`)
- Entity enumerator → ECS world: reads entity masks (evidence: `Sources/Ecs/EntityEnumerator.cs`)
- Entity enumerator → Component mask: checks matches (evidence: `Sources/Ecs/EntityEnumerator.cs`)
- Game event bus → Event bus contract: implements (evidence: `Sources/Event/GameEventBus.cs`)
- Game event bus → Event marker: constrains events (evidence: `Sources/Event/GameEventBus.cs`)
- Event bus contract → Event marker: constrains events (evidence: `Sources/Event/IEventBus.cs`)
- Component saver generator → Fluent class builder: builds saver classes (evidence: `Sources/Editor/Ecs/ComponentSaverGenerator.cs`)
- Component saver generator → Component contract: discovers components (evidence: `Sources/Editor/Ecs/ComponentSaverGenerator.cs`)
- Config registry generator → Fluent class builder: builds registry code (evidence: `Sources/Editor/Ecs/ConfigRegistryGenerator.cs`)
