# read1dno/vesta architecture

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

- Interactive diagram: https://gitdiagram.com/read1dno/vesta
- Repository: https://github.com/read1dno/vesta

## Overview

Vesta is a Windows external Counter-Strike 2 client: it reads game state, exposes configurable combat and presentation features, and displays results in an overlay. The documented user workflow is to run Vesta alongside CS2, configure features in the Insert menu, and use their in-game effects; local Lua scripts extend snapshots with UI and drawing APIs. The README supports the capability map, while sampled overlay code confirms its HUD and scripting dependencies. Most feature implementations were not excerpted, so internal feature-to-state and feature-to-render calls are intentionally not asserted.

Main entry points: [`src/config/settings.cpp`](https://github.com/read1dno/vesta/blob/main/src/config/settings.cpp) (Configuration), [`src/render/overlay/overlay.cpp`](https://github.com/read1dno/vesta/blob/main/src/render/overlay/overlay.cpp) (External overlay), [`src/scripting/runtime.cpp`](https://github.com/read1dno/vesta/blob/main/src/scripting/runtime.cpp) (Lua runtime), [`src/app/main.cpp`](https://github.com/read1dno/vesta/blob/main/src/app/main.cpp) (Application startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and State"]
  node_entry["Application startup<br/>[main.cpp]"]
  node_workers["Background workers<br/>[workers.cpp]"]
  node_memory["Process memory access<br/>[process.cpp]"]
  node_world["Game state<br/>[world.cpp]"]
  node_settings["Configuration<br/>[settings.cpp]"]
end

subgraph group_combat["Combat Assistance"]
  node_aim["Aim and recoil<br/>[aimbot.cpp]"]
  node_trigger["Trigger assistance<br/>[seed_trigger.cpp]"]
  node_legit["Legit assistance<br/>[legitbot.cpp]"]
  node_movement["Movement tools<br/>[bhop.cpp]"]
end

subgraph group_visuals["Visual Features"]
  node_playeresp["Player ESP<br/>[player.cpp]"]
  node_radar["Radar<br/>[radar.cpp]"]
  node_worldvisuals["World visuals"]
  node_chams["Chams rendering<br/>[renderer.cpp]"]
end

subgraph group_interface["Overlay and Interface"]
  node_overlay["External overlay<br/>[overlay.cpp]"]
  node_menu["Settings menu<br/>[menu.cpp]"]
  node_hud["Overlay HUD<br/>[hud.cpp]"]
end

subgraph group_extensions["Simulation and Scripting"]
  node_simulation["Game simulation<br/>[ballistics.cpp]"]
  node_lua["Lua runtime<br/>[runtime.cpp]"]
  node_radarasset["Radar script asset<br/>[radar_asset.cpp]"]
end

node_player(("Vesta user"))
node_cs2["Counter-Strike 2"]

node_player -->|"launches"| node_entry
node_cs2 -->|"read-only access"| node_memory
node_entry -.->|"runs overlay"| node_overlay
node_player -->|"configures"| node_menu
node_menu -.->|"edits settings"| node_settings
node_settings -->|"configures"| node_aim
node_settings -->|"configures"| node_trigger
node_settings -->|"configures"| node_legit
node_settings -->|"configures"| node_movement
node_settings -->|"configures"| node_playeresp
node_settings -->|"configures"| node_radar
node_settings -->|"configures"| node_worldvisuals
node_aim -->|"assists combat"| node_player
node_trigger -->|"assists firing"| node_player
node_playeresp -->|"presents ESP"| node_overlay
node_radar -->|"presents radar"| node_overlay
node_worldvisuals -->|"presents visuals"| node_overlay
node_overlay -->|"uses HUD"| node_hud
node_overlay -->|"uses runtime"| node_lua
node_player -->|"loads scripts"| node_lua
node_lua -.->|"runs radar asset"| node_radarasset
node_simulation -->|"supports predictions"| node_player
node_workers -.->|"updates state"| node_world

click node_entry "https://github.com/read1dno/vesta/blob/main/src/app/main.cpp"
click node_workers "https://github.com/read1dno/vesta/blob/main/src/app/workers.cpp"
click node_memory "https://github.com/read1dno/vesta/blob/main/src/core/memory/process.cpp"
click node_world "https://github.com/read1dno/vesta/blob/main/src/core/state/world.cpp"
click node_settings "https://github.com/read1dno/vesta/blob/main/src/config/settings.cpp"
click node_aim "https://github.com/read1dno/vesta/blob/main/src/features/aimbot/aimbot.cpp"
click node_trigger "https://github.com/read1dno/vesta/blob/main/src/features/trigger/seed_trigger.cpp"
click node_legit "https://github.com/read1dno/vesta/blob/main/src/features/legitbot/legitbot.cpp"
click node_movement "https://github.com/read1dno/vesta/blob/main/src/features/misc/bhop.cpp"
click node_playeresp "https://github.com/read1dno/vesta/blob/main/src/features/visuals/player.cpp"
click node_radar "https://github.com/read1dno/vesta/blob/main/src/features/visuals/radar.cpp"
click node_worldvisuals "https://github.com/read1dno/vesta/blob/main/src/features/visuals/grenade_prediction.cpp"
click node_chams "https://github.com/read1dno/vesta/blob/main/src/render/chams/renderer.cpp"
click node_overlay "https://github.com/read1dno/vesta/blob/main/src/render/overlay/overlay.cpp"
click node_menu "https://github.com/read1dno/vesta/blob/main/src/render/menu/menu.cpp"
click node_hud "https://github.com/read1dno/vesta/blob/main/src/render/overlay/hud.cpp"
click node_simulation "https://github.com/read1dno/vesta/blob/main/src/simulation/ballistics.cpp"
click node_lua "https://github.com/read1dno/vesta/blob/main/src/scripting/runtime.cpp"
click node_radarasset "https://github.com/read1dno/vesta/blob/main/src/scripting/radar_asset.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_entry,node_workers,node_memory,node_world,node_settings,node_player toneBlue
class node_aim,node_trigger,node_legit,node_movement toneAmber
class node_playeresp,node_radar,node_worldvisuals,node_chams toneMint
class node_overlay,node_menu,node_hud toneRose
class node_simulation,node_lua,node_radarasset,node_cs2 toneIndigo
```

## Components

### Application and State

- [Application startup](https://github.com/read1dno/vesta/blob/main/src/app/main.cpp): `src/app/main.cpp`
- [Background workers](https://github.com/read1dno/vesta/blob/main/src/app/workers.cpp): `src/app/workers.cpp`
- [Process memory access](https://github.com/read1dno/vesta/blob/main/src/core/memory/process.cpp): `src/core/memory/process.cpp`
- [Game state](https://github.com/read1dno/vesta/blob/main/src/core/state/world.cpp): `src/core/state/world.cpp`
- [Configuration](https://github.com/read1dno/vesta/blob/main/src/config/settings.cpp): `src/config/settings.cpp`

### Combat Assistance

- [Aim and recoil](https://github.com/read1dno/vesta/blob/main/src/features/aimbot/aimbot.cpp): `src/features/aimbot/aimbot.cpp`
- [Trigger assistance](https://github.com/read1dno/vesta/blob/main/src/features/trigger/seed_trigger.cpp): `src/features/trigger/seed_trigger.cpp`
- [Legit assistance](https://github.com/read1dno/vesta/blob/main/src/features/legitbot/legitbot.cpp): `src/features/legitbot/legitbot.cpp`
- [Movement tools](https://github.com/read1dno/vesta/blob/main/src/features/misc/bhop.cpp): `src/features/misc/bhop.cpp`

### Visual Features

- [Player ESP](https://github.com/read1dno/vesta/blob/main/src/features/visuals/player.cpp): `src/features/visuals/player.cpp`
- [Radar](https://github.com/read1dno/vesta/blob/main/src/features/visuals/radar.cpp): `src/features/visuals/radar.cpp`
- [World visuals](https://github.com/read1dno/vesta/blob/main/src/features/visuals/grenade_prediction.cpp): `src/features/visuals/grenade_prediction.cpp`
- [Chams rendering](https://github.com/read1dno/vesta/blob/main/src/render/chams/renderer.cpp): `src/render/chams/renderer.cpp`

### Overlay and Interface

- [External overlay](https://github.com/read1dno/vesta/blob/main/src/render/overlay/overlay.cpp): `src/render/overlay/overlay.cpp`
- [Settings menu](https://github.com/read1dno/vesta/blob/main/src/render/menu/menu.cpp): `src/render/menu/menu.cpp`
- [Overlay HUD](https://github.com/read1dno/vesta/blob/main/src/render/overlay/hud.cpp): `src/render/overlay/hud.cpp`

### Simulation and Scripting

- [Game simulation](https://github.com/read1dno/vesta/blob/main/src/simulation/ballistics.cpp): `src/simulation/ballistics.cpp`
- [Lua runtime](https://github.com/read1dno/vesta/blob/main/src/scripting/runtime.cpp): `src/scripting/runtime.cpp`
- [Radar script asset](https://github.com/read1dno/vesta/blob/main/src/scripting/radar_asset.cpp): `src/scripting/radar_asset.cpp`

### Other components

- **Vesta user**
- **Counter-Strike 2**

## Connections

- Vesta user → Application startup: launches (evidence: `README.md`)
- Counter-Strike 2 → Process memory access: read-only access (evidence: `README.md`)
- Application startup → External overlay: runs overlay
- Vesta user → Settings menu: configures (evidence: `README.md`)
- Settings menu → Configuration: edits settings
- Configuration → Aim and recoil: configures (evidence: `README.md`)
- Configuration → Trigger assistance: configures (evidence: `README.md`)
- Configuration → Legit assistance: configures (evidence: `README.md`)
- Configuration → Movement tools: configures (evidence: `README.md`)
- Configuration → Player ESP: configures (evidence: `README.md`)
- Configuration → Radar: configures (evidence: `README.md`)
- Configuration → World visuals: configures (evidence: `README.md`)
- Aim and recoil → Vesta user: assists combat (evidence: `README.md`)
- Trigger assistance → Vesta user: assists firing (evidence: `README.md`)
- Player ESP → External overlay: presents ESP (evidence: `README.md`)
- Radar → External overlay: presents radar (evidence: `README.md`)
- World visuals → External overlay: presents visuals (evidence: `README.md`)
- External overlay → Overlay HUD: uses HUD (evidence: `src/render/overlay/overlay.cpp`)
- External overlay → Lua runtime: uses runtime (evidence: `src/render/overlay/overlay.cpp`)
- Vesta user → Lua runtime: loads scripts (evidence: `README.md`)
- Lua runtime → Radar script asset: runs radar asset
- Game simulation → Vesta user: supports predictions (evidence: `README.md`)
- Background workers → Game state: updates state
