# joaquinkiko/qmap-godot architecture

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

- Interactive diagram: https://gitdiagram.com/joaquinkiko/qmap-godot
- Repository: https://github.com/joaquinkiko/qmap-godot

## Overview

QMap Godot is a Godot editor plugin for importing and authoring Quake/Source-style maps, WAD textures, and FGD entity definitions. The documented user workflow is to bring those files into a Godot project, then view/apply textures and edit entity definitions in the editor. The tree identifies format loaders, savers, resource models, and plugin integration, but no source excerpts were provided; internal call relationships are therefore not asserted.

Main entry points: [`addons/qmap/qmap_plugin.gd`](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/qmap_plugin.gd) (QMap plugin), [`addons/qmap/src/map_loader.gd`](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/map_loader.gd) (Map loader), [`addons/qmap/src/resources/loader/wad_resource_loader.gd`](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/wad_resource_loader.gd) (WAD resource loader), [`addons/qmap/src/resources/loader/fgd_resource_loader.gd`](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/fgd_resource_loader.gd) (FGD resource loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Godot integration"]
  node_plugin["QMap plugin<br/>[qmap_plugin.gd]"]
  node_settings["Map settings<br/>[map_settings.gd]"]
end

subgraph group_formats["Format handling"]
  node_map_loader["Map loader<br/>[map_loader.gd]"]
  node_map_resource_loader["MAP resource loader"]
  node_map_saver["MAP resource saver"]
  node_wad_loader["WAD resource loader"]
  node_wad_saver["WAD resource saver"]
  node_fgd_loader["FGD resource loader"]
  node_fgd_saver["FGD resource saver"]
  node_qpalette_loader["Palette loader"]
  node_qpalette_saver["Palette saver"]
end

subgraph group_domain["Map resources"]
  node_qmap_resource["Map resource<br/>[qmap.gd]"]
  node_wad_resource["WAD resource<br/>[wad.gd]"]
  node_fgd_resource["FGD resource<br/>[fgd.gd]"]
  node_palette_resource["Palette resource<br/>[qpalette.gd]"]
  node_entity["Map entity<br/>[qentity.gd]"]
  node_face_attribute["Face attributes<br/>[face_attribute.gd]"]
  node_fgd_class["FGD class<br/>[fgd_class.gd]"]
  node_entity_property["Entity property"]
  node_smart_tags["Smart tags<br/>[smart_tags.gd]"]
end

node_author(("Project author"))
node_map_file["MAP file"]
node_wad_file["WAD archive"]
node_fgd_file["FGD definition"]

node_author -->|"enables"| node_plugin
node_map_file -->|"imports"| node_map_loader
node_wad_file -->|"reads textures"| node_wad_loader
node_fgd_file -->|"loads definitions"| node_fgd_loader
node_author -->|"builds and edits"| node_fgd_resource
node_author -->|"views and applies"| node_wad_resource

click node_plugin "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/qmap_plugin.gd"
click node_settings "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/map_settings.gd"
click node_map_loader "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/map_loader.gd"
click node_map_resource_loader "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/map_resource_loader.gd"
click node_map_saver "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/map_resource_saver.gd"
click node_wad_loader "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/wad_resource_loader.gd"
click node_wad_saver "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/wad_resource_saver.gd"
click node_fgd_loader "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/fgd_resource_loader.gd"
click node_fgd_saver "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/fgd_resource_saver.gd"
click node_qpalette_loader "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/qpalette_resource_loader.gd"
click node_qpalette_saver "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/qpalette_resource_saver.gd"
click node_qmap_resource "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/qmap.gd"
click node_wad_resource "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/wad.gd"
click node_fgd_resource "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/fgd.gd"
click node_palette_resource "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/qpalette.gd"
click node_entity "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/qentity.gd"
click node_face_attribute "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/face_attribute.gd"
click node_fgd_class "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/fgd_class.gd"
click node_entity_property "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/fgd_entity_property.gd"
click node_smart_tags "https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/smart_tags.gd"

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_plugin,node_settings toneBlue
class node_map_loader,node_map_resource_loader,node_map_saver,node_wad_loader,node_wad_saver,node_fgd_loader,node_fgd_saver,node_qpalette_loader,node_qpalette_saver toneAmber
class node_qmap_resource,node_wad_resource,node_fgd_resource,node_palette_resource,node_entity,node_face_attribute,node_fgd_class,node_entity_property,node_smart_tags toneMint
class node_author,node_map_file,node_wad_file,node_fgd_file toneIndigo
```

## Components

### Godot integration

- [QMap plugin](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/qmap_plugin.gd): `addons/qmap/qmap_plugin.gd`
- [Map settings](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/map_settings.gd): `addons/qmap/src/map_settings.gd`

### Format handling

- [Map loader](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/map_loader.gd): `addons/qmap/src/map_loader.gd`
- [MAP resource loader](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/map_resource_loader.gd): `addons/qmap/src/resources/loader/map_resource_loader.gd`
- [MAP resource saver](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/map_resource_saver.gd): `addons/qmap/src/resources/saver/map_resource_saver.gd`
- [WAD resource loader](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/wad_resource_loader.gd): `addons/qmap/src/resources/loader/wad_resource_loader.gd`
- [WAD resource saver](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/wad_resource_saver.gd): `addons/qmap/src/resources/saver/wad_resource_saver.gd`
- [FGD resource loader](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/fgd_resource_loader.gd): `addons/qmap/src/resources/loader/fgd_resource_loader.gd`
- [FGD resource saver](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/fgd_resource_saver.gd): `addons/qmap/src/resources/saver/fgd_resource_saver.gd`
- [Palette loader](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/loader/qpalette_resource_loader.gd): `addons/qmap/src/resources/loader/qpalette_resource_loader.gd`
- [Palette saver](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/saver/qpalette_resource_saver.gd): `addons/qmap/src/resources/saver/qpalette_resource_saver.gd`

### Map resources

- [Map resource](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/qmap.gd): `addons/qmap/src/resources/qmap.gd`
- [WAD resource](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/wad.gd): `addons/qmap/src/resources/wad.gd`
- [FGD resource](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/fgd.gd): `addons/qmap/src/resources/fgd.gd`
- [Palette resource](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/resources/qpalette.gd): `addons/qmap/src/resources/qpalette.gd`
- [Map entity](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/qentity.gd): `addons/qmap/src/subresources/qentity.gd`
- [Face attributes](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/face_attribute.gd): `addons/qmap/src/subresources/face_attribute.gd`
- [FGD class](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/fgd_class.gd): `addons/qmap/src/subresources/fgd_class.gd`
- [Entity property](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/fgd_entity_property.gd): `addons/qmap/src/subresources/fgd_entity_property.gd`
- [Smart tags](https://github.com/joaquinkiko/qmap-godot/blob/main/addons/qmap/src/subresources/smart_tags.gd): `addons/qmap/src/subresources/smart_tags.gd`

### Other components

- **Project author**
- **MAP file**
- **WAD archive**
- **FGD definition**

## Connections

- Project author → QMap plugin: enables (evidence: `readme.md`)
- MAP file → Map loader: imports (evidence: `readme.md`)
- WAD archive → WAD resource loader: reads textures (evidence: `readme.md`)
- FGD definition → FGD resource loader: loads definitions (evidence: `readme.md`)
- Project author → FGD resource: builds and edits (evidence: `readme.md`)
- Project author → WAD resource: views and applies (evidence: `readme.md`)
