# boomingtech/piccolo architecture

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

- Interactive diagram: https://gitdiagram.com/boomingtech/piccolo
- Repository: https://github.com/boomingtech/piccolo

## Overview

Piccolo is a game engine and editor. Its runtime loop starts shared systems, advances world and input logic, exchanges render data, renders a frame, and polls the window; editor scene tools add selection and transform manipulation. Physics, particles, asset/configuration management, and rendering are distinct runtime capabilities. The graph follows relationships visible in the supplied excerpts or SOURCE INDEX; unsampled subsystems are represented at their existing directory paths, with uncertain links omitted.

Main entry points: [`engine/source/runtime/engine.cpp`](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/engine.cpp) (Engine loop), [`engine/source/runtime/function/render/render_system.h`](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/render_system.h) (Render system), [`engine/source/runtime/function/render/render_pipeline.cpp`](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/render_pipeline.cpp) (Render pipeline), [`engine/source/runtime/function/physics/physics_manager.cpp`](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/physics/physics_manager.cpp) (Physics manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime Core"]
  node_engine["Engine loop<br/>[engine.cpp]"]
  node_context["Global systems<br/>[global_context.h]"]
  node_input["Input system<br/>[input_system.h]"]
  node_window["Window system<br/>[window_system.h]"]
end

subgraph group_world["World Simulation"]
  node_worldmanager["World manager<br/>[world_manager.h]"]
  node_physics["Physics manager"]
  node_physics_scene["Physics scenes<br/>[physics_scene.h]"]
  node_characters["Character control"]
  node_particles["Particle manager"]
end

subgraph group_render["Rendering"]
  node_render_system["Render system<br/>[render_system.h]"]
  node_pipeline["Render pipeline"]
  node_render_passes["Render passes"]
  node_debug_manager["Debug drawing"]
  node_debug_pipeline["Debug draw pipeline"]
  node_particle_pass["Particle pass<br/>[particle_pass.h]"]
end

subgraph group_resources["Resources"]
  node_assets["Asset manager<br/>[asset_manager.cpp]"]
  node_config["Config manager<br/>[config_manager.cpp]"]
end

subgraph group_editor["Editor"]
  node_editor_scene["Editor scene tools"]
  node_editor_input["Editor input"]
end

node_developer(("Game developer"))

node_developer -.->|"starts runtime"| node_engine
node_engine -->|"starts systems"| node_context
node_engine -->|"ticks world"| node_worldmanager
node_engine -->|"ticks input"| node_input
node_engine -->|"ticks renderer"| node_render_system
node_engine -->|"swaps render data"| node_render_system
node_engine -->|"polls events"| node_window
node_physics -->|"creates scenes"| node_physics_scene
node_physics -->|"gets active scene"| node_worldmanager
node_physics -->|"gets camera"| node_render_system
node_render_system -.->|"uses pipeline"| node_pipeline
node_pipeline -->|"initializes passes"| node_render_passes
node_pipeline -->|"initializes pass"| node_particle_pass
node_pipeline -->|"uses debug drawing"| node_debug_manager
node_debug_pipeline -->|"gets RHI"| node_render_system
node_particles -->|"initializes pass data"| node_particle_pass
node_particles -->|"loads assets"| node_assets
node_particles -->|"reads configuration"| node_config
node_editor_scene -->|"gets active level"| node_worldmanager
node_editor_scene -->|"queries picked mesh"| node_render_system
node_context -.->|"owns system"| node_assets
node_context -.->|"owns system"| node_config
node_editor_input -.->|"dispatches input"| node_editor_scene

click node_engine "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/engine.cpp"
click node_context "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/global/global_context.h"
click node_input "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/input/input_system.h"
click node_worldmanager "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/framework/world/world_manager.h"
click node_physics "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/physics/physics_manager.cpp"
click node_physics_scene "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/physics/physics_scene.h"
click node_characters "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/controller/character_controller.cpp"
click node_render_system "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/render_system.h"
click node_pipeline "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/render_pipeline.cpp"
click node_render_passes "https://github.com/boomingtech/piccolo/tree/main/engine/source/runtime/function/render/passes"
click node_debug_manager "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/debugdraw/debug_draw_manager.h"
click node_debug_pipeline "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/debugdraw/debug_draw_pipeline.cpp"
click node_assets "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/resource/asset_manager/asset_manager.cpp"
click node_config "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/resource/config_manager/config_manager.cpp"
click node_particles "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/particle/particle_manager.cpp"
click node_particle_pass "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/passes/particle_pass.h"
click node_editor_scene "https://github.com/boomingtech/piccolo/blob/main/engine/source/editor/source/editor_scene_manager.cpp"
click node_editor_input "https://github.com/boomingtech/piccolo/blob/main/engine/source/editor/source/editor_input_manager.cpp"
click node_window "https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/window_system.h"

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_engine,node_context,node_input,node_window toneBlue
class node_worldmanager,node_physics,node_physics_scene,node_characters,node_particles toneAmber
class node_render_system,node_pipeline,node_render_passes,node_debug_manager,node_debug_pipeline,node_particle_pass toneMint
class node_assets,node_config toneRose
class node_editor_scene,node_editor_input,node_developer toneIndigo
```

## Components

### Runtime Core

- [Engine loop](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/engine.cpp): `engine/source/runtime/engine.cpp`
- [Global systems](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/global/global_context.h): `engine/source/runtime/function/global/global_context.h`
- [Input system](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/input/input_system.h): `engine/source/runtime/function/input/input_system.h`
- [Window system](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/window_system.h): `engine/source/runtime/function/render/window_system.h`

### World Simulation

- [World manager](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/framework/world/world_manager.h): `engine/source/runtime/function/framework/world/world_manager.h`
- [Physics manager](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/physics/physics_manager.cpp): `engine/source/runtime/function/physics/physics_manager.cpp`
- [Physics scenes](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/physics/physics_scene.h): `engine/source/runtime/function/physics/physics_scene.h`
- [Character control](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/controller/character_controller.cpp): `engine/source/runtime/function/controller/character_controller.cpp`
- [Particle manager](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/particle/particle_manager.cpp): `engine/source/runtime/function/particle/particle_manager.cpp`

### Rendering

- [Render system](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/render_system.h): `engine/source/runtime/function/render/render_system.h`
- [Render pipeline](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/render_pipeline.cpp): `engine/source/runtime/function/render/render_pipeline.cpp`
- [Render passes](https://github.com/boomingtech/piccolo/tree/main/engine/source/runtime/function/render/passes): `engine/source/runtime/function/render/passes`
- [Debug drawing](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/debugdraw/debug_draw_manager.h): `engine/source/runtime/function/render/debugdraw/debug_draw_manager.h`
- [Debug draw pipeline](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/debugdraw/debug_draw_pipeline.cpp): `engine/source/runtime/function/render/debugdraw/debug_draw_pipeline.cpp`
- [Particle pass](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/function/render/passes/particle_pass.h): `engine/source/runtime/function/render/passes/particle_pass.h`

### Resources

- [Asset manager](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/resource/asset_manager/asset_manager.cpp): `engine/source/runtime/resource/asset_manager/asset_manager.cpp`
- [Config manager](https://github.com/boomingtech/piccolo/blob/main/engine/source/runtime/resource/config_manager/config_manager.cpp): `engine/source/runtime/resource/config_manager/config_manager.cpp`

### Editor

- [Editor scene tools](https://github.com/boomingtech/piccolo/blob/main/engine/source/editor/source/editor_scene_manager.cpp): `engine/source/editor/source/editor_scene_manager.cpp`
- [Editor input](https://github.com/boomingtech/piccolo/blob/main/engine/source/editor/source/editor_input_manager.cpp): `engine/source/editor/source/editor_input_manager.cpp`

### Other components

- **Game developer**

## Connections

- Game developer → Engine loop: starts runtime (evidence: `README.md`)
- Engine loop → Global systems: starts systems (evidence: `engine/source/runtime/engine.cpp`)
- Engine loop → World manager: ticks world (evidence: `engine/source/runtime/engine.cpp`)
- Engine loop → Input system: ticks input (evidence: `engine/source/runtime/engine.cpp`)
- Engine loop → Render system: ticks renderer (evidence: `engine/source/runtime/engine.cpp`)
- Engine loop → Render system: swaps render data (evidence: `engine/source/runtime/engine.cpp`)
- Engine loop → Window system: polls events (evidence: `engine/source/runtime/engine.cpp`)
- Physics manager → Physics scenes: creates scenes (evidence: `engine/source/runtime/function/physics/physics_manager.cpp`)
- Physics manager → World manager: gets active scene (evidence: `engine/source/runtime/function/physics/physics_manager.cpp`)
- Physics manager → Render system: gets camera (evidence: `engine/source/runtime/function/physics/physics_manager.cpp`)
- Render system → Render pipeline: uses pipeline
- Render pipeline → Render passes: initializes passes (evidence: `engine/source/runtime/function/render/render_pipeline.cpp`)
- Render pipeline → Particle pass: initializes pass (evidence: `engine/source/runtime/function/render/render_pipeline.cpp`)
- Render pipeline → Debug drawing: uses debug drawing (evidence: `engine/source/runtime/function/render/render_pipeline.cpp`)
- Debug draw pipeline → Render system: gets RHI (evidence: `engine/source/runtime/function/render/debugdraw/debug_draw_pipeline.cpp`)
- Particle manager → Particle pass: initializes pass data (evidence: `engine/source/runtime/function/particle/particle_manager.cpp`)
- Particle manager → Asset manager: loads assets (evidence: `engine/source/runtime/function/particle/particle_manager.cpp`)
- Particle manager → Config manager: reads configuration (evidence: `engine/source/runtime/function/particle/particle_manager.cpp`)
- Editor scene tools → World manager: gets active level (evidence: `engine/source/editor/source/editor_scene_manager.cpp`)
- Editor scene tools → Render system: queries picked mesh (evidence: `engine/source/editor/source/editor_scene_manager.cpp`)
- Global systems → Asset manager: owns system
- Global systems → Config manager: owns system
- Editor input → Editor scene tools: dispatches input
