# drake53/war3net architecture

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

- Interactive diagram: https://gitdiagram.com/drake53/war3net
- Repository: https://github.com/drake53/war3net

## Overview

War3Net is a .NET toolkit for Warcraft III formats and modding. Its primary map-building workflow creates map metadata and terrain, assembles map content, generates JASS initialization code, and reads or writes map files and MPQ archives. Separate capabilities include JASS parsing, map decompilation, model parsing/rendering, and replay parsing. The graph emphasizes documented package scope and sampled calls; unsampled capabilities are represented at exact source directories, with uncertain links omitted.

Main entry points: [`src/War3Net.Build.Core/Map.cs`](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/Map.cs) (Map file I/O), [`src/War3Net.Build.Core/MapFactory/PreviewIcons.cs`](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/PreviewIcons.cs) (Preview icons), [`src/War3Net.CodeAnalysis.Jass/JassParser.cs`](https://github.com/drake53/war3net/blob/master/src/War3Net.CodeAnalysis.Jass/JassParser.cs) (JASS parser), [`src/War3Net.Build.Core/MapFactory/Info.cs`](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/Info.cs) (Map metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_maps["Map authoring"]
  node_info_factory["Map metadata<br/>[Info.cs]"]
  node_terrain_factory["Terrain generation<br/>[Environment.cs]"]
  node_preview_factory["Preview icons<br/>[PreviewIcons.cs]"]
  node_map_model["Map model<br/>[Map.cs]"]
  node_builder["Map script builder<br/>[Main.cs]"]
end

subgraph group_formats["Map formats"]
  node_map_files["Map file I/O<br/>[Map.cs]"]
  node_binary_formats["Binary serialization<br/>[Binary]"]
  node_json_formats["JSON serialization<br/>[Json]"]
  node_mpq["MPQ archives<br/>[MpqArchive.cs]"]
end

subgraph group_scripts["Script tooling"]
  node_jass_parser["JASS parser<br/>[JassParser.cs]"]
  node_jass_syntax["JASS syntax<br/>[Syntax]"]
  node_decompiler["Map decompilers"]
  node_trigger_context["Trigger context"]
  node_transpilers["JASS transpilers"]
  node_vjaas["vJASS analysis"]
end

subgraph group_assets["Assets and media"]
  node_model_parser["Model parser"]
  node_renderer["Model rendering<br/>[PipelineFactory.cs]"]
  node_pipeline_cache["Pipeline cache<br/>[CachedPipeline.cs]"]
  node_blp["BLP textures<br/>[BlpFile.cs]"]
end

subgraph group_other["Other formats"]
  node_compression["MPQ compression<br/>[HuffmanCoding.cs]"]
  node_slk["SYLK data<br/>[SylkParser.cs]"]
  node_replay["Replay parser<br/>[ReplayParser.cs]"]
end

node_engineer(("Map author"))

node_engineer -->|"sets map info"| node_info_factory
node_engineer -->|"creates terrain"| node_terrain_factory
node_info_factory -->|"provides dimensions"| node_terrain_factory
node_terrain_factory -.->|"supplies terrain"| node_preview_factory
node_map_model -->|"generates script"| node_builder
node_map_model -->|"reads map files"| node_map_files
node_map_files -->|"reads records"| node_binary_formats
node_map_files -->|"opens archive entries"| node_mpq
node_map_files -.->|"serializes map data"| node_json_formats
node_map_model -.->|"supplies units"| node_preview_factory
node_preview_factory -->|"uses map bounds"| node_info_factory
node_preview_factory -.->|"returns icons"| node_map_model
node_jass_parser -->|"builds syntax"| node_jass_syntax
node_decompiler -->|"uses trigger metadata"| node_trigger_context
node_jass_parser -.->|"transpiles parsed JASS"| node_transpilers
node_vjaas -.->|"extends language tooling"| node_jass_parser
node_renderer -->|"creates cached pipelines"| node_pipeline_cache
node_mpq -.->|"uses compression"| node_compression

click node_info_factory "https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/Info.cs"
click node_terrain_factory "https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/Environment.cs"
click node_preview_factory "https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/PreviewIcons.cs"
click node_map_model "https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/Map.cs"
click node_builder "https://github.com/drake53/war3net/blob/master/src/War3Net.Build/MapScriptBuilder/Common/Main.cs"
click node_map_files "https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/Map.cs"
click node_binary_formats "https://github.com/drake53/war3net/tree/master/src/War3Net.Build.Core/Serialization/Binary"
click node_json_formats "https://github.com/drake53/war3net/tree/master/src/War3Net.Build.Core/Serialization/Json"
click node_mpq "https://github.com/drake53/war3net/blob/master/src/War3Net.IO.Mpq/MpqArchive.cs"
click node_jass_parser "https://github.com/drake53/war3net/blob/master/src/War3Net.CodeAnalysis.Jass/JassParser.cs"
click node_jass_syntax "https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.Jass/Syntax"
click node_decompiler "https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.Decompilers"
click node_trigger_context "https://github.com/drake53/war3net/blob/master/src/War3Net.CodeAnalysis.Decompilers/TriggerDataContext.cs"
click node_transpilers "https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.Transpilers"
click node_vjaas "https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.VJass"
click node_model_parser "https://github.com/drake53/war3net/blob/master/src/War3Net.Modeling/BinaryModelParser.cs"
click node_renderer "https://github.com/drake53/war3net/blob/master/src/War3Net.Rendering/Factories/PipelineFactory.cs"
click node_pipeline_cache "https://github.com/drake53/war3net/blob/master/src/War3Net.Rendering/DataStructures/CachedPipeline.cs"
click node_blp "https://github.com/drake53/war3net/blob/master/src/War3Net.Drawing.Blp/BlpFile.cs"
click node_compression "https://github.com/drake53/war3net/blob/master/src/War3Net.IO.Compression/HuffmanCoding.cs"
click node_slk "https://github.com/drake53/war3net/blob/master/src/War3Net.IO.Slk/SylkParser.cs"
click node_replay "https://github.com/drake53/war3net/blob/master/src/War3Net.Replay/ReplayParser.cs"

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_info_factory,node_terrain_factory,node_preview_factory,node_map_model,node_builder toneBlue
class node_map_files,node_binary_formats,node_json_formats,node_mpq toneAmber
class node_jass_parser,node_jass_syntax,node_decompiler,node_trigger_context,node_transpilers,node_vjaas toneMint
class node_model_parser,node_renderer,node_pipeline_cache,node_blp toneRose
class node_compression,node_slk,node_replay,node_engineer toneIndigo
```

## Components

### Map authoring

- [Map metadata](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/Info.cs): `src/War3Net.Build.Core/MapFactory/Info.cs`
- [Terrain generation](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/Environment.cs): `src/War3Net.Build.Core/MapFactory/Environment.cs`
- [Preview icons](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/MapFactory/PreviewIcons.cs): `src/War3Net.Build.Core/MapFactory/PreviewIcons.cs`
- [Map model](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/Map.cs): `src/War3Net.Build.Core/Map.cs`
- [Map script builder](https://github.com/drake53/war3net/blob/master/src/War3Net.Build/MapScriptBuilder/Common/Main.cs): `src/War3Net.Build/MapScriptBuilder/Common/Main.cs`

### Map formats

- [Map file I/O](https://github.com/drake53/war3net/blob/master/src/War3Net.Build.Core/Map.cs): `src/War3Net.Build.Core/Map.cs`
- [Binary serialization](https://github.com/drake53/war3net/tree/master/src/War3Net.Build.Core/Serialization/Binary): `src/War3Net.Build.Core/Serialization/Binary`
- [JSON serialization](https://github.com/drake53/war3net/tree/master/src/War3Net.Build.Core/Serialization/Json): `src/War3Net.Build.Core/Serialization/Json`
- [MPQ archives](https://github.com/drake53/war3net/blob/master/src/War3Net.IO.Mpq/MpqArchive.cs): `src/War3Net.IO.Mpq/MpqArchive.cs`

### Script tooling

- [JASS parser](https://github.com/drake53/war3net/blob/master/src/War3Net.CodeAnalysis.Jass/JassParser.cs): `src/War3Net.CodeAnalysis.Jass/JassParser.cs`
- [JASS syntax](https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.Jass/Syntax): `src/War3Net.CodeAnalysis.Jass/Syntax`
- [Map decompilers](https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.Decompilers): `src/War3Net.CodeAnalysis.Decompilers`
- [Trigger context](https://github.com/drake53/war3net/blob/master/src/War3Net.CodeAnalysis.Decompilers/TriggerDataContext.cs): `src/War3Net.CodeAnalysis.Decompilers/TriggerDataContext.cs`
- [JASS transpilers](https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.Transpilers): `src/War3Net.CodeAnalysis.Transpilers`
- [vJASS analysis](https://github.com/drake53/war3net/tree/master/src/War3Net.CodeAnalysis.VJass): `src/War3Net.CodeAnalysis.VJass`

### Assets and media

- [Model parser](https://github.com/drake53/war3net/blob/master/src/War3Net.Modeling/BinaryModelParser.cs): `src/War3Net.Modeling/BinaryModelParser.cs`
- [Model rendering](https://github.com/drake53/war3net/blob/master/src/War3Net.Rendering/Factories/PipelineFactory.cs): `src/War3Net.Rendering/Factories/PipelineFactory.cs`
- [Pipeline cache](https://github.com/drake53/war3net/blob/master/src/War3Net.Rendering/DataStructures/CachedPipeline.cs): `src/War3Net.Rendering/DataStructures/CachedPipeline.cs`
- [BLP textures](https://github.com/drake53/war3net/blob/master/src/War3Net.Drawing.Blp/BlpFile.cs): `src/War3Net.Drawing.Blp/BlpFile.cs`

### Other formats

- [MPQ compression](https://github.com/drake53/war3net/blob/master/src/War3Net.IO.Compression/HuffmanCoding.cs): `src/War3Net.IO.Compression/HuffmanCoding.cs`
- [SYLK data](https://github.com/drake53/war3net/blob/master/src/War3Net.IO.Slk/SylkParser.cs): `src/War3Net.IO.Slk/SylkParser.cs`
- [Replay parser](https://github.com/drake53/war3net/blob/master/src/War3Net.Replay/ReplayParser.cs): `src/War3Net.Replay/ReplayParser.cs`

### Other components

- **Map author**

## Connections

- Map author → Map metadata: sets map info (evidence: `README.md`)
- Map author → Terrain generation: creates terrain (evidence: `README.md`)
- Map metadata → Terrain generation: provides dimensions (evidence: `src/War3Net.Build.Core/MapFactory/Environment.cs`)
- Terrain generation → Preview icons: supplies terrain
- Map model → Map script builder: generates script (evidence: `src/War3Net.Build/MapScriptBuilder/Common/Main.cs`)
- Map model → Map file I/O: reads map files (evidence: `src/War3Net.Build.Core/Map.cs`)
- Map file I/O → Binary serialization: reads records (evidence: `src/War3Net.Build.Core/Map.cs`)
- Map file I/O → MPQ archives: opens archive entries (evidence: `src/War3Net.Build.Core/Map.cs`)
- Map file I/O → JSON serialization: serializes map data
- Map model → Preview icons: supplies units (evidence: `src/War3Net.Build.Core/Map.cs`)
- Preview icons → Map metadata: uses map bounds (evidence: `src/War3Net.Build.Core/MapFactory/PreviewIcons.cs`)
- Preview icons → Map model: returns icons (evidence: `src/War3Net.Build.Core/MapFactory/PreviewIcons.cs`)
- JASS parser → JASS syntax: builds syntax (evidence: `src/War3Net.CodeAnalysis.Jass/JassParser.cs`)
- Map decompilers → Trigger context: uses trigger metadata (evidence: `src/War3Net.CodeAnalysis.Decompilers/TriggerDataContext.cs`)
- JASS parser → JASS transpilers: transpiles parsed JASS
- vJASS analysis → JASS parser: extends language tooling
- Model rendering → Pipeline cache: creates cached pipelines (evidence: `src/War3Net.Rendering/Factories/PipelineFactory.cs`)
- MPQ archives → MPQ compression: uses compression
