# justdoshiba/robrunexternal architecture

> Architecture diagram of the GitHub repository justdoshiba/robrunexternal, 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/justdoshiba/robrunexternal
- Repository: https://github.com/justdoshiba/robrunexternal

## Overview

RobRunExternal is a Windows game overlay that reads ROB RUN state through a kernel driver, builds snapshots, and renders ESP, radar, and vehicle markers; optional aim assist uses those snapshots and visibility checks. Users configure features through a WebView2 menu, with settings persisted by the config layer. The README documents loot, vehicle, and player display capabilities. Edges reflect README statements, excerpted comments/calls, or SOURCE INDEX references; unsampled modules are represented only where their subsystem is clear.

Main entry points: [`src/overlay/rr_esp.c`](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_esp.c) (Overlay runtime), [`src/overlay/rr_game.c`](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_game.c) (Game snapshots), [`src/overlay/rr_draw.c`](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_draw.c) (ESP and radar), [`src/overlay/rr_aim.c`](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_aim.c) (Aim assist)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Memory access"]
  node_driver["Memory driver<br/>[robrun_drv.c]"]
  node_abi["Request ABI<br/>[rr_abi.h]"]
  node_transport["Driver transport<br/>[rr_mem.c]"]
  node_unity["IL2CPP helpers<br/>[rr_unity.c]"]
end

subgraph group_state["Game state"]
  node_discovery["Game discovery<br/>[rr_game.c]"]
  node_snapshots["Game snapshots<br/>[rr_game.c]"]
  node_loscapture["LOS capture<br/>[rr_los_capture.c]"]
  node_losgeometry["LOS geometry<br/>[rr_los_geom.c]"]
  node_losruntime["LOS runtime<br/>[rr_los_runtime.c]"]
end

subgraph group_overlay["Overlay features"]
  node_aim["Aim assist<br/>[rr_aim.c]"]
  node_renderer["ESP and radar<br/>[rr_draw.c]"]
  node_vehiclecham["Vehicle chams"]
  node_gpu["GPU presentation<br/>[gpu.cpp]"]
  node_overlayapp["Overlay runtime<br/>[rr_esp.c]"]
end

subgraph group_settings["Menu and settings"]
  node_menuhost["WebView menu<br/>[menu_webview.cpp]"]
  node_config["Settings storage<br/>[rr_config.c]"]
end

node_gameuser(("ROB RUN"))

node_gameuser -->|"exposes memory"| node_driver
node_transport -->|"sends requests"| node_driver
node_driver -->|"uses contract"| node_abi
node_transport -->|"uses contract"| node_abi
node_discovery -->|"reads game memory"| node_transport
node_discovery -->|"parses objects"| node_unity
node_discovery -->|"publishes"| node_snapshots
node_overlayapp -->|"samples state"| node_discovery
node_overlayapp -->|"consumes snapshots"| node_snapshots
node_overlayapp -->|"runs aim assist"| node_aim
node_overlayapp -->|"requests repaint"| node_renderer
node_renderer -->|"draws snapshots"| node_snapshots
node_renderer -->|"draws primitives"| node_gpu
node_renderer -->|"uses vehicle model"| node_vehiclecham
node_aim -->|"selects targets"| node_snapshots
node_aim -.->|"checks visibility"| node_losruntime
node_losruntime -->|"uses captures"| node_loscapture
node_loscapture -->|"uses geometry"| node_losgeometry
node_overlayapp -->|"hosts menu"| node_menuhost
node_menuhost -->|"updates settings"| node_config
node_config -.->|"supplies settings"| node_overlayapp
node_renderer -->|"shows ESP and radar"| node_snapshots
node_discovery -->|"collects loot and vehicles"| node_snapshots

