# intelsdm/huntdma architecture

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

- Interactive diagram: https://gitdiagram.com/intelsdm/huntdma
- Repository: https://github.com/intelsdm/huntdma

## Overview

1. This repository is a Windows C++ external cheat for Hunt: Showdown built around DMA-based memory access. The core architecture is not game injection; instead, it reads game state through PCILeech/MemProcFS-style libraries and then renders its own overlay/UI.

2. The top-level entry point is `Main.cpp`, which likely boots the runtime, initializes memory access, loads config, starts the GUI/overlay, and enters the main update loop.

3. The lowest-level boundary is `Memory/`. This is the hardware-facing layer: `Memory.cpp`, `InputManager.cpp`, and `Registry.cpp` encapsulate DMA reads, input handling, and any OS-level persistence or support functions. The included `leechcore.h`, `vmmdll.h`, and `FTD3XX.lib` show the project depends on external DMA tooling and an FTDI-based device stack.

4. `SDK/` is the game model layer. It defines typed views over Hunt’s in-memory data, such as `WorldEntity`, `Camera`, and `Environment`. This is where raw memory offsets become meaningful objects like players, bosses, items, and the world state used by the cheat features.

5. The feature layer is split by use case:
   - `Esp/PlayerEsp.cpp` and `Esp/OtherEsp.cpp` handle rendering logic for players and world entities.
   - `Aimbot/Aimbot.cpp` contains target selection and aim assistance behavior.
   - `Misc/SpectatorAlarm.cpp`, `Misc/FPS.cpp`, and related files implement auxiliary runtime features like spectator warning and frame-rate display.
   These modules consume SDK data and produce either visual output or input-side actions.

6. `Graphics/` is a self-contained UI and rendering framework. `Graphics/Drawing.*` provides primitive drawing, while `Graphics/Entities/` implements custom controls such as tabs, buttons, sliders, toggles, dropdowns, color pickers, and text boxes. This is the foundation for the in-app configuration menu and overlay widgets.

7. The GUI startup path lives under `Graphics/Start Up/`. `Init.*` and `GUI.*` suggest a dedicated initialization sequence for graphics context creation, overlay setup, and menu wiring before the main feature loop begins.

8. Configuration is its own subsystem under `Config/`. There are feature-specific config types for aimbot, overlay, players, bosses, supplies, traps, points of interest, and blood bonds. `ConfigInstance.h` and `ConfigUtilities.*` centralize load/save behavior so feature modules read settings through a shared configuration boundary.

9. `Globals.h`, `Misc/Vector.*`, and `Misc/CheatFunction.*` provide shared math, common runtime state, and cross-feature helper logic. These are the glue pieces that reduce duplication between ESP, aimbot, and rendering code.

10. `Misc/Input.*` and `Memory/InputManager.*` form the input boundary. One layer appears to read/normalize user input, while the other likely bridges that input into the cheat’s runtime decisions such as keybinds, toggles, or aim activation.

11. `Graphics/Utility/` contains supporting visual and device-related helpers: fonts, color handling, animation, and `Kmbox`, which suggests optional integration with external mouse/keyboard hardware or input emulation. This is part of the presentation/input edge rather than the game-state core.

12. `Security/XorStr.h` is a lightweight string-obfuscation layer, typically used to avoid plain-text literals in the binary. It doesn’t change the main architecture, but it is a cross-cutting concern in a cheat codebase.

13. The main runtime data flow is: DMA memory read → SDK entities/world state → feature modules compute targets/labels/distances → graphics layer draws the ESP/menu → input/config layers control behavior and persistence. The main architectural boundary is between external game memory access and the rest of the application logic.

14. From a diagramming perspective, the important boxes are: external DMA hardware + VMM libraries, memory abstraction layer, Hunt SDK model layer, feature modules, graphics/UI subsystem, and configuration/persistence. The feature modules all depend on the SDK and config layers, while the UI depends on the graphics utilities and shared runtime state.

