# dx9scope/dirt3-modloader architecture

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

- Interactive diagram: https://gitdiagram.com/dx9scope/dirt3-modloader
- Repository: https://github.com/dx9scope/dirt3-modloader

## Overview

DiRT 3 Modloader is an in-process mod framework for the 32-bit game. The main workflow proxies DirectInput loading, initializes the runtime modules, then enables content overrides, game-data changes, gameplay patches, and DLL/ASI plugins. Plugins use the exported C API for frame and vehicle-physics callbacks, memory operations, and logging; the bundled plugins provide gameplay tweaks, telemetry, and a rendering overlay. The graph follows README-described capabilities and shown initialization/calls; some module internals and integrations were not excerpted, so uncertain links are omitted.

Main entry points: [`src/core/dllmain.cpp`](https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/dllmain.cpp) (Runtime Bootstrap), [`src/api/dirt3_modloader_api.h`](https://github.com/dx9scope/dirt3-modloader/blob/master/src/api/dirt3_modloader_api.h) (Plugin C API), [`src/modules/plugin_loader/plugin_loader_module.cpp`](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/plugin_loader/plugin_loader_module.cpp) (Plugin Loader), [`src/modules/database_injector/database_injector_module.cpp`](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/database_injector/database_injector_module.cpp) (Database Injector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime Core"]
  node_proxy["DirectInput Proxy<br/>[proxy_dinput8.cpp]"]
  node_bootstrap["Runtime Bootstrap<br/>[dllmain.cpp]"]
  node_hooks["Hook Manager<br/>[hook_manager.cpp]"]
  node_memory["Memory Utilities<br/>[memory.cpp]"]
  node_logger["Logger<br/>[logger.cpp]"]
end

subgraph group_content["Content And Data"]
  node_vfs["Virtual Filesystem<br/>[vfs_module.cpp]"]
  node_database["Database Injector"]
  node_db_ini["Mod Database INI"]
  node_localization["Custom Strings"]
  node_loose_files["Loose Mod Files"]
end

subgraph group_gameplay["Gameplay Mods"]
  node_patches["Memory Patches"]
  node_outbreak["ACAT Unlocks"]
  node_mainloop["Frame Tick"]
end

subgraph group_plugins["Plugin System"]
  node_api["Plugin C API"]
  node_plugin_loader["Plugin Loader"]
  node_flyhack["Flyhack Mod<br/>[flyhack_mod.cpp]"]
  node_nitro["Nitro Mod<br/>[nitro_mod.cpp]"]
  node_overlay["Nitro Overlay<br/>[overlay.cpp]"]
  node_fov["Smooth FOV<br/>[fov_mod.cpp]"]
  node_gravity["Gravity Mod<br/>[gravity_mod.cpp]"]
  node_telemetry["Telemetry Mod<br/>[telemetry_mod.cpp]"]
end

node_game_user(("Game User"))
node_game["DiRT 3"]

node_game_user -->|"installs"| node_proxy
node_proxy -.->|"loads runtime"| node_bootstrap
node_bootstrap -->|"initializes"| node_hooks
node_bootstrap -->|"initializes"| node_vfs
node_bootstrap -->|"initializes"| node_mainloop
node_bootstrap -->|"initializes"| node_patches
node_bootstrap -->|"initializes"| node_plugin_loader
node_bootstrap -->|"initializes"| node_database
node_bootstrap -->|"initializes"| node_outbreak
node_database -->|"creates hook"| node_hooks
node_database -->|"scans and applies"| node_db_ini
node_database -->|"registers strings"| node_localization
node_game -->|"loads overridden files"| node_vfs
node_loose_files -->|"provides replacements"| node_vfs
node_outbreak -->|"unlocks vehicles"| node_game
node_patches -.->|"patches memory"| node_game
node_plugin_loader -->|"loads plugin"| node_flyhack
node_plugin_loader -->|"loads plugin"| node_nitro
node_plugin_loader -->|"loads plugin"| node_fov
node_plugin_loader -->|"loads plugin"| node_gravity
node_plugin_loader -->|"loads plugin"| node_telemetry
node_flyhack -->|"uses API"| node_api
node_nitro -->|"uses API"| node_api
node_fov -->|"uses API"| node_api
node_gravity -->|"uses API"| node_api
node_telemetry -->|"uses API"| node_api
node_nitro -->|"starts overlay"| node_overlay
node_api -->|"registers frame callbacks"| node_mainloop
node_api -->|"exposes vehicle physics"| node_game

click node_proxy "https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/proxy_dinput8.cpp"
click node_bootstrap "https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/dllmain.cpp"
click node_hooks "https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/hook_manager.cpp"
click node_memory "https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/memory.cpp"
click node_logger "https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/logger.cpp"
click node_vfs "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/vfs/vfs_module.cpp"
click node_database "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/database_injector/database_injector_module.cpp"
click node_localization "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/database_injector/database_injector_module.cpp"
click node_patches "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/memory_mods/memory_patch_module.cpp"
click node_outbreak "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/outbreak/outbreak_module.cpp"
click node_mainloop "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/mainloop/mainloop_module.cpp"
click node_api "https://github.com/dx9scope/dirt3-modloader/blob/master/src/api/dirt3_modloader_api.h"
click node_plugin_loader "https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/plugin_loader/plugin_loader_module.cpp"
click node_flyhack "https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/flyhack_mod/flyhack_mod.cpp"
click node_nitro "https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/nitro_mod/nitro_mod.cpp"
click node_overlay "https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/nitro_mod/overlay.cpp"
click node_fov "https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/fov_mod/fov_mod.cpp"
click node_gravity "https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/gravity_mod/gravity_mod.cpp"
click node_telemetry "https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/telemetry_mod/telemetry_mod.cpp"

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_proxy,node_bootstrap,node_hooks,node_memory,node_logger,node_game_user toneBlue
class node_vfs,node_database,node_db_ini,node_localization,node_loose_files toneAmber
class node_patches,node_outbreak,node_mainloop toneMint
class node_api,node_plugin_loader,node_flyhack,node_nitro,node_overlay,node_fov,node_gravity,node_telemetry toneRose
class node_game toneIndigo
```

## Components

### Runtime Core

- [DirectInput Proxy](https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/proxy_dinput8.cpp): `src/core/proxy_dinput8.cpp`
- [Runtime Bootstrap](https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/dllmain.cpp): `src/core/dllmain.cpp`
- [Hook Manager](https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/hook_manager.cpp): `src/core/hook_manager.cpp`
- [Memory Utilities](https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/memory.cpp): `src/core/memory.cpp`
- [Logger](https://github.com/dx9scope/dirt3-modloader/blob/master/src/core/logger.cpp): `src/core/logger.cpp`

### Content And Data

- [Virtual Filesystem](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/vfs/vfs_module.cpp): `src/modules/vfs/vfs_module.cpp`
- [Database Injector](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/database_injector/database_injector_module.cpp): `src/modules/database_injector/database_injector_module.cpp`
- **Mod Database INI**
- [Custom Strings](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/database_injector/database_injector_module.cpp): `src/modules/database_injector/database_injector_module.cpp`
- **Loose Mod Files**

### Gameplay Mods

- [Memory Patches](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/memory_mods/memory_patch_module.cpp): `src/modules/memory_mods/memory_patch_module.cpp`
- [ACAT Unlocks](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/outbreak/outbreak_module.cpp): `src/modules/outbreak/outbreak_module.cpp`
- [Frame Tick](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/mainloop/mainloop_module.cpp): `src/modules/mainloop/mainloop_module.cpp`

### Plugin System

- [Plugin C API](https://github.com/dx9scope/dirt3-modloader/blob/master/src/api/dirt3_modloader_api.h): `src/api/dirt3_modloader_api.h`
- [Plugin Loader](https://github.com/dx9scope/dirt3-modloader/blob/master/src/modules/plugin_loader/plugin_loader_module.cpp): `src/modules/plugin_loader/plugin_loader_module.cpp`
- [Flyhack Mod](https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/flyhack_mod/flyhack_mod.cpp): `plugins/flyhack_mod/flyhack_mod.cpp`
- [Nitro Mod](https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/nitro_mod/nitro_mod.cpp): `plugins/nitro_mod/nitro_mod.cpp`
- [Nitro Overlay](https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/nitro_mod/overlay.cpp): `plugins/nitro_mod/overlay.cpp`
- [Smooth FOV](https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/fov_mod/fov_mod.cpp): `plugins/fov_mod/fov_mod.cpp`
- [Gravity Mod](https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/gravity_mod/gravity_mod.cpp): `plugins/gravity_mod/gravity_mod.cpp`
- [Telemetry Mod](https://github.com/dx9scope/dirt3-modloader/blob/master/plugins/telemetry_mod/telemetry_mod.cpp): `plugins/telemetry_mod/telemetry_mod.cpp`

### Other components

- **Game User**
- **DiRT 3**

## Connections

- Game User → DirectInput Proxy: installs (evidence: `README.md`)
- DirectInput Proxy → Runtime Bootstrap: loads runtime
- Runtime Bootstrap → Hook Manager: initializes (evidence: `src/core/dllmain.cpp`)
- Runtime Bootstrap → Virtual Filesystem: initializes (evidence: `src/core/dllmain.cpp`)
- Runtime Bootstrap → Frame Tick: initializes (evidence: `src/core/dllmain.cpp`)
- Runtime Bootstrap → Memory Patches: initializes (evidence: `src/core/dllmain.cpp`)
- Runtime Bootstrap → Plugin Loader: initializes (evidence: `src/core/dllmain.cpp`)
- Runtime Bootstrap → Database Injector: initializes (evidence: `src/core/dllmain.cpp`)
- Runtime Bootstrap → ACAT Unlocks: initializes (evidence: `src/core/dllmain.cpp`)
- Database Injector → Hook Manager: creates hook (evidence: `src/modules/database_injector/database_injector_module.cpp`)
- Database Injector → Mod Database INI: scans and applies (evidence: `src/modules/database_injector/database_injector_module.cpp`)
- Database Injector → Custom Strings: registers strings (evidence: `src/modules/database_injector/database_injector_module.cpp`)
- DiRT 3 → Virtual Filesystem: loads overridden files (evidence: `README.md`)
- Loose Mod Files → Virtual Filesystem: provides replacements (evidence: `README.md`)
- ACAT Unlocks → DiRT 3: unlocks vehicles (evidence: `README.md`)
- Memory Patches → DiRT 3: patches memory
- Plugin Loader → Flyhack Mod: loads plugin (evidence: `README.md`)
- Plugin Loader → Nitro Mod: loads plugin (evidence: `README.md`)
- Plugin Loader → Smooth FOV: loads plugin (evidence: `README.md`)
- Plugin Loader → Gravity Mod: loads plugin (evidence: `README.md`)
- Plugin Loader → Telemetry Mod: loads plugin (evidence: `README.md`)
- Flyhack Mod → Plugin C API: uses API (evidence: `README.md`)
- Nitro Mod → Plugin C API: uses API (evidence: `README.md`)
- Smooth FOV → Plugin C API: uses API (evidence: `README.md`)
- Gravity Mod → Plugin C API: uses API (evidence: `README.md`)
- Telemetry Mod → Plugin C API: uses API (evidence: `README.md`)
- Nitro Mod → Nitro Overlay: starts overlay (evidence: `plugins/nitro_mod/nitro_mod.cpp`)
- Plugin C API → Frame Tick: registers frame callbacks (evidence: `README.md`)
- Plugin C API → DiRT 3: exposes vehicle physics (evidence: `README.md`)
