# jonathspirit/fastengine architecture

> Architecture diagram of the GitHub repository jonathspirit/fastengine, 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/jonathspirit/fastengine
- Repository: https://github.com/jonathspirit/fastengine

## Overview

FastEngine is a C++ framework for 2D-focused, multiplayer-capable games and software, built over Vulkan. A typical application builds a scene from engine objects and graphics/UI features, then renders it; multiplayer applications synchronize scenes through the networking facilities. The README also highlights tilemaps and pathfinding, lighting, text, sprite rendering, and mipmaps. The graph preserves those capabilities, but sampled source is limited, so most subsystem links reflect README-level descriptions rather than verified implementation calls.

Main entry points: [`includes/FastEngine/C_scene.hpp`](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/C_scene.hpp) (Scene runtime), [`includes/FastEngine/graphic/C_renderTarget.hpp`](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/graphic/C_renderTarget.hpp) (Render target), [`includes/FastEngine/manager/network_manager.hpp`](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/network_manager.hpp) (Network manager), [`includes/FastEngine/manager/C_baseManager.hpp`](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/C_baseManager.hpp) (Resource managers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scene["Scenes and objects"]
  node_scene_runtime["Scene runtime<br/>[C_scene.hpp]"]
  node_objects["Scene objects"]
  node_gui["GUI and windows<br/>[C_objWindow.hpp]"]
  node_lighting["Lighting and shapes<br/>[C_lightSystem.hpp]"]
  node_tilemap["Tilemaps<br/>[C_tilemap.hpp]"]
end

subgraph group_graphics["Graphics and Vulkan"]
  node_render_target["Render target<br/>[C_renderTarget.hpp]"]
  node_render_objects["Sprites and text<br/>[C_objSprite.hpp]"]
  node_vulkan_context["Vulkan context<br/>[C_context.hpp]"]
  node_pipelines["Graphics pipelines"]
  node_shader_manager["Shader resources<br/>[shader_manager.hpp]"]
end

subgraph group_network["Networking"]
  node_network_manager["Network manager"]
  node_client["Network client<br/>[C_client.hpp]"]
  node_server["Network server<br/>[C_server.hpp]"]
  node_protocol["Protocol and packets<br/>[C_protocol.hpp]"]
end

subgraph group_resources["Resources and utilities"]
  node_pathfinding["Pathfinding"]
  node_resource_managers["Resource managers<br/>[C_baseManager.hpp]"]
  node_animation["Animation resources"]
  node_audio["Audio resources<br/>[audio_manager.cpp]"]
  node_utilities["Engine utilities<br/>[extra_function.hpp]"]
end

node_developer(("Application developer"))

node_developer -->|"builds scenes"| node_scene_runtime
node_scene_runtime -->|"contains scene objects"| node_objects
node_scene_runtime -->|"renders scene"| node_render_target
node_scene_runtime -->|"synchronizes scenes"| node_network_manager
node_scene_runtime -->|"uses GUI"| node_gui
node_scene_runtime -->|"uses lighting"| node_lighting
node_scene_runtime -->|"uses tilemaps"| node_tilemap
node_tilemap -->|"supports pathfinding"| node_pathfinding
node_render_target -->|"draws sprites and text"| node_render_objects
node_render_target -->|"uses Vulkan"| node_vulkan_context
node_vulkan_context -->|"creates pipelines"| node_pipelines
node_shader_manager -.->|"provides shaders"| node_pipelines
node_network_manager -.->|"manages networking"| node_client
node_network_manager -.->|"manages networking"| node_server
node_client -->|"packs protocol data"| node_protocol
node_server -->|"uses protocol"| node_protocol
node_resource_managers -.->|"manages animations"| node_animation
node_resource_managers -.->|"manages audio"| node_audio
node_render_objects -.->|"uses animations"| node_animation

click node_scene_runtime "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/C_scene.hpp"
click node_objects "https://github.com/jonathspirit/fastengine/tree/master/includes/FastEngine/object"
click node_gui "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/object/C_objWindow.hpp"
click node_lighting "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/object/C_lightSystem.hpp"
click node_tilemap "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/C_tilemap.hpp"
click node_pathfinding "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/extra/extra_pathFinding.hpp"
click node_render_target "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/graphic/C_renderTarget.hpp"
click node_render_objects "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/object/C_objSprite.hpp"
click node_vulkan_context "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/vulkan/C_context.hpp"
click node_pipelines "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/vulkan/C_graphicPipeline.hpp"
click node_shader_manager "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/shader_manager.hpp"
click node_network_manager "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/network_manager.hpp"
click node_client "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/network/C_client.hpp"
click node_server "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/network/C_server.hpp"
click node_protocol "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/network/C_protocol.hpp"
click node_resource_managers "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/C_baseManager.hpp"
click node_audio "https://github.com/jonathspirit/fastengine/blob/master/sources/manager/audio_manager.cpp"
click node_utilities "https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/extra/extra_function.hpp"

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_scene_runtime,node_objects,node_gui,node_lighting,node_tilemap toneBlue
class node_render_target,node_render_objects,node_vulkan_context,node_pipelines,node_shader_manager toneAmber
class node_network_manager,node_client,node_server,node_protocol toneMint
class node_pathfinding,node_resource_managers,node_animation,node_audio,node_utilities toneRose
class node_developer toneIndigo
```

## Components

### Scenes and objects

- [Scene runtime](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/C_scene.hpp): `includes/FastEngine/C_scene.hpp`
- [Scene objects](https://github.com/jonathspirit/fastengine/tree/master/includes/FastEngine/object): `includes/FastEngine/object`
- [GUI and windows](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/object/C_objWindow.hpp): `includes/FastEngine/object/C_objWindow.hpp`
- [Lighting and shapes](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/object/C_lightSystem.hpp): `includes/FastEngine/object/C_lightSystem.hpp`
- [Tilemaps](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/C_tilemap.hpp): `includes/FastEngine/C_tilemap.hpp`

### Graphics and Vulkan

- [Render target](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/graphic/C_renderTarget.hpp): `includes/FastEngine/graphic/C_renderTarget.hpp`
- [Sprites and text](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/object/C_objSprite.hpp): `includes/FastEngine/object/C_objSprite.hpp`
- [Vulkan context](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/vulkan/C_context.hpp): `includes/FastEngine/vulkan/C_context.hpp`
- [Graphics pipelines](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/vulkan/C_graphicPipeline.hpp): `includes/FastEngine/vulkan/C_graphicPipeline.hpp`
- [Shader resources](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/shader_manager.hpp): `includes/FastEngine/manager/shader_manager.hpp`

### Networking

- [Network manager](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/network_manager.hpp): `includes/FastEngine/manager/network_manager.hpp`
- [Network client](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/network/C_client.hpp): `includes/FastEngine/network/C_client.hpp`
- [Network server](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/network/C_server.hpp): `includes/FastEngine/network/C_server.hpp`
- [Protocol and packets](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/network/C_protocol.hpp): `includes/FastEngine/network/C_protocol.hpp`

### Resources and utilities

- [Pathfinding](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/extra/extra_pathFinding.hpp): `includes/FastEngine/extra/extra_pathFinding.hpp`
- [Resource managers](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/manager/C_baseManager.hpp): `includes/FastEngine/manager/C_baseManager.hpp`
- **Animation resources**
- [Audio resources](https://github.com/jonathspirit/fastengine/blob/master/sources/manager/audio_manager.cpp): `sources/manager/audio_manager.cpp`
- [Engine utilities](https://github.com/jonathspirit/fastengine/blob/master/includes/FastEngine/extra/extra_function.hpp): `includes/FastEngine/extra/extra_function.hpp`

### Other components

- **Application developer**

## Connections

- Application developer → Scene runtime: builds scenes
- Scene runtime → Scene objects: contains scene objects (evidence: `includes/FastEngine/C_scene.hpp`)
- Scene runtime → Render target: renders scene (evidence: `includes/FastEngine/C_scene.hpp`)
- Scene runtime → Network manager: synchronizes scenes (evidence: `includes/FastEngine/manager/network_manager.hpp`)
- Scene runtime → GUI and windows: uses GUI
- Scene runtime → Lighting and shapes: uses lighting
- Scene runtime → Tilemaps: uses tilemaps
- Tilemaps → Pathfinding: supports pathfinding
- Render target → Sprites and text: draws sprites and text
- Render target → Vulkan context: uses Vulkan (evidence: `sources/graphic/C_renderTarget.cpp`)
- Vulkan context → Graphics pipelines: creates pipelines (evidence: `includes/FastEngine/vulkan/C_context.hpp`)
- Shader resources → Graphics pipelines: provides shaders
- Network manager → Network client: manages networking
- Network manager → Network server: manages networking
- Network client → Protocol and packets: packs protocol data (evidence: `includes/FastEngine/network/C_client.hpp`)
- Network server → Protocol and packets: uses protocol (evidence: `includes/FastEngine/network/C_server.hpp`)
- Resource managers → Animation resources: manages animations
- Resource managers → Audio resources: manages audio
- Sprites and text → Animation resources: uses animations