Main entry points: [`HuntDMA/Config/ConfigUtilities.cpp`](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Config/ConfigUtilities.cpp) (Config utils), [`HuntDMA/Main.cpp`](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Main.cpp) (Main), [`HuntDMA/Memory/Memory.cpp`](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/Memory.cpp) (Memory), [`HuntDMA/SDK/Environment.cpp`](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/Environment.cpp) (Environment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime core"]
  node_main["Main<br/>entrypoint<br/>[Main.cpp]"]
  node_memory[("Memory<br/>dma access<br/>[Memory.cpp]")]
  node_inputmgr["Input mgr<br/>device bridge<br/>[InputManager.cpp]"]
  node_registry["Registry<br/>persistence<br/>[Registry.cpp]"]
end

subgraph group_model["Game model"]
  node_worldentity["World entity<br/>entity model<br/>[WorldEntity.cpp]"]
  node_camera["Camera<br/>view model<br/>[Camera.cpp]"]
  node_environment["Environment<br/>world model<br/>[Environment.cpp]"]
end

subgraph group_features["Cheat features"]
  node_playeresp["Player ESP<br/>overlay feature<br/>[PlayerEsp.cpp]"]
  node_otheresp["Other ESP<br/>overlay feature<br/>[OtherEsp.cpp]"]
  node_aimbot["Aimbot<br/>targeting feature<br/>[Aimbot.cpp]"]
  node_spectator["Spectator alarm<br/>alert feature<br/>[SpectatorAlarm.cpp]"]
  node_fps["FPS<br/>status feature<br/>[FPS.cpp]"]
end

subgraph group_ui["Graphics/UI"]
  node_drawing["Drawing<br/>rendering core<br/>[Drawing.cpp]"]
  node_guiinit["GUI init<br/>startup<br/>[Init.cpp]"]
  node_gui["GUI<br/>menu shell<br/>[GUI.cpp]"]
  node_entities["Controls<br/>ui widgets<br/>[Entity.cpp]"]
  node_gfxutil["Graphics utils<br/>support libs<br/>[Font.cpp]"]
end

subgraph group_config["Configuration"]
  node_configutil["Config utils<br/>persistence core"]
end

subgraph group_misc["Shared helpers"]
  node_globals["Globals<br/>shared state<br/>[Globals.h]"]
  node_cheatfn["Cheat funcs<br/>helper layer<br/>[CheatFunction.cpp]"]
  node_vector["Vector math<br/>math helpers<br/>[Vector.cpp]"]
  node_input["Input<br/>[Input.cpp]"]
end

subgraph group_security["Security"]
  node_xorstr{{"XorStr<br/>obfuscation<br/>[XorStr.h]"}}
end

node_main -->|"init/read"| node_memory
node_main -->|"startup"| node_guiinit
node_main -->|"load/save"| node_configutil
node_main -->|"binds"| node_inputmgr
node_main -->|"runtime state"| node_globals
node_memory -->|"feeds"| node_worldentity
node_memory -->|"feeds"| node_camera
node_memory -->|"feeds"| node_environment
node_worldentity -->|"consumed by"| node_playeresp
node_worldentity -->|"consumed by"| node_otheresp
node_camera -->|"math input"| node_playeresp
node_camera -->|"math input"| node_aimbot
node_environment -->|"consumed by"| node_otheresp
node_environment -->|"consumed by"| node_spectator
node_environment -->|"consumed by"| node_fps
node_aimbot -->|"aim control"| node_inputmgr
node_playeresp -->|"renders via"| node_drawing
node_otheresp -->|"renders via"| node_drawing
node_guiinit -->|"wires"| node_gui
node_gui -->|"renders via"| node_drawing
node_gui -->|"composes"| node_entities
node_entities -->|"uses"| node_gfxutil
node_playeresp -->|"settings"| node_configutil
node_otheresp -->|"settings"| node_configutil
node_aimbot -->|"settings"| node_configutil
node_spectator -->|"settings"| node_configutil
node_fps -->|"settings"| node_configutil
node_configutil -->|"persist"| node_registry
node_cheatfn -->|"math"| node_vector
node_cheatfn -->|"state"| node_globals
node_input -->|"bridges"| node_inputmgr
node_input -->|"controls"| node_cheatfn
node_xorstr -.->|"obfuscates"| node_main
node_xorstr -.->|"obfuscates"| node_gui

click node_main "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Main.cpp"
click node_memory "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/Memory.cpp"
click node_inputmgr "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/InputManager.cpp"
click node_registry "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/Registry.cpp"
click node_worldentity "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/WorldEntity.cpp"
click node_camera "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/Camera.cpp"
click node_environment "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/Environment.cpp"
click node_playeresp "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Esp/PlayerEsp.cpp"
click node_otheresp "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Esp/OtherEsp.cpp"
click node_aimbot "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Aimbot/Aimbot.cpp"
click node_spectator "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/SpectatorAlarm.cpp"
click node_fps "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/FPS.cpp"
click node_drawing "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Drawing.cpp"
click node_guiinit "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Start Up/Init.cpp"
click node_gui "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Start Up/GUI.cpp"
click node_entities "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Entities/Entity.cpp"
click node_gfxutil "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Utility/Font.cpp"
click node_configutil "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Config/ConfigUtilities.cpp"
click node_globals "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Globals.h"
click node_cheatfn "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/CheatFunction.cpp"
click node_vector "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/Vector.cpp"
click node_input "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/Input.cpp"
click node_xorstr "https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Security/XorStr.h"

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_main,node_memory,node_inputmgr,node_registry,node_xorstr toneBlue
class node_worldentity,node_camera,node_environment toneAmber
class node_playeresp,node_otheresp,node_aimbot,node_spectator,node_fps toneMint
class node_drawing,node_guiinit,node_gui,node_entities,node_gfxutil toneRose
class node_configutil toneIndigo
class node_globals,node_cheatfn,node_vector,node_input toneTeal
```

## Components

### Runtime core

Process entry, memory access, and shared runtime state.

- [Main](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Main.cpp): entrypoint · Bootstraps runtime, memory access, UI, and the main loop. · `HuntDMA/Main.cpp`
- [Memory](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/Memory.cpp): dma access · Hardware-facing DMA read layer and core memory operations. · `HuntDMA/Memory/Memory.cpp`
- [Input mgr](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/InputManager.cpp): device bridge · Bridges user/device input into runtime decisions and bindings. · `HuntDMA/Memory/InputManager.cpp`
- [Registry](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Memory/Registry.cpp): persistence · OS-level support and stored state helpers. · `HuntDMA/Memory/Registry.cpp`

### Game model

Typed views over Hunt in-memory state.

- [World entity](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/WorldEntity.cpp): entity model · Typed representation of players, loot, bosses, and other world objects. · `HuntDMA/SDK/WorldEntity.cpp`
- [Camera](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/Camera.cpp): view model · Camera and view-state model used by targeting and overlay math. · `HuntDMA/SDK/Camera.cpp`
- [Environment](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/SDK/Environment.cpp): world model · World and scene-level game state used by feature logic. · `HuntDMA/SDK/Environment.cpp`

### Cheat features

Gameplay logic built on SDK state and config.

- [Player ESP](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Esp/PlayerEsp.cpp): overlay feature · Draws player-specific ESP visuals and labels. · `HuntDMA/Esp/PlayerEsp.cpp`
- [Other ESP](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Esp/OtherEsp.cpp): overlay feature · Draws non-player world entities such as items and points of interest. · `HuntDMA/Esp/OtherEsp.cpp`
- [Aimbot](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Aimbot/Aimbot.cpp): targeting feature · Selects targets and drives aim assistance behavior. · `HuntDMA/Aimbot/Aimbot.cpp`
- [Spectator alarm](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/SpectatorAlarm.cpp): alert feature · Warns when the player is being observed. · `HuntDMA/Misc/SpectatorAlarm.cpp`
- [FPS](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/FPS.cpp): status feature · Displays frame-rate or runtime performance information. · `HuntDMA/Misc/FPS.cpp`

### Graphics/UI

Overlay rendering and in-app menu controls.

- [Drawing](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Drawing.cpp): rendering core · Primitive drawing and overlay rendering helpers. · `HuntDMA/Graphics/Drawing.cpp`
- [GUI init](https://github.com/intelsdm/huntdma/blob/HEAD/HuntDMA/Graphics/Start%20Up/Init.cpp): startup · Initializes graphics context and wires the menu UI. · `HuntDMA/Graphics/Start Up/Init.cpp`
- [GUI](https://github.com/intelsdm/huntdma/blob/HEAD/HuntDMA/Graphics/Start%20Up/GUI.cpp): menu shell · Top-level overlay/menu startup and coordination. · `HuntDMA/Graphics/Start Up/GUI.cpp`
- [Controls](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Entities/Entity.cpp): ui widgets · Custom UI controls such as tabs, buttons, sliders, toggles, and inputs. · `HuntDMA/Graphics/Entities/Entity.cpp`
- [Graphics utils](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Graphics/Utility/Font.cpp): support libs · Fonts, colors, animation, and Kmbox integration helpers. · `HuntDMA/Graphics/Utility/Font.cpp`

### Configuration

Load/save boundary for feature settings.

- [Config utils](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Config/ConfigUtilities.cpp): persistence core · Shared load/save and config-instance plumbing. · `HuntDMA/Config/ConfigUtilities.cpp`

### Shared helpers

Cross-cutting utilities and common helpers.

- [Globals](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Globals.h): shared state · Common runtime state and cross-feature shared values. · `HuntDMA/Globals.h`
- [Cheat funcs](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/CheatFunction.cpp): helper layer · Common logic shared across ESP, aimbot, and rendering modules. · `HuntDMA/Misc/CheatFunction.cpp`
- [Vector math](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/Vector.cpp): math helpers · Shared vector and geometry utilities. · `HuntDMA/Misc/Vector.cpp`
- [Input](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Misc/Input.cpp): input helpers · Higher-level input handling used by features and UI. · `HuntDMA/Misc/Input.cpp`

### Security

String obfuscation and related hardening.

- [XorStr](https://github.com/intelsdm/huntdma/blob/main/HuntDMA/Security/XorStr.h): obfuscation · String obfuscation helper for literals and identifiers. · `HuntDMA/Security/XorStr.h`

## Connections

- Main → Memory: init/read · Bootstraps DMA-backed game access.
- Main → GUI init: startup · Starts the graphics and overlay path.
- Main → Config utils: load/save · Loads and persists feature settings.
- Main → Input mgr: binds · Initializes input handling and runtime controls.
- Main → Globals: runtime state · Uses shared state during the main loop.
- Memory → World entity: feeds · Provides raw state for entity decoding.
- Memory → Camera: feeds · Provides camera/view data.
- Memory → Environment: feeds · Provides world/environment data.
- World entity → Player ESP: consumed by · Player entity data drives ESP rendering.
- World entity → Other ESP: consumed by · World entities drive non-player ESP.
- Camera → Player ESP: math input · View data supports screen-space projection.
- Camera → Aimbot: math input · Camera state supports targeting calculations.
- Environment → Other ESP: consumed by · World state drives environmental overlays.
- Environment → Spectator alarm: consumed by · Environment/state is inspected for alerts.
- Environment → FPS: consumed by · Runtime state contributes to status display.
- Aimbot → Input mgr: aim control · Uses input/device control for activation and aim output.
- Player ESP → Drawing: renders via · ESP output is drawn through the rendering core.
- Other ESP → Drawing: renders via · World overlays are drawn through the rendering core.
- GUI init → GUI: wires · Initializes and presents the menu shell.
- GUI → Drawing: renders via · Menu and overlay widgets use drawing primitives.
- GUI → Controls: composes · The menu is built from custom controls.
- Controls → Graphics utils: uses · Widgets rely on fonts, colors, animation, and device helpers.
- Player ESP → Config utils: settings · Reads feature configuration.
- Other ESP → Config utils: settings · Reads feature configuration.
- Aimbot → Config utils: settings · Reads feature configuration.
- Spectator alarm → Config utils: settings · Reads feature configuration.
- FPS → Config utils: settings · Reads feature configuration.
- Config utils → Registry: persist · Can store settings through OS-backed support.
- Cheat funcs → Vector math: math · Shares geometry and vector helpers.
- Cheat funcs → Globals: state · Uses common runtime values.
- Input → Input mgr: bridges · Higher-level input processing connects to device input.
- Input → Cheat funcs: controls · Input decisions feed shared feature logic.
- XorStr → Main: obfuscates · String hiding applies cross-cuttingly.
- XorStr → GUI: obfuscates · String hiding applies cross-cuttingly.
