# egezenn/dota2-minify architecture

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

- Interactive diagram: https://gitdiagram.com/egezenn/dota2-minify
- Repository: https://github.com/egezenn/dota2-minify

## Overview

Dota2 Minify is a cross-platform Dota 2 mod manager and patcher with a WebView UI and headless CLI. The principal workflow is to discover and configure mods, check game and Workshop prerequisites, apply mod assets and hooks, then produce a reversible VPK patch and optionally adjust Steam launch settings. The graph includes the documented plugin/modding capabilities and the UI-to-service boundary. Several connections are based on the README or SOURCE INDEX references; unsampled subsystems are represented conservatively.

Main entry points: [`Minify/patch/__init__.py`](https://github.com/egezenn/dota2-minify/blob/main/Minify/patch/__init__.py) (Patch orchestrator), [`Minify/ui/app.py`](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/app.py) (UI application), [`Minify/ui/services/mod_service.py`](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/mod_service.py) (Mod service), [`Minify/core/steam.py`](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/steam.py) (Steam integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interfaces"]
  node_webui["Web UI<br/>[App.svelte]"]
  node_webapi["UI API<br/>[api.ts]"]
end

subgraph group_runtime["Application runtime"]
  node_app["UI application<br/>[app.py]"]
  node_modsvc["Mod service<br/>[mod_service.py]"]
  node_patchsvc["Patch service<br/>[patch_service.py]"]
  node_configsvc["Config service<br/>[config_service.py]"]
  node_cli["CLI entry<br/>[__main__.py]"]
  node_config[("Configuration<br/>[config.py]")]
  node_filesystem["Filesystem operations<br/>[fs.py]"]
  node_steam["Steam integration<br/>[steam.py]"]
  node_output["Output events<br/>[output.py]"]
  node_localization["Localization<br/>[localization.py]"]
  node_base["Platform paths<br/>[base.py]"]
end

subgraph group_patching["Mod and patch pipeline"]
  node_mods["Mod discovery<br/>[mods_shared.py]"]
  node_conditions["Prerequisite checks<br/>[conditions.py]"]
  node_patch["Patch orchestrator<br/>[__init__.py]"]
  node_manifest["Mod manifests<br/>[manifest_utils.py]"]
  node_modhooks["Mod hooks<br/>[helper.py]"]
end

subgraph group_extensions["Extensions"]
  node_plugins["Plugin runtime<br/>[plugin_sdk.py]"]
  node_pluginservice["Plugin service<br/>[plugin_service.py]"]
  node_d2pfx["D2PFX plugin<br/>[api.py]"]
  node_d2pfxui["D2PFX browser"]
end

node_user(("Player"))
node_game["Dota 2 / Workshop"]
node_vpk[("Compiled VPK")]

node_user -->|"uses"| node_webui
node_webui -->|"requests"| node_webapi
node_webapi -.->|"calls"| node_app
node_app -->|"dispatches"| node_modsvc
node_app -->|"dispatches"| node_patchsvc
node_app -.->|"dispatches"| node_configsvc
node_modsvc -->|"scans"| node_mods
node_modsvc -->|"reads manifests"| node_manifest
node_patchsvc -->|"invokes"| node_patch
node_cli -->|"checks"| node_conditions
node_cli -->|"invokes"| node_patch
node_configsvc -.->|"reads and writes"| node_config
node_mods -->|"reads manifests"| node_manifest
node_patch -->|"reads manifests"| node_manifest
node_patch -->|"checks prerequisites"| node_conditions
node_patch -->|"runs hooks"| node_modhooks
node_patch -->|"manages files"| node_filesystem
node_patch -->|"updates launch settings"| node_steam
node_patch -->|"builds"| node_vpk
node_game -.->|"supplies game state"| node_conditions
node_game -.->|"Steam installation"| node_steam
node_d2pfxui -.->|"uses API"| node_d2pfx
node_pluginservice -.->|"manages plugins"| node_plugins
node_d2pfx -->|"uses SDK"| node_plugins
node_patch -->|"reports progress"| node_output
node_output -->|"resolves messages"| node_localization
node_steam -->|"reads settings"| node_config
node_filesystem -->|"uses paths"| node_base

click node_webui "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/web/src/App.svelte"
click node_webapi "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/web/src/lib/api.ts"
click node_app "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/app.py"
click node_modsvc "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/mod_service.py"
click node_patchsvc "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/patch_service.py"
click node_configsvc "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/config_service.py"
click node_cli "https://github.com/egezenn/dota2-minify/blob/main/Minify/__main__.py"
click node_config "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/config.py"
click node_mods "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/mods_shared.py"
click node_conditions "https://github.com/egezenn/dota2-minify/blob/main/Minify/conditions.py"
click node_patch "https://github.com/egezenn/dota2-minify/blob/main/Minify/patch/__init__.py"
click node_manifest "https://github.com/egezenn/dota2-minify/blob/main/Minify/patch/manifest_utils.py"
click node_modhooks "https://github.com/egezenn/dota2-minify/blob/main/Minify/helper.py"
click node_filesystem "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/fs.py"
click node_steam "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/steam.py"
click node_output "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/output.py"
click node_localization "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/localization.py"
click node_base "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/base.py"
click node_plugins "https://github.com/egezenn/dota2-minify/blob/main/Minify/core/plugin_sdk.py"
click node_pluginservice "https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/plugin_service.py"
click node_d2pfx "https://github.com/egezenn/dota2-minify/blob/main/Minify/plugins/d2pfx/api.py"
click node_d2pfxui "https://github.com/egezenn/dota2-minify/blob/main/Minify/plugins/d2pfx/src/D2pfxBrowser.svelte"

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_webui,node_webapi toneBlue
class node_app,node_modsvc,node_patchsvc,node_configsvc,node_cli,node_config,node_filesystem,node_steam,node_output,node_localization,node_base,node_vpk toneAmber
class node_mods,node_conditions,node_patch,node_manifest,node_modhooks toneMint
class node_plugins,node_pluginservice,node_d2pfx,node_d2pfxui toneRose
class node_user,node_game toneIndigo
```

## Components

### User interfaces

- [Web UI](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/web/src/App.svelte): `Minify/ui/web/src/App.svelte`
- [UI API](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/web/src/lib/api.ts): `Minify/ui/web/src/lib/api.ts`

### Application runtime

- [UI application](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/app.py): `Minify/ui/app.py`
- [Mod service](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/mod_service.py): `Minify/ui/services/mod_service.py`
- [Patch service](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/patch_service.py): `Minify/ui/services/patch_service.py`
- [Config service](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/config_service.py): `Minify/ui/services/config_service.py`
- [CLI entry](https://github.com/egezenn/dota2-minify/blob/main/Minify/__main__.py): `Minify/__main__.py`
- [Configuration](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/config.py): `Minify/core/config.py`
- [Filesystem operations](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/fs.py): `Minify/core/fs.py`
- [Steam integration](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/steam.py): `Minify/core/steam.py`
- [Output events](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/output.py): `Minify/core/output.py`
- [Localization](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/localization.py): `Minify/core/localization.py`
- [Platform paths](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/base.py): `Minify/core/base.py`

### Mod and patch pipeline

- [Mod discovery](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/mods_shared.py): `Minify/core/mods_shared.py`
- [Prerequisite checks](https://github.com/egezenn/dota2-minify/blob/main/Minify/conditions.py): `Minify/conditions.py`
- [Patch orchestrator](https://github.com/egezenn/dota2-minify/blob/main/Minify/patch/__init__.py): `Minify/patch/__init__.py`
- [Mod manifests](https://github.com/egezenn/dota2-minify/blob/main/Minify/patch/manifest_utils.py): `Minify/patch/manifest_utils.py`
- [Mod hooks](https://github.com/egezenn/dota2-minify/blob/main/Minify/helper.py): `Minify/helper.py`

### Extensions

- [Plugin runtime](https://github.com/egezenn/dota2-minify/blob/main/Minify/core/plugin_sdk.py): `Minify/core/plugin_sdk.py`
- [Plugin service](https://github.com/egezenn/dota2-minify/blob/main/Minify/ui/services/plugin_service.py): `Minify/ui/services/plugin_service.py`
- [D2PFX plugin](https://github.com/egezenn/dota2-minify/blob/main/Minify/plugins/d2pfx/api.py): `Minify/plugins/d2pfx/api.py`
- [D2PFX browser](https://github.com/egezenn/dota2-minify/blob/main/Minify/plugins/d2pfx/src/D2pfxBrowser.svelte): `Minify/plugins/d2pfx/src/D2pfxBrowser.svelte`

### Other components

- **Player**
- **Dota 2 / Workshop**
- **Compiled VPK**

## Connections

- Player → Web UI: uses
- Web UI → UI API: requests (evidence: `Minify/ui/web/src/App.svelte`)
- UI API → UI application: calls
- UI application → Mod service: dispatches (evidence: `Minify/ui/app.py`)
- UI application → Patch service: dispatches (evidence: `Minify/ui/app.py`)
- UI application → Config service: dispatches
- Mod service → Mod discovery: scans (evidence: `Minify/ui/services/mod_service.py`)
- Mod service → Mod manifests: reads manifests (evidence: `Minify/ui/services/mod_service.py`)
- Patch service → Patch orchestrator: invokes (evidence: `Minify/ui/services/patch_service.py`)
- CLI entry → Prerequisite checks: checks (evidence: `Minify/__main__.py`)
- CLI entry → Patch orchestrator: invokes (evidence: `Minify/__main__.py`)
- Config service → Configuration: reads and writes
- Mod discovery → Mod manifests: reads manifests (evidence: `Minify/core/mods_shared.py`)
- Patch orchestrator → Mod manifests: reads manifests (evidence: `Minify/patch/__init__.py`)
- Patch orchestrator → Prerequisite checks: checks prerequisites (evidence: `Minify/conditions.py`)
- Patch orchestrator → Mod hooks: runs hooks (evidence: `Minify/helper.py`)
- Patch orchestrator → Filesystem operations: manages files (evidence: `Minify/patch/__init__.py`)
- Patch orchestrator → Steam integration: updates launch settings (evidence: `Minify/patch/__init__.py`)
- Patch orchestrator → Compiled VPK: builds
- Dota 2 / Workshop → Prerequisite checks: supplies game state
- Dota 2 / Workshop → Steam integration: Steam installation
- D2PFX browser → D2PFX plugin: uses API
- Plugin service → Plugin runtime: manages plugins
- D2PFX plugin → Plugin runtime: uses SDK (evidence: `Minify/plugins/d2pfx/api.py`)
- Patch orchestrator → Output events: reports progress (evidence: `Minify/patch/__init__.py`)
- Output events → Localization: resolves messages (evidence: `Minify/core/output.py`)
- Steam integration → Configuration: reads settings (evidence: `Minify/core/steam.py`)
- Filesystem operations → Platform paths: uses paths (evidence: `Minify/core/fs.py`)
