# godotengine/godot architecture

> Architecture diagram of the GitHub repository godotengine/godot, 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/godotengine/godot
- Repository: https://github.com/godotengine/godot
- Video tour (about a minute): https://gitdiagram.com/godotengine/godot/video

## Overview

Godot is a cross-platform 2D/3D game engine with a unified editor. The principal workflow is a user creating a game in the editor, running it through the engine, and exporting it to a target platform. Major product areas represented here include editing, animation, asset acquisition, debugging, rendering, and export, alongside core runtime services. The README documents the product workflow and export capability; most implementation relationships are not shown in the supplied excerpts, so unverified links are dashed and have no evidence path.

Main entry points: [`scene/main/scene_tree.h`](https://github.com/godotengine/godot/blob/master/scene/main/scene_tree.h) (Scene runtime), [`editor/editor_node.h`](https://github.com/godotengine/godot/blob/master/editor/editor_node.h) (Godot editor), [`main/main.cpp`](https://github.com/godotengine/godot/blob/master/main/main.cpp) (Engine startup), [`servers/rendering/rendering_server_globals.h`](https://github.com/godotengine/godot/blob/master/servers/rendering/rendering_server_globals.h) (Rendering server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edit["Game authoring"]
  node_editor["Godot editor<br/>[editor_node.h]"]
  node_scene_edit["Scene and project editing"]
  node_animation["Animation tools"]
  node_asset_library["Asset library"]
  node_editor_debug["Editor debugger"]
end

subgraph group_runtime["Engine runtime"]
  node_engine_entry["Engine startup<br/>[main.cpp]"]
  node_os["OS abstraction<br/>[os.h]"]
  node_engine["Engine settings and timing<br/>[engine.cpp]"]
  node_project_settings["Project settings<br/>[project_settings.h]"]
  node_resources["Resource loading<br/>[resource_loader.h]"]
  node_objects["Object and callable model<br/>[object.h]"]
  node_debugger["Runtime debugger"]
  node_display["Display and input<br/>[display_server.h]"]
  node_scene["Scene runtime<br/>[scene_tree.h]"]
  node_physics2d["2D physics"]
  node_physics3d["3D physics"]
  node_navigation["Navigation"]
end

subgraph group_render["Rendering"]
  node_render_server["Rendering server"]
  node_renderer_rd["Rendering device renderer"]
  node_renderer_gles["OpenGL renderer"]
end

subgraph group_platform["Platform delivery"]
  node_export["Platform export"]
  node_target_platform(("Export platform"))
end

node_user(("Game developer"))

node_user -->|"authors in"| node_editor
node_editor -.->|"provides editing"| node_scene_edit
node_editor -.->|"provides tools"| node_animation
node_editor -.->|"offers assets"| node_asset_library
node_editor -.->|"provides debugging"| node_editor_debug
node_user -.->|"runs game"| node_engine_entry
node_engine_entry -.->|"initializes platform"| node_os
node_engine_entry -.->|"starts runtime"| node_scene
node_scene -.->|"loads resources"| node_resources
node_scene -.->|"uses display"| node_display
node_scene -.->|"uses physics"| node_physics2d
node_scene -.->|"uses physics"| node_physics3d
node_scene -.->|"uses navigation"| node_navigation
node_engine -.->|"uses settings"| node_project_settings
node_engine -.->|"exposes engine APIs"| node_objects
node_engine_entry -.->|"enables debugging"| node_debugger
node_scene -.->|"submits rendering"| node_render_server
node_render_server -.->|"uses renderer"| node_renderer_rd
node_render_server -.->|"uses renderer"| node_renderer_gles
node_user -->|"exports game"| node_export
node_export -->|"produces build"| node_target_platform

click node_editor "https://github.com/godotengine/godot/blob/master/editor/editor_node.h"
click node_scene_edit "https://github.com/godotengine/godot/blob/master/editor/docks/filesystem_dock.cpp"
click node_animation "https://github.com/godotengine/godot/blob/master/editor/animation/animation_player_editor_plugin.cpp"
click node_asset_library "https://github.com/godotengine/godot/blob/master/editor/asset_library/asset_library_editor_plugin.cpp"
click node_editor_debug "https://github.com/godotengine/godot/blob/master/editor/debugger/debugger_editor_plugin.cpp"
click node_engine_entry "https://github.com/godotengine/godot/blob/master/main/main.cpp"
click node_os "https://github.com/godotengine/godot/blob/master/core/os/os.h"
click node_engine "https://github.com/godotengine/godot/blob/master/core/config/engine.cpp"
click node_project_settings "https://github.com/godotengine/godot/blob/master/core/config/project_settings.h"
click node_resources "https://github.com/godotengine/godot/blob/master/core/io/resource_loader.h"
click node_objects "https://github.com/godotengine/godot/blob/master/core/object/object.h"
click node_debugger "https://github.com/godotengine/godot/blob/master/core/debugger/engine_debugger.cpp"
click node_display "https://github.com/godotengine/godot/blob/master/servers/display/display_server.h"
click node_scene "https://github.com/godotengine/godot/blob/master/scene/main/scene_tree.h"
click node_physics2d "https://github.com/godotengine/godot/blob/master/servers/physics_2d/physics_server_2d_manager.cpp"
click node_physics3d "https://github.com/godotengine/godot/blob/master/servers/physics_3d/physics_server_3d_manager.cpp"
click node_navigation "https://github.com/godotengine/godot/blob/master/servers/navigation_3d/navigation_server_3d_manager.cpp"
click node_render_server "https://github.com/godotengine/godot/blob/master/servers/rendering/rendering_server_globals.h"
click node_renderer_rd "https://github.com/godotengine/godot/blob/master/servers/rendering/renderer_rd/storage_rd/texture_storage.cpp"
click node_renderer_gles "https://github.com/godotengine/godot/blob/master/drivers/gles3/storage/texture_storage.cpp"
click node_export "https://github.com/godotengine/godot/blob/master/editor/export/export_template_manager.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,node_scene_edit,node_animation,node_asset_library,node_editor_debug toneBlue
class node_engine_entry,node_os,node_engine,node_project_settings,node_resources,node_objects,node_debugger,node_display,node_scene,node_physics2d,node_physics3d,node_navigation toneAmber
class node_render_server,node_renderer_rd,node_renderer_gles toneMint
class node_export,node_target_platform toneRose
class node_user toneIndigo
```

## Components

### Game authoring

- [Godot editor](https://github.com/godotengine/godot/blob/master/editor/editor_node.h): `editor/editor_node.h`
- [Scene and project editing](https://github.com/godotengine/godot/blob/master/editor/docks/filesystem_dock.cpp): `editor/docks/filesystem_dock.cpp`
- [Animation tools](https://github.com/godotengine/godot/blob/master/editor/animation/animation_player_editor_plugin.cpp): `editor/animation/animation_player_editor_plugin.cpp`
- [Asset library](https://github.com/godotengine/godot/blob/master/editor/asset_library/asset_library_editor_plugin.cpp): `editor/asset_library/asset_library_editor_plugin.cpp`
- [Editor debugger](https://github.com/godotengine/godot/blob/master/editor/debugger/debugger_editor_plugin.cpp): `editor/debugger/debugger_editor_plugin.cpp`

### Engine runtime

- [Engine startup](https://github.com/godotengine/godot/blob/master/main/main.cpp): `main/main.cpp`
- [OS abstraction](https://github.com/godotengine/godot/blob/master/core/os/os.h): `core/os/os.h`
- [Engine settings and timing](https://github.com/godotengine/godot/blob/master/core/config/engine.cpp): `core/config/engine.cpp`
- [Project settings](https://github.com/godotengine/godot/blob/master/core/config/project_settings.h): `core/config/project_settings.h`
- [Resource loading](https://github.com/godotengine/godot/blob/master/core/io/resource_loader.h): `core/io/resource_loader.h`
- [Object and callable model](https://github.com/godotengine/godot/blob/master/core/object/object.h): `core/object/object.h`
- [Runtime debugger](https://github.com/godotengine/godot/blob/master/core/debugger/engine_debugger.cpp): `core/debugger/engine_debugger.cpp`
- [Display and input](https://github.com/godotengine/godot/blob/master/servers/display/display_server.h): `servers/display/display_server.h`
- [Scene runtime](https://github.com/godotengine/godot/blob/master/scene/main/scene_tree.h): `scene/main/scene_tree.h`
- [2D physics](https://github.com/godotengine/godot/blob/master/servers/physics_2d/physics_server_2d_manager.cpp): `servers/physics_2d/physics_server_2d_manager.cpp`
- [3D physics](https://github.com/godotengine/godot/blob/master/servers/physics_3d/physics_server_3d_manager.cpp): `servers/physics_3d/physics_server_3d_manager.cpp`
- [Navigation](https://github.com/godotengine/godot/blob/master/servers/navigation_3d/navigation_server_3d_manager.cpp): `servers/navigation_3d/navigation_server_3d_manager.cpp`

### Rendering

- [Rendering server](https://github.com/godotengine/godot/blob/master/servers/rendering/rendering_server_globals.h): `servers/rendering/rendering_server_globals.h`
- [Rendering device renderer](https://github.com/godotengine/godot/blob/master/servers/rendering/renderer_rd/storage_rd/texture_storage.cpp): `servers/rendering/renderer_rd/storage_rd/texture_storage.cpp`
- [OpenGL renderer](https://github.com/godotengine/godot/blob/master/drivers/gles3/storage/texture_storage.cpp): `drivers/gles3/storage/texture_storage.cpp`

### Platform delivery

- [Platform export](https://github.com/godotengine/godot/blob/master/editor/export/export_template_manager.cpp): `editor/export/export_template_manager.cpp`
- **Export platform**

### Other components

- **Game developer**

## Connections

- Game developer → Godot editor: authors in (evidence: `README.md`)
- Godot editor → Scene and project editing: provides editing
- Godot editor → Animation tools: provides tools
- Godot editor → Asset library: offers assets
- Godot editor → Editor debugger: provides debugging
- Game developer → Engine startup: runs game
- Engine startup → OS abstraction: initializes platform (evidence: `main/main.cpp`)
- Engine startup → Scene runtime: starts runtime (evidence: `main/main.cpp`)
- Scene runtime → Resource loading: loads resources
- Scene runtime → Display and input: uses display
- Scene runtime → 2D physics: uses physics
- Scene runtime → 3D physics: uses physics
- Scene runtime → Navigation: uses navigation
- Engine settings and timing → Project settings: uses settings (evidence: `core/config/engine.cpp`)
- Engine settings and timing → Object and callable model: exposes engine APIs (evidence: `core/config/engine.cpp`)
- Engine startup → Runtime debugger: enables debugging
- Scene runtime → Rendering server: submits rendering
- Rendering server → Rendering device renderer: uses renderer (evidence: `servers/rendering/renderer_rd/storage_rd/texture_storage.cpp`)
- Rendering server → OpenGL renderer: uses renderer
- Game developer → Platform export: exports game (evidence: `README.md`)
- Platform export → Export platform: produces build (evidence: `README.md`)
