# h2xdev/godotvmf architecture

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

- Interactive diagram: https://gitdiagram.com/h2xdev/godotvmf
- Repository: https://github.com/h2xdev/godotvmf

## Overview

GodotVMF is a Godot addon for importing Valve VMF maps. The documented workflow is to use it to import a VMF into Godot, bringing map geometry and supported Source assets and behaviors into the project. The graph preserves the README’s major feature areas, including model and material formats, entities, instances, displacements, and Hammer I/O, plus the separate FGD generator. No source excerpts were available, so internal call relationships cannot be verified; documented capability edges cite the README rather than asserting implementation details.

Main entry points: [`addons/godotvmf/godotvmf.gd`](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmf.gd) (VMF Importer), [`addons/godotfgd/main.gd`](https://github.com/h2xdev/godotvmf/blob/master/addons/godotfgd/main.gd) (FGD Generator), [`addons/godotvmf/src/vmf_geometry_corrector.gd`](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_geometry_corrector.gd) (Brush Geometry), [`addons/godotvmf/src/structs/vmf_displacement_info.gd`](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/structs/vmf_displacement_info.gd) (Displacements)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_map_import["Map Import"]
  node_vmf_importer["VMF Importer<br/>[godotvmf.gd]"]
  node_vmf_structures["VMF Structures"]
  node_brush_geometry["Brush Geometry"]
  node_displacements["Displacements"]
  node_instances["Map Instances"]
end

subgraph group_source_assets["Source Assets"]
  node_model_import["MDL Import<br/>[import.gd]"]
  node_model_readers["MDL Readers<br/>[mdl_reader.gd]"]
  node_vmt_import["VMT Import<br/>[vmt_import.gd]"]
  node_vtf_import["VTF Import<br/>[vtf_import.gd]"]
  node_blend_material["Blend Materials"]
  node_resource_manager["Resource Manager"]
end

subgraph group_map_runtime["Map Behaviors"]
  node_entity_nodes["Entity Support<br/>[vmf_entity_node.gd]"]
  node_entity_types["Entity Types<br/>[vmf_entity_type.gd]"]
  node_hammer_io["Hammer I/O"]
  node_surface_props["Surface Props<br/>[vmf_config.gd]"]
end

subgraph group_authoring["Authoring Tools"]
  node_fgd_generator["FGD Generator<br/>[main.gd]"]
  node_editor_ui["Editor UI<br/>[ui.gd]"]
end

node_godot_editor_user(("Godot User"))

node_godot_editor_user -->|"imports VMF"| node_vmf_importer
node_vmf_importer -->|"supports brushes"| node_brush_geometry
node_vmf_importer -->|"supports displacements"| node_displacements
node_vmf_importer -->|"supports instances"| node_instances
node_vmf_importer -->|"supports entities"| node_entity_nodes
node_vmf_importer -->|"supports Hammer I/O"| node_hammer_io
node_vmf_importer -->|"supports surface props"| node_surface_props
node_vmf_importer -->|"supports MDL"| node_model_import
node_vmf_importer -->|"supports VMT"| node_vmt_import
node_vmf_importer -->|"supports VTF"| node_vtf_import
node_vmf_importer -->|"supports blend materials"| node_blend_material
node_fgd_generator -->|"generates from entities"| node_entity_types

click node_vmf_importer "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmf.gd"
click node_vmf_structures "https://github.com/h2xdev/godotvmf/tree/master/addons/godotvmf/src/structs"
click node_brush_geometry "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_geometry_corrector.gd"
click node_displacements "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/structs/vmf_displacement_info.gd"
click node_instances "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_instance_manager.gd"
click node_entity_nodes "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_entity_node.gd"
click node_entity_types "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/structs/vmf_entity_type.gd"
click node_hammer_io "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_output_executor.gd"
click node_surface_props "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_config.gd"
click node_model_import "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotmdl/import.gd"
click node_model_readers "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotmdl/mdl_reader.gd"
click node_vmt_import "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmt/vmt_import.gd"
click node_vtf_import "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmt/vtf_import.gd"
click node_blend_material "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/shaders/WorldVertexTransitionMaterial.gd"
click node_resource_manager "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_resource_manager.gd"
click node_fgd_generator "https://github.com/h2xdev/godotvmf/blob/master/addons/godotfgd/main.gd"
click node_editor_ui "https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/ui.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_vmf_importer,node_vmf_structures,node_brush_geometry,node_displacements,node_instances,node_godot_editor_user toneBlue
class node_model_import,node_model_readers,node_vmt_import,node_vtf_import,node_blend_material,node_resource_manager toneAmber
class node_entity_nodes,node_entity_types,node_hammer_io,node_surface_props toneMint
class node_fgd_generator,node_editor_ui toneRose
```

## Components

### Map Import

- [VMF Importer](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmf.gd): `addons/godotvmf/godotvmf.gd`
- [VMF Structures](https://github.com/h2xdev/godotvmf/tree/master/addons/godotvmf/src/structs): `addons/godotvmf/src/structs`
- [Brush Geometry](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_geometry_corrector.gd): `addons/godotvmf/src/vmf_geometry_corrector.gd`
- [Displacements](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/structs/vmf_displacement_info.gd): `addons/godotvmf/src/structs/vmf_displacement_info.gd`
- [Map Instances](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_instance_manager.gd): `addons/godotvmf/src/vmf_instance_manager.gd`

### Source Assets

- [MDL Import](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotmdl/import.gd): `addons/godotvmf/godotmdl/import.gd`
- [MDL Readers](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotmdl/mdl_reader.gd): `addons/godotvmf/godotmdl/mdl_reader.gd`
- [VMT Import](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmt/vmt_import.gd): `addons/godotvmf/godotvmt/vmt_import.gd`
- [VTF Import](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/godotvmt/vtf_import.gd): `addons/godotvmf/godotvmt/vtf_import.gd`
- [Blend Materials](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/shaders/WorldVertexTransitionMaterial.gd): `addons/godotvmf/shaders/WorldVertexTransitionMaterial.gd`
- [Resource Manager](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_resource_manager.gd): `addons/godotvmf/src/vmf_resource_manager.gd`

### Map Behaviors

- [Entity Support](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_entity_node.gd): `addons/godotvmf/src/vmf_entity_node.gd`
- [Entity Types](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/structs/vmf_entity_type.gd): `addons/godotvmf/src/structs/vmf_entity_type.gd`
- [Hammer I/O](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_output_executor.gd): `addons/godotvmf/src/vmf_output_executor.gd`
- [Surface Props](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/src/vmf_config.gd): `addons/godotvmf/src/vmf_config.gd`

### Authoring Tools

- [FGD Generator](https://github.com/h2xdev/godotvmf/blob/master/addons/godotfgd/main.gd): `addons/godotfgd/main.gd`
- [Editor UI](https://github.com/h2xdev/godotvmf/blob/master/addons/godotvmf/ui.gd): `addons/godotvmf/ui.gd`

### Other components

- **Godot User**

## Connections

- Godot User → VMF Importer: imports VMF (evidence: `readme.md`)
- VMF Importer → Brush Geometry: supports brushes (evidence: `readme.md`)
- VMF Importer → Displacements: supports displacements (evidence: `readme.md`)
- VMF Importer → Map Instances: supports instances (evidence: `readme.md`)
- VMF Importer → Entity Support: supports entities (evidence: `readme.md`)
- VMF Importer → Hammer I/O: supports Hammer I/O (evidence: `readme.md`)
- VMF Importer → Surface Props: supports surface props (evidence: `readme.md`)
- VMF Importer → MDL Import: supports MDL (evidence: `readme.md`)
- VMF Importer → VMT Import: supports VMT (evidence: `readme.md`)
- VMF Importer → VTF Import: supports VTF (evidence: `readme.md`)
- VMF Importer → Blend Materials: supports blend materials (evidence: `readme.md`)
- FGD Generator → Entity Types: generates from entities (evidence: `readme.md`)
