# heitorasm/prism-engine architecture

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

- Interactive diagram: https://gitdiagram.com/heitorasm/prism-engine
- Repository: https://github.com/heitorasm/prism-engine

## Overview

Prism is a C++ 3D engine with an integrated editor and a standalone runtime. The main workflow is to open a project, edit scenes and assets in the editor, then play or export the project for runtime use. During play, scene systems provide rendering, physics, scripting, audio, animation, particles, and UI. The graph preserves these documented capabilities; several engine integrations are represented at their source-directory level because their implementation files were not sampled.

Main entry points: [`Prism/src/Prism/Scene/Scene.h`](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/Scene.h) (Scene and entities), [`Prism/src/Prism/Scripting/ScriptEngine.cpp`](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scripting/ScriptEngine.cpp) (Lua scripting), [`Prism/src/Prism/Core/Application.cpp`](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Core/Application.cpp) (Engine application), [`PrismEditor/src/PrismEditor/Layers/ProjectManagerLayer.cpp`](https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Layers/ProjectManagerLayer.cpp) (Project manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Editor"]
  node_editor_app["Editor app<br/>[EditorApp.cpp]"]
  node_project_manager["Project manager"]
  node_editor_layer["Scene editor<br/>[EditorLayer.cpp]"]
  node_editor_tools["Editor tools<br/>[EditorCommands.h]"]
  node_game_panel["Play window<br/>[PlayWindow.cpp]"]
end

subgraph group_project["Projects and scenes"]
  node_project_data["Project data<br/>[Project.h]"]
  node_project_files["Project serialization"]
  node_scene["Scene and entities<br/>[Scene.h]"]
  node_scene_formats["Scene formats"]
  node_prefabs["Prefabs"]
end

subgraph group_runtime["Runtime systems"]
  node_runtime_app["Standalone runtime<br/>[RuntimeApp.cpp]"]
  node_runtime_layer["Runtime layer<br/>[RuntimeLayer.cpp]"]
  node_physics["Physics<br/>[PhysicsEngine.cpp]"]
  node_lua["Lua scripting<br/>[ScriptEngine.cpp]"]
  node_native_scripts["Native scripts<br/>[NativeScripting.h]"]
  node_audio["Audio<br/>[AudioEngine.cpp]"]
  node_animation["Animation"]
  node_particles["Particles<br/>[ParticleSystem.cpp]"]
  node_ui["In-game UI<br/>[UISystem.h]"]
  node_extensions["Extensions"]
end

subgraph group_render["Rendering"]
  node_renderer["Renderer<br/>[Renderer.h]"]
end

subgraph group_engine["Engine foundation"]
  node_application["Engine application<br/>[Application.cpp]"]
end

node_user(("Developer"))

node_user -->|"opens editor"| node_editor_app
node_editor_app -->|"starts with"| node_project_manager
node_project_manager -->|"opens project"| node_editor_layer
node_editor_layer -->|"edits scene"| node_editor_tools
node_editor_layer -->|"plays scene"| node_game_panel
node_project_manager -->|"creates or opens"| node_project_data
node_project_data -->|"stores project"| node_project_files
node_editor_tools -->|"edits entities"| node_scene
node_scene -->|"serializes maps"| node_scene_formats
node_scene -->|"uses prefabs"| node_prefabs
node_user -->|"runs project"| node_runtime_app
node_runtime_app -->|"starts"| node_runtime_layer
node_runtime_layer -->|"runs project scene"| node_scene
node_application -->|"uses"| node_renderer
node_application -->|"initializes"| node_lua
node_application -->|"initializes"| node_audio
node_lua -->|"exposes physics"| node_physics
node_lua -->|"exposes audio"| node_audio
node_lua -->|"exposes animation"| node_animation
node_lua -->|"exposes particles"| node_particles
node_lua -->|"exposes UI"| node_ui
node_scene -->|"simulates bodies"| node_physics
node_scene -->|"runs scripts"| node_lua
node_scene -->|"starts audio"| node_audio
node_user -.->|"extends engine"| node_extensions
node_user -->|"adds native scripts"| node_native_scripts

click node_editor_app "https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/EditorApp.cpp"
click node_project_manager "https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Layers/ProjectManagerLayer.cpp"
click node_editor_layer "https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Layers/EditorLayer.cpp"
click node_editor_tools "https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Commands/EditorCommands.h"
click node_game_panel "https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Play/PlayWindow.cpp"
click node_project_data "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Project/Project.h"
click node_project_files "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Project/ProjectSerializer.cpp"
click node_scene "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/Scene.h"
click node_scene_formats "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/SceneSerializer.cpp"
click node_prefabs "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/PrefabSerializer.cpp"
click node_application "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Core/Application.cpp"
click node_runtime_app "https://github.com/heitorasm/prism-engine/blob/master/PrismRuntime/src/RuntimeApp.cpp"
click node_runtime_layer "https://github.com/heitorasm/prism-engine/blob/master/PrismRuntime/src/RuntimeLayer.cpp"
click node_renderer "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Renderer/Renderer.h"
click node_physics "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Physics/PhysicsEngine.cpp"
click node_lua "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scripting/ScriptEngine.cpp"
click node_native_scripts "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scripting/NativeScripting.h"
click node_audio "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Audio/AudioEngine.cpp"
click node_animation "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Animation/AnimationSystem.cpp"
click node_particles "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Particles/ParticleSystem.cpp"
click node_ui "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/UI/UISystem.h"
click node_extensions "https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Extensions/ExtensionLoader.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_editor_app,node_project_manager,node_editor_layer,node_editor_tools,node_game_panel toneBlue
class node_project_data,node_project_files,node_scene,node_scene_formats,node_prefabs toneAmber
class node_runtime_app,node_runtime_layer,node_physics,node_lua,node_native_scripts,node_audio,node_animation,node_particles,node_ui,node_extensions toneMint
class node_renderer toneRose
class node_application,node_user toneIndigo
```

## Components

### Editor

- [Editor app](https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/EditorApp.cpp): `PrismEditor/src/EditorApp.cpp`
- [Project manager](https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Layers/ProjectManagerLayer.cpp): `PrismEditor/src/PrismEditor/Layers/ProjectManagerLayer.cpp`
- [Scene editor](https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Layers/EditorLayer.cpp): `PrismEditor/src/PrismEditor/Layers/EditorLayer.cpp`
- [Editor tools](https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Commands/EditorCommands.h): `PrismEditor/src/PrismEditor/Commands/EditorCommands.h`
- [Play window](https://github.com/heitorasm/prism-engine/blob/master/PrismEditor/src/PrismEditor/Play/PlayWindow.cpp): `PrismEditor/src/PrismEditor/Play/PlayWindow.cpp`

### Projects and scenes

- [Project data](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Project/Project.h): `Prism/src/Prism/Project/Project.h`
- [Project serialization](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Project/ProjectSerializer.cpp): `Prism/src/Prism/Project/ProjectSerializer.cpp`
- [Scene and entities](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/Scene.h): `Prism/src/Prism/Scene/Scene.h`
- [Scene formats](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/SceneSerializer.cpp): `Prism/src/Prism/Scene/SceneSerializer.cpp`
- [Prefabs](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scene/PrefabSerializer.cpp): `Prism/src/Prism/Scene/PrefabSerializer.cpp`

### Runtime systems

- [Standalone runtime](https://github.com/heitorasm/prism-engine/blob/master/PrismRuntime/src/RuntimeApp.cpp): `PrismRuntime/src/RuntimeApp.cpp`
- [Runtime layer](https://github.com/heitorasm/prism-engine/blob/master/PrismRuntime/src/RuntimeLayer.cpp): `PrismRuntime/src/RuntimeLayer.cpp`
- [Physics](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Physics/PhysicsEngine.cpp): `Prism/src/Prism/Physics/PhysicsEngine.cpp`
- [Lua scripting](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scripting/ScriptEngine.cpp): `Prism/src/Prism/Scripting/ScriptEngine.cpp`
- [Native scripts](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Scripting/NativeScripting.h): `Prism/src/Prism/Scripting/NativeScripting.h`
- [Audio](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Audio/AudioEngine.cpp): `Prism/src/Prism/Audio/AudioEngine.cpp`
- [Animation](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Animation/AnimationSystem.cpp): `Prism/src/Prism/Animation/AnimationSystem.cpp`
- [Particles](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Particles/ParticleSystem.cpp): `Prism/src/Prism/Particles/ParticleSystem.cpp`
- [In-game UI](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/UI/UISystem.h): `Prism/src/Prism/UI/UISystem.h`
- [Extensions](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Extensions/ExtensionLoader.cpp): `Prism/src/Prism/Extensions/ExtensionLoader.cpp`

### Rendering

- [Renderer](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Renderer/Renderer.h): `Prism/src/Prism/Renderer/Renderer.h`

### Engine foundation

- [Engine application](https://github.com/heitorasm/prism-engine/blob/master/Prism/src/Prism/Core/Application.cpp): `Prism/src/Prism/Core/Application.cpp`

### Other components

- **Developer**

## Connections

- Developer → Editor app: opens editor (evidence: `README.md`)
- Editor app → Project manager: starts with (evidence: `PrismEditor/src/EditorApp.cpp`)
- Project manager → Scene editor: opens project (evidence: `PrismEditor/src/PrismEditor/Layers/ProjectManagerLayer.cpp`)
- Scene editor → Editor tools: edits scene (evidence: `README.md`)
- Scene editor → Play window: plays scene (evidence: `README.md`)
- Project manager → Project data: creates or opens (evidence: `README.md`)
- Project data → Project serialization: stores project (evidence: `README.md`)
- Editor tools → Scene and entities: edits entities (evidence: `README.md`)
- Scene and entities → Scene formats: serializes maps (evidence: `README.md`)
- Scene and entities → Prefabs: uses prefabs (evidence: `README.md`)
- Developer → Standalone runtime: runs project (evidence: `README.md`)
- Standalone runtime → Runtime layer: starts (evidence: `PrismRuntime/src/RuntimeApp.cpp`)
- Runtime layer → Scene and entities: runs project scene (evidence: `README.md`)
- Engine application → Renderer: uses (evidence: `Prism/src/Prism/Core/Application.cpp`)
- Engine application → Lua scripting: initializes (evidence: `Prism/src/Prism/Core/Application.cpp`)
- Engine application → Audio: initializes (evidence: `Prism/src/Prism/Core/Application.cpp`)
- Lua scripting → Physics: exposes physics (evidence: `Prism/src/Prism/Scripting/ScriptEngine.cpp`)
- Lua scripting → Audio: exposes audio (evidence: `Prism/src/Prism/Scripting/ScriptEngine.cpp`)
- Lua scripting → Animation: exposes animation (evidence: `Prism/src/Prism/Scripting/ScriptEngine.cpp`)
- Lua scripting → Particles: exposes particles (evidence: `Prism/src/Prism/Scripting/ScriptEngine.cpp`)
- Lua scripting → In-game UI: exposes UI (evidence: `Prism/src/Prism/Scripting/ScriptEngine.cpp`)
- Scene and entities → Physics: simulates bodies (evidence: `Prism/src/Prism/Physics/PhysicsEngine.cpp`)
- Scene and entities → Lua scripting: runs scripts (evidence: `Prism/src/Prism/Scripting/ScriptEngine.cpp`)
- Scene and entities → Audio: starts audio (evidence: `Prism/src/Prism/Audio/AudioEngine.cpp`)
- Developer → Extensions: extends engine (evidence: `README.md`)
- Developer → Native scripts: adds native scripts (evidence: `README.md`)
