# brawlcrate/brawlcratenext architecture

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

- Interactive diagram: https://gitdiagram.com/brawlcrate/brawlcratenext
- Repository: https://github.com/brawlcrate/brawlcratenext

## Overview

BrawlCrate is a desktop modding application for Super Smash Bros. Brawl, built around BrawlLib’s resource model and specialized editors. The principal workflow is to open a game asset, represent it as an editable resource tree, inspect or modify it in an editor or previewer, then export the changed resource. The tree and README establish the product’s scope; sampled excerpts and the source index support only some internal links, so unsampled manager relationships are left unconnected rather than inferred.

Main entry points: [`BrawlLib/SSBB/ResourceNodes/ResourceNode.cs`](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/ResourceNode.cs) (Resource model), [`BrawlLib/SSBB/ResourceNodes/MDL0/MDL0Node.cs`](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/MDL0/MDL0Node.cs) (Model resources), [`BrawlCrate/Program.cs`](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Program.cs) (App startup), [`BrawlLib/SSBB/ResourceNodes/NodeFactory.cs`](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/NodeFactory.cs) (File loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App startup<br/>[Program.cs]"]
  node_mainui["Main window<br/>[MainForm.cs]"]
  node_resource_tree["Resource tree<br/>[ResourceTree.cs]"]
end

subgraph group_resources["Resource handling"]
  node_resource_model["Resource model<br/>[ResourceNode.cs]"]
  node_node_factory["File loader<br/>[NodeFactory.cs]"]
  node_mdl0["Model resources<br/>[MDL0Node.cs]"]
end

subgraph group_editors["Modding editors"]
  node_costume["Costume editor<br/>[ModelManager.cs]"]
  node_stage["Stage editor<br/>[MainForm.cs]"]
  node_sss["Stage select editor<br/>[SSSEditorForm.cs]"]
  node_song["Song manager<br/>[MainForm.cs]"]
  node_collision["Collision editor<br/>[CollisionEditor.cs]"]
end

subgraph group_models["Model tools"]
  node_model_render["Model rendering"]
  node_model_link["Model linker<br/>[ModelLinker.cs]"]
end

subgraph group_extensions["Extensions"]
  node_plugin_api["Plugin API<br/>[ExposedMembers.cs]"]
  node_discord["Discord presence"]
  node_discord_rpc["Discord RPC<br/>[DiscordRpc.cs]"]
end

node_user(("Modder"))

node_user -.->|"launches"| node_entry
node_entry -->|"uses"| node_resource_model
node_entry -->|"loads through"| node_node_factory
node_node_factory -.->|"creates"| node_resource_model
node_resource_model -->|"references"| node_mdl0
node_costume -->|"loads files"| node_node_factory
node_costume -->|"inspects models"| node_mdl0
node_model_render -->|"uses model objects"| node_mdl0
node_mdl0 -->|"links model data"| node_model_link
node_plugin_api -->|"exposes"| node_resource_model
node_plugin_api -.-> node_discord
node_discord -->|"delegates to"| node_discord_rpc

click node_entry "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Program.cs"
click node_mainui "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/UI/MainForm.cs"
click node_resource_tree "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/UI/ResourceTree.cs"
click node_resource_model "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/ResourceNode.cs"
click node_node_factory "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/NodeFactory.cs"
click node_mdl0 "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/MDL0/MDL0Node.cs"
click node_costume "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/CostumeManager/ModelManager.cs"
click node_stage "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/StageManager/MainForm.cs"
click node_sss "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/SSSEditor/SSSEditorForm.cs"
click node_song "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/SongManager/MainForm.cs"
click node_collision "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/UI/CollisionEditor.cs"
click node_model_render "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/Modeling/PrimitiveManager.cs"
click node_model_link "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/Wii/Models/ModelLinker.cs"
click node_plugin_api "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlAPI/ExposedMembers.cs"
click node_discord "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Discord/DiscordController.cs"
click node_discord_rpc "https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Discord/DiscordRpc.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_entry,node_mainui,node_resource_tree toneBlue
class node_resource_model,node_node_factory,node_mdl0 toneAmber
class node_costume,node_stage,node_sss,node_song,node_collision toneMint
class node_model_render,node_model_link toneRose
class node_plugin_api,node_discord,node_discord_rpc,node_user toneIndigo
```

## Components

### Application

- [App startup](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Program.cs): `BrawlCrate/Program.cs`
- [Main window](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/UI/MainForm.cs): `BrawlCrate/UI/MainForm.cs`
- [Resource tree](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/UI/ResourceTree.cs): `BrawlCrate/UI/ResourceTree.cs`

### Resource handling

- [Resource model](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/ResourceNode.cs): `BrawlLib/SSBB/ResourceNodes/ResourceNode.cs`
- [File loader](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/NodeFactory.cs): `BrawlLib/SSBB/ResourceNodes/NodeFactory.cs`
- [Model resources](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/SSBB/ResourceNodes/MDL0/MDL0Node.cs): `BrawlLib/SSBB/ResourceNodes/MDL0/MDL0Node.cs`

### Modding editors

- [Costume editor](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/CostumeManager/ModelManager.cs): `BrawlCrate/BrawlManagers/CostumeManager/ModelManager.cs`
- [Stage editor](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/StageManager/MainForm.cs): `BrawlCrate/BrawlManagers/StageManager/MainForm.cs`
- [Stage select editor](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/SSSEditor/SSSEditorForm.cs): `BrawlCrate/BrawlManagers/SSSEditor/SSSEditorForm.cs`
- [Song manager](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlManagers/SongManager/MainForm.cs): `BrawlCrate/BrawlManagers/SongManager/MainForm.cs`
- [Collision editor](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/UI/CollisionEditor.cs): `BrawlCrate/UI/CollisionEditor.cs`

### Model tools

- [Model rendering](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/Modeling/PrimitiveManager.cs): `BrawlLib/Modeling/PrimitiveManager.cs`
- [Model linker](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlLib/Wii/Models/ModelLinker.cs): `BrawlLib/Wii/Models/ModelLinker.cs`

### Extensions

- [Plugin API](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/BrawlAPI/ExposedMembers.cs): `BrawlCrate/BrawlAPI/ExposedMembers.cs`
- [Discord presence](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Discord/DiscordController.cs): `BrawlCrate/Discord/DiscordController.cs`
- [Discord RPC](https://github.com/brawlcrate/brawlcratenext/blob/master/BrawlCrate/Discord/DiscordRpc.cs): `BrawlCrate/Discord/DiscordRpc.cs`

### Other components

- **Modder**

## Connections

- Modder → App startup: launches
- App startup → Resource model: uses (evidence: `BrawlCrate/Program.cs`)
- App startup → File loader: loads through (evidence: `BrawlCrate/Program.cs`)
- File loader → Resource model: creates (evidence: `BrawlLib/SSBB/ResourceNodes/NodeFactory.cs`)
- Resource model → Model resources: references (evidence: `BrawlLib/SSBB/ResourceNodes/ResourceNode.cs`)
- Costume editor → File loader: loads files (evidence: `BrawlCrate/BrawlManagers/CostumeManager/ModelManager.cs`)
- Costume editor → Model resources: inspects models (evidence: `BrawlCrate/BrawlManagers/CostumeManager/ModelManager.cs`)
- Model rendering → Model resources: uses model objects (evidence: `BrawlLib/Modeling/PrimitiveManager.cs`)
- Model resources → Model linker: links model data (evidence: `BrawlLib/SSBB/ResourceNodes/MDL0/MDL0Node.cs`)
- Plugin API → Resource model: exposes (evidence: `BrawlCrate/BrawlAPI/ExposedMembers.cs`)
- Plugin API → Discord presence
- Discord presence → Discord RPC: delegates to (evidence: `BrawlCrate/Discord/DiscordController.cs`)
