# valtogameengines/cryengine architecture

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

- Interactive diagram: https://gitdiagram.com/valtogameengines/cryengine
- Repository: https://github.com/valtogameengines/cryengine

## Overview

CRYENGINE is a game engine and development platform. A representative workflow is an editor or game runtime loading a level, coordinating world and navigation systems, and producing a rendered scene; engine clients also use query, particle, and managed-runtime facilities. The graph highlights those distinct subsystems and the world-management layer rather than attempting to inventory the full repository. Several subsystems are represented from the file tree or SOURCE INDEX rather than inspected implementation excerpts, so only documented or indexed relationships are connected.

Main entry points: [`Code/CryEngine/Cry3DEngine/3dEngine.cpp`](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/3dEngine.cpp) (3D Engine), [`Code/CryEngine/CryAISystem/Navigation/NavigationSystem/NavigationSystem.h`](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/CryAISystem/Navigation/NavigationSystem/NavigationSystem.h) (Navigation System), [`Code/Sandbox/EditorQt/GameEngine.cpp`](https://github.com/valtogameengines/cryengine/blob/release/Code/Sandbox/EditorQt/GameEngine.cpp) (Editor Engine), [`Code/CryEngine/CryAISystem/Navigation/MNM/NavMeshQueryManager.cpp`](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/CryAISystem/Navigation/MNM/NavMeshQueryManager.cpp) (Nav Queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_world["World and Rendering"]
  node_engine["3D Engine<br/>[3dEngine.cpp]"]
  node_object_manager["Object Manager<br/>[ObjMan.cpp]"]
  node_spatial_tree["Objects Tree<br/>[ObjectsTree.cpp]"]
  node_merged_mesh["Merged Meshes"]
  node_terrain["Terrain<br/>[terrain.cpp]"]
  node_materials["Materials<br/>[MatMan.cpp]"]
  node_asset_loader["CGF Assets<br/>[CGFLoader.cpp]"]
end

subgraph group_ai["AI and Navigation"]
  node_navigation["Navigation System<br/>[NavigationSystem.h]"]
  node_nav_queries["Nav Queries"]
  node_uqs["Query Manager<br/>[QueryManager.cpp]"]
end

subgraph group_runtime["Runtime Services"]
  node_particles["Particle Runtime<br/>[ParticleSystem.cpp]"]
  node_managed_engine["Managed Engine API<br/>[Engine.cs]"]
  node_game["Game Systems<br/>[Game.h]"]
end

subgraph group_tools["Editor and Tools"]
  node_editor["Editor Engine<br/>[GameEngine.cpp]"]
end

node_engine_user(("Engine Client"))

node_editor -->|"initializes"| node_navigation
node_editor -->|"generates meshes"| node_navigation
node_engine_user -.->|"uses"| node_engine
node_engine -->|"references"| node_object_manager
node_engine -->|"references"| node_spatial_tree
node_engine -->|"references"| node_terrain
node_engine -->|"references"| node_materials
node_engine -->|"references"| node_asset_loader
node_nav_queries -->|"uses"| node_navigation
node_engine_user -.->|"submits queries"| node_uqs
node_managed_engine -->|"exposes access"| node_particles
node_game -.->|"uses"| node_engine

click node_editor "https://github.com/valtogameengines/cryengine/blob/release/Code/Sandbox/EditorQt/GameEngine.cpp"
click node_engine "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/3dEngine.cpp"
click node_object_manager "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/ObjMan.cpp"
click node_spatial_tree "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/ObjectsTree.cpp"
click node_merged_mesh "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/MergedMeshRenderNode.cpp"
click node_terrain "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/terrain.cpp"
click node_materials "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/MatMan.cpp"
click node_asset_loader "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/CGF/CGFLoader.cpp"
click node_navigation "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/CryAISystem/Navigation/NavigationSystem/NavigationSystem.h"
click node_nav_queries "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/CryAISystem/Navigation/MNM/NavMeshQueryManager.cpp"
click node_uqs "https://github.com/valtogameengines/cryengine/blob/release/Code/CryPlugins/CryUQS/Core/core/QueryManager.cpp"
click node_particles "https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/ParticleSystem/ParticleSystem.cpp"
click node_managed_engine "https://github.com/valtogameengines/cryengine/blob/release/Code/CryManaged/CESharp/Core/Engine.cs"
click node_game "https://github.com/valtogameengines/cryengine/blob/release/Code/GameSDK/GameDll/Game.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_object_manager,node_spatial_tree,node_merged_mesh,node_terrain,node_materials,node_asset_loader,node_engine_user toneBlue
class node_navigation,node_nav_queries,node_uqs toneAmber
class node_particles,node_managed_engine,node_game toneMint
class node_editor toneRose
```

## Components

### World and Rendering

- [3D Engine](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/3dEngine.cpp): `Code/CryEngine/Cry3DEngine/3dEngine.cpp`
- [Object Manager](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/ObjMan.cpp): `Code/CryEngine/Cry3DEngine/ObjMan.cpp`
- [Objects Tree](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/ObjectsTree.cpp): `Code/CryEngine/Cry3DEngine/ObjectsTree.cpp`
- [Merged Meshes](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/MergedMeshRenderNode.cpp): `Code/CryEngine/Cry3DEngine/MergedMeshRenderNode.cpp`
- [Terrain](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/terrain.cpp): `Code/CryEngine/Cry3DEngine/terrain.cpp`
- [Materials](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/MatMan.cpp): `Code/CryEngine/Cry3DEngine/MatMan.cpp`
- [CGF Assets](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/CGF/CGFLoader.cpp): `Code/CryEngine/Cry3DEngine/CGF/CGFLoader.cpp`

### AI and Navigation

- [Navigation System](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/CryAISystem/Navigation/NavigationSystem/NavigationSystem.h): `Code/CryEngine/CryAISystem/Navigation/NavigationSystem/NavigationSystem.h`
- [Nav Queries](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/CryAISystem/Navigation/MNM/NavMeshQueryManager.cpp): `Code/CryEngine/CryAISystem/Navigation/MNM/NavMeshQueryManager.cpp`
- [Query Manager](https://github.com/valtogameengines/cryengine/blob/release/Code/CryPlugins/CryUQS/Core/core/QueryManager.cpp): `Code/CryPlugins/CryUQS/Core/core/QueryManager.cpp`

### Runtime Services

- [Particle Runtime](https://github.com/valtogameengines/cryengine/blob/release/Code/CryEngine/Cry3DEngine/ParticleSystem/ParticleSystem.cpp): `Code/CryEngine/Cry3DEngine/ParticleSystem/ParticleSystem.cpp`
- [Managed Engine API](https://github.com/valtogameengines/cryengine/blob/release/Code/CryManaged/CESharp/Core/Engine.cs): `Code/CryManaged/CESharp/Core/Engine.cs`
- [Game Systems](https://github.com/valtogameengines/cryengine/blob/release/Code/GameSDK/GameDll/Game.h): `Code/GameSDK/GameDll/Game.h`

### Editor and Tools

- [Editor Engine](https://github.com/valtogameengines/cryengine/blob/release/Code/Sandbox/EditorQt/GameEngine.cpp): `Code/Sandbox/EditorQt/GameEngine.cpp`

### Other components

- **Engine Client**

## Connections

- Editor Engine → Navigation System: initializes (evidence: `Code/Sandbox/EditorQt/GameEngine.cpp`)
- Editor Engine → Navigation System: generates meshes (evidence: `Code/Sandbox/EditorQt/GameEngine.cpp`)
- Engine Client → 3D Engine: uses
- 3D Engine → Object Manager: references (evidence: `Code/CryEngine/Cry3DEngine/3dEngine.cpp`)
- 3D Engine → Objects Tree: references (evidence: `Code/CryEngine/Cry3DEngine/3dEngine.cpp`)
- 3D Engine → Terrain: references (evidence: `Code/CryEngine/Cry3DEngine/3dEngine.cpp`)
- 3D Engine → Materials: references (evidence: `Code/CryEngine/Cry3DEngine/3dEngine.cpp`)
- 3D Engine → CGF Assets: references (evidence: `Code/CryEngine/Cry3DEngine/3dEngine.cpp`)
- Nav Queries → Navigation System: uses (evidence: `Code/CryEngine/CryAISystem/Navigation/MNM/NavMeshQueryManager.cpp`)
- Engine Client → Query Manager: submits queries
- Managed Engine API → Particle Runtime: exposes access (evidence: `Code/CryManaged/CESharp/Core/Engine.cs`)
- Game Systems → 3D Engine: uses