click node_driver "https://github.com/justdoshiba/robrunexternal/blob/main/src/driver/robrun_drv.c"
click node_abi "https://github.com/justdoshiba/robrunexternal/blob/main/src/shared/rr_abi.h"
click node_transport "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_mem.c"
click node_unity "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_unity.c"
click node_discovery "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_game.c"
click node_snapshots "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_game.c"
click node_loscapture "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_los_capture.c"
click node_losgeometry "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_los_geom.c"
click node_losruntime "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_los_runtime.c"
click node_aim "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_aim.c"
click node_renderer "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_draw.c"
click node_vehiclecham "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_vehicle_cham_model.c"
click node_gpu "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/gpu.cpp"
click node_overlayapp "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_esp.c"
click node_menuhost "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/menu_webview.cpp"
click node_config "https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_config.c"

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_driver,node_abi,node_transport,node_unity toneBlue
class node_discovery,node_snapshots,node_loscapture,node_losgeometry,node_losruntime toneAmber
class node_aim,node_renderer,node_vehiclecham,node_gpu,node_overlayapp toneMint
class node_menuhost,node_config toneRose
class node_gameuser toneIndigo
```

## Components

### Memory access

- [Memory driver](https://github.com/justdoshiba/robrunexternal/blob/main/src/driver/robrun_drv.c): `src/driver/robrun_drv.c`
- [Request ABI](https://github.com/justdoshiba/robrunexternal/blob/main/src/shared/rr_abi.h): `src/shared/rr_abi.h`
- [Driver transport](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_mem.c): `src/overlay/rr_mem.c`
- [IL2CPP helpers](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_unity.c): `src/overlay/rr_unity.c`

### Game state

- [Game discovery](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_game.c): `src/overlay/rr_game.c`
- [Game snapshots](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_game.c): `src/overlay/rr_game.c`
- [LOS capture](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_los_capture.c): `src/overlay/rr_los_capture.c`
- [LOS geometry](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_los_geom.c): `src/overlay/rr_los_geom.c`
- [LOS runtime](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_los_runtime.c): `src/overlay/rr_los_runtime.c`

### Overlay features

- [Aim assist](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_aim.c): `src/overlay/rr_aim.c`
- [ESP and radar](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_draw.c): `src/overlay/rr_draw.c`
- [Vehicle chams](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_vehicle_cham_model.c): `src/overlay/rr_vehicle_cham_model.c`
- [GPU presentation](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/gpu.cpp): `src/overlay/gpu.cpp`
- [Overlay runtime](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_esp.c): `src/overlay/rr_esp.c`

### Menu and settings

- [WebView menu](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/menu_webview.cpp): `src/overlay/menu_webview.cpp`
- [Settings storage](https://github.com/justdoshiba/robrunexternal/blob/main/src/overlay/rr_config.c): `src/overlay/rr_config.c`

### Other components

- **ROB RUN**

## Connections

- ROB RUN → Memory driver: exposes memory
- Driver transport → Memory driver: sends requests
- Memory driver → Request ABI: uses contract (evidence: `src/driver/robrun_drv.c`)
- Driver transport → Request ABI: uses contract (evidence: `src/overlay/rr_mem.c`)
- Game discovery → Driver transport: reads game memory (evidence: `src/overlay/rr_game.c`)
- Game discovery → IL2CPP helpers: parses objects (evidence: `src/overlay/rr_game.c`)
- Game discovery → Game snapshots: publishes (evidence: `src/overlay/rr_game.c`)
- Overlay runtime → Game discovery: samples state (evidence: `src/overlay/rr_esp.c`)
- Overlay runtime → Game snapshots: consumes snapshots (evidence: `src/overlay/rr_esp.c`)
- Overlay runtime → Aim assist: runs aim assist (evidence: `src/overlay/rr_esp.c`)
- Overlay runtime → ESP and radar: requests repaint (evidence: `src/overlay/rr_esp.c`)
- ESP and radar → Game snapshots: draws snapshots (evidence: `src/overlay/rr_draw.c`)
- ESP and radar → GPU presentation: draws primitives (evidence: `src/overlay/rr_draw.c`)
- ESP and radar → Vehicle chams: uses vehicle model (evidence: `src/overlay/rr_draw.c`)
- Aim assist → Game snapshots: selects targets (evidence: `src/overlay/rr_aim.c`)
- Aim assist → LOS runtime: checks visibility
- LOS runtime → LOS capture: uses captures (evidence: `src/overlay/rr_los_runtime.c`)
- LOS capture → LOS geometry: uses geometry
- Overlay runtime → WebView menu: hosts menu (evidence: `src/overlay/rr_esp.c`)
- WebView menu → Settings storage: updates settings
- Settings storage → Overlay runtime: supplies settings
- ESP and radar → Game snapshots: shows ESP and radar
- Game discovery → Game snapshots: collects loot and vehicles (evidence: `src/overlay/rr_game.c`)
