# zdoom/gzdoom architecture

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

## Overview

GZDoom is a modder-friendly DOOM source port with OpenGL and Vulkan rendering. Its main runtime spans engine startup, resource and map loading, gameplay, rendering, sound, and player-facing systems such as menus, saves, and the console. The graph highlights those stages and the scripting/debugging and texture-management layers. Some connections are documented only by the source index or README; unsampled implementation details are left unconnected rather than inferred.

Main entry points: [`src/d_main.cpp`](https://github.com/zdoom/gzdoom/blob/master/src/d_main.cpp) (Engine Startup), [`src/playsim/p_acs.cpp`](https://github.com/zdoom/gzdoom/blob/master/src/playsim/p_acs.cpp) (Gameplay Simulation), [`src/rendering/r_utility.cpp`](https://github.com/zdoom/gzdoom/blob/master/src/rendering/r_utility.cpp) (Rendering), [`src/common/console/c_enginecmds.cpp`](https://github.com/zdoom/gzdoom/blob/master/src/common/console/c_enginecmds.cpp) (Console Commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engine["Engine Core"]
  node_startup["Engine Startup<br/>[d_main.cpp]"]
  node_resource[("Resource Filesystem<br/>[filesystem.h]")]
end

subgraph group_game["Game Runtime"]
  node_maploader["Map Loading<br/>[maploader.cpp]"]
  node_playsim["Gameplay Simulation<br/>[p_acs.cpp]"]
  node_translation["Game Data Translation<br/>[parsecontext.cpp]"]
  node_intermission["Intermission<br/>[intermission.cpp]"]
  node_vm["Script VM<br/>[vm.h]"]
end

subgraph group_presentation["Presentation"]
  node_render["Rendering<br/>[r_utility.cpp]"]
  node_hardware["Hardware Renderer<br/>[hw_walls.cpp]"]
  node_software["Software Renderer<br/>[r_draw_pal.cpp]"]
  node_texture["Texture Manager<br/>[texturemanager.cpp]"]
  node_sound["Sound System<br/>[s_advsound.cpp]"]
  node_music["ZMusic Playback<br/>[zmusic.cpp]"]
end

subgraph group_tools["Player and Modder Systems"]
  node_menu["Game Menus<br/>[doommenu.cpp]"]
  node_saves[("Save Games")]
  node_console["Console Commands<br/>[c_enginecmds.cpp]"]
  node_cvars["Console Variables<br/>[c_cvars.h]"]
  node_dap["Debug Adapter"]
  node_breakpoints["Breakpoints"]
end

subgraph group_foundation["Shared Services"]
  node_coreutils["Core Utilities<br/>[basics.h]"]
  node_errors["Engine Errors<br/>[engineerrors.h]"]
end

node_player(("Player"))

node_player -.->|"starts"| node_startup
node_startup -->|"uses"| node_console
node_startup -->|"initializes"| node_playsim
node_startup -->|"initializes"| node_sound
node_startup -->|"uses"| node_resource
node_startup -.->|"dispatches"| node_maploader
node_resource -->|"provides assets"| node_texture
node_maploader -.->|"loads gameplay"| node_playsim
node_playsim -->|"runs scripts"| node_vm
node_startup -.->|"initializes"| node_render
node_render -.->|"uses"| node_hardware
node_render -.->|"uses"| node_software
node_playsim -.->|"advances to"| node_intermission
node_startup -.->|"initializes"| node_menu
node_menu -->|"manages"| node_saves
node_console -.->|"configures"| node_cvars
node_sound -.->|"uses"| node_music
node_startup -->|"starts"| node_dap
node_dap -->|"manages"| node_breakpoints
node_breakpoints -->|"inspects"| node_vm
node_console -->|"queries"| node_resource
node_startup -->|"uses"| node_errors
node_texture -->|"uses"| node_coreutils

click node_startup "https://github.com/zdoom/gzdoom/blob/master/src/d_main.cpp"
click node_resource "https://github.com/zdoom/gzdoom/blob/master/src/common/engine/filesystem.h"
click node_maploader "https://github.com/zdoom/gzdoom/blob/master/src/maploader/maploader.cpp"
click node_playsim "https://github.com/zdoom/gzdoom/blob/master/src/playsim/p_acs.cpp"
click node_translation "https://github.com/zdoom/gzdoom/blob/master/src/gamedata/xlat/parsecontext.cpp"
click node_intermission "https://github.com/zdoom/gzdoom/blob/master/src/intermission/intermission.cpp"
click node_render "https://github.com/zdoom/gzdoom/blob/master/src/rendering/r_utility.cpp"
click node_hardware "https://github.com/zdoom/gzdoom/blob/master/src/rendering/hwrenderer/scene/hw_walls.cpp"
click node_software "https://github.com/zdoom/gzdoom/blob/master/src/rendering/swrenderer/drawers/r_draw_pal.cpp"
click node_texture "https://github.com/zdoom/gzdoom/blob/master/src/common/textures/texturemanager.cpp"
click node_sound "https://github.com/zdoom/gzdoom/blob/master/src/sound/s_advsound.cpp"
click node_music "https://github.com/zdoom/gzdoom/blob/master/libraries/ZMusic/source/zmusic/zmusic.cpp"
click node_menu "https://github.com/zdoom/gzdoom/blob/master/src/menu/doommenu.cpp"
click node_saves "https://github.com/zdoom/gzdoom/blob/master/src/common/menu/savegamemanager.cpp"
click node_console "https://github.com/zdoom/gzdoom/blob/master/src/common/console/c_enginecmds.cpp"
click node_cvars "https://github.com/zdoom/gzdoom/blob/master/src/common/console/c_cvars.h"
click node_dap "https://github.com/zdoom/gzdoom/blob/master/src/common/scripting/dap/DebugExecutionManager.cpp"
click node_breakpoints "https://github.com/zdoom/gzdoom/blob/master/src/common/scripting/dap/BreakpointManager.cpp"
click node_vm "https://github.com/zdoom/gzdoom/blob/master/src/common/scripting/vm/vm.h"
click node_coreutils "https://github.com/zdoom/gzdoom/blob/master/src/common/utility/basics.h"
click node_errors "https://github.com/zdoom/gzdoom/blob/master/src/common/utility/engineerrors.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_startup,node_resource toneBlue
class node_maploader,node_playsim,node_translation,node_intermission,node_vm toneAmber
class node_render,node_hardware,node_software,node_texture,node_sound,node_music toneMint
class node_menu,node_saves,node_console,node_cvars,node_dap,node_breakpoints toneRose
class node_coreutils,node_errors,node_player toneIndigo
```

## Components

### Engine Core

- [Engine Startup](https://github.com/zdoom/gzdoom/blob/master/src/d_main.cpp): `src/d_main.cpp`
- [Resource Filesystem](https://github.com/zdoom/gzdoom/blob/master/src/common/engine/filesystem.h): `src/common/engine/filesystem.h`

### Game Runtime

- [Map Loading](https://github.com/zdoom/gzdoom/blob/master/src/maploader/maploader.cpp): `src/maploader/maploader.cpp`
- [Gameplay Simulation](https://github.com/zdoom/gzdoom/blob/master/src/playsim/p_acs.cpp): `src/playsim/p_acs.cpp`
- [Game Data Translation](https://github.com/zdoom/gzdoom/blob/master/src/gamedata/xlat/parsecontext.cpp): `src/gamedata/xlat/parsecontext.cpp`
- [Intermission](https://github.com/zdoom/gzdoom/blob/master/src/intermission/intermission.cpp): `src/intermission/intermission.cpp`
- [Script VM](https://github.com/zdoom/gzdoom/blob/master/src/common/scripting/vm/vm.h): `src/common/scripting/vm/vm.h`

### Presentation

- [Rendering](https://github.com/zdoom/gzdoom/blob/master/src/rendering/r_utility.cpp): `src/rendering/r_utility.cpp`
- [Hardware Renderer](https://github.com/zdoom/gzdoom/blob/master/src/rendering/hwrenderer/scene/hw_walls.cpp): `src/rendering/hwrenderer/scene/hw_walls.cpp`
- [Software Renderer](https://github.com/zdoom/gzdoom/blob/master/src/rendering/swrenderer/drawers/r_draw_pal.cpp): `src/rendering/swrenderer/drawers/r_draw_pal.cpp`
- [Texture Manager](https://github.com/zdoom/gzdoom/blob/master/src/common/textures/texturemanager.cpp): `src/common/textures/texturemanager.cpp`
- [Sound System](https://github.com/zdoom/gzdoom/blob/master/src/sound/s_advsound.cpp): `src/sound/s_advsound.cpp`
- [ZMusic Playback](https://github.com/zdoom/gzdoom/blob/master/libraries/ZMusic/source/zmusic/zmusic.cpp): `libraries/ZMusic/source/zmusic/zmusic.cpp`

### Player and Modder Systems

- [Game Menus](https://github.com/zdoom/gzdoom/blob/master/src/menu/doommenu.cpp): `src/menu/doommenu.cpp`
- [Save Games](https://github.com/zdoom/gzdoom/blob/master/src/common/menu/savegamemanager.cpp): `src/common/menu/savegamemanager.cpp`
- [Console Commands](https://github.com/zdoom/gzdoom/blob/master/src/common/console/c_enginecmds.cpp): `src/common/console/c_enginecmds.cpp`
- [Console Variables](https://github.com/zdoom/gzdoom/blob/master/src/common/console/c_cvars.h): `src/common/console/c_cvars.h`
- [Debug Adapter](https://github.com/zdoom/gzdoom/blob/master/src/common/scripting/dap/DebugExecutionManager.cpp): `src/common/scripting/dap/DebugExecutionManager.cpp`
- [Breakpoints](https://github.com/zdoom/gzdoom/blob/master/src/common/scripting/dap/BreakpointManager.cpp): `src/common/scripting/dap/BreakpointManager.cpp`

### Shared Services

- [Core Utilities](https://github.com/zdoom/gzdoom/blob/master/src/common/utility/basics.h): `src/common/utility/basics.h`
- [Engine Errors](https://github.com/zdoom/gzdoom/blob/master/src/common/utility/engineerrors.h): `src/common/utility/engineerrors.h`

### Other components

- **Player**

## Connections

- Player → Engine Startup: starts (evidence: `README.md`)
- Engine Startup → Console Commands: uses (evidence: `src/d_main.cpp`)
- Engine Startup → Gameplay Simulation: initializes (evidence: `src/d_main.cpp`)
- Engine Startup → Sound System: initializes (evidence: `src/d_main.cpp`)
- Engine Startup → Resource Filesystem: uses (evidence: `src/d_main.cpp`)
- Engine Startup → Map Loading: dispatches
- Resource Filesystem → Texture Manager: provides assets (evidence: `src/common/textures/texturemanager.cpp`)
- Map Loading → Gameplay Simulation: loads gameplay
- Gameplay Simulation → Script VM: runs scripts (evidence: `src/playsim/p_acs.cpp`)
- Engine Startup → Rendering: initializes
- Rendering → Hardware Renderer: uses
- Rendering → Software Renderer: uses
- Gameplay Simulation → Intermission: advances to
- Engine Startup → Game Menus: initializes
- Game Menus → Save Games: manages (evidence: `src/common/menu/savegamemanager.cpp`)
- Console Commands → Console Variables: configures
- Sound System → ZMusic Playback: uses
- Engine Startup → Debug Adapter: starts (evidence: `src/d_main.cpp`)
- Debug Adapter → Breakpoints: manages (evidence: `src/common/scripting/dap/BreakpointManager.cpp`)
- Breakpoints → Script VM: inspects (evidence: `src/common/scripting/dap/BreakpointManager.cpp`)
- Console Commands → Resource Filesystem: queries (evidence: `src/common/console/c_enginecmds.cpp`)
- Engine Startup → Engine Errors: uses (evidence: `src/d_main.cpp`)
- Texture Manager → Core Utilities: uses (evidence: `src/common/textures/texturemanager.cpp`)
