# sfrdevelopment/sot-eac-kernel-bypass architecture

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

- Interactive diagram: https://gitdiagram.com/sfrdevelopment/sot-eac-kernel-bypass
- Repository: https://github.com/sfrdevelopment/sot-eac-kernel-bypass

## Overview

This is a single-file Windows kernel driver for injecting a DLL into Sea of Thieves while attempting to evade Easy Anti-Cheat. Its documented workflow is: a user-mode loader supplies configuration through shared memory; the driver waits for the game to become ready, manually maps the DLL, and arranges one-shot execution through the Steam overlay, with a syscall-stub fallback. The README describes several internal mapping and concealment stages, but the source excerpt is partial, so those relationships are cited to the README rather than presented as independently inspected implementation details.

Main entry points: [`main.cpp`](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp) (Manual mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_driver["Driver runtime"]
  node_config[("Shared config section<br/>[main.cpp]")]
  node_entry["Driver entry<br/>[main.cpp]"]
  node_worker["Injection worker<br/>[main.cpp]"]
  node_readiness["Process readiness<br/>[main.cpp]"]
end

subgraph group_mapping["Mapping and concealment"]
  node_mapper["Manual mapper<br/>[main.cpp]"]
  node_pe["PE sections and relocations<br/>[main.cpp]"]
  node_imports["Import resolver<br/>[main.cpp]"]
  node_pte["PTE executable pages<br/>[main.cpp]"]
  node_exceptions["Exception registration<br/>[main.cpp]"]
end

subgraph group_execution["Execution routes"]
  node_overlay["Steam overlay hook<br/>[main.cpp]"]
  node_fallback["Syscall-stub fallback<br/>[main.cpp]"]
  node_shellcode["One-shot shellcode<br/>[main.cpp]"]
end

node_loader(("User-mode loader"))
node_game["Sea of Thieves process"]
node_ntkernel["Windows kernel APIs"]
node_steam["Steam overlay module"]
node_ntdll["Target ntdll"]

node_loader -->|"writes settings"| node_config
node_worker -->|"reads settings"| node_config
node_entry -->|"starts thread"| node_worker
node_worker -->|"waits for"| node_readiness
node_readiness -->|"checks modules"| node_game
node_worker -->|"maps DLL"| node_mapper
node_mapper -->|"maps into"| node_game
node_mapper -->|"copies and rebases"| node_pe
node_mapper -->|"resolves imports"| node_imports
node_imports -->|"reads module list"| node_game
node_mapper -->|"adjusts page entries"| node_pte
node_mapper -->|"registers unwind data"| node_exceptions
node_mapper -->|"patches Present pointer"| node_overlay
node_overlay -->|"uses stored pointer"| node_steam
node_steam -->|"dispatches on Present"| node_shellcode
node_mapper -->|"patches when unavailable"| node_fallback
node_fallback -->|"patches syscall stub"| node_ntdll
node_ntdll -->|"dispatches patched stub"| node_shellcode
node_shellcode -->|"registers function table"| node_exceptions
node_shellcode -->|"calls DLL entry point"| node_game
node_mapper -->|"uses kernel services"| node_ntkernel

click node_config "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_entry "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_worker "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_readiness "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_mapper "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_pe "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_imports "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_pte "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_exceptions "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_overlay "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_fallback "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp"
click node_shellcode "https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.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_config,node_entry,node_worker,node_readiness,node_loader toneBlue
class node_mapper,node_pe,node_imports,node_pte,node_exceptions toneAmber
class node_overlay,node_fallback,node_shellcode,node_ntkernel toneMint
class node_game,node_steam,node_ntdll toneIndigo
```

## Components

### Driver runtime

- [Shared config section](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [Driver entry](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [Injection worker](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [Process readiness](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`

### Mapping and concealment

- [Manual mapper](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [PE sections and relocations](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [Import resolver](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [PTE executable pages](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [Exception registration](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`

### Execution routes

- [Steam overlay hook](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [Syscall-stub fallback](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`
- [One-shot shellcode](https://github.com/sfrdevelopment/sot-eac-kernel-bypass/blob/main/main.cpp): `main.cpp`

### Other components

- **User-mode loader**
- **Sea of Thieves process**
- **Windows kernel APIs**
- **Steam overlay module**
- **Target ntdll**

## Connections

- User-mode loader → Shared config section: writes settings (evidence: `README.md`)
- Injection worker → Shared config section: reads settings (evidence: `README.md`)
- Driver entry → Injection worker: starts thread (evidence: `README.md`)
- Injection worker → Process readiness: waits for (evidence: `README.md`)
- Process readiness → Sea of Thieves process: checks modules (evidence: `main.cpp`)
- Injection worker → Manual mapper: maps DLL (evidence: `README.md`)
- Manual mapper → Sea of Thieves process: maps into (evidence: `README.md`)
- Manual mapper → PE sections and relocations: copies and rebases (evidence: `README.md`)
- Manual mapper → Import resolver: resolves imports (evidence: `README.md`)
- Import resolver → Sea of Thieves process: reads module list (evidence: `README.md`)
- Manual mapper → PTE executable pages: adjusts page entries (evidence: `README.md`)
- Manual mapper → Exception registration: registers unwind data (evidence: `README.md`)
- Manual mapper → Steam overlay hook: patches Present pointer (evidence: `README.md`)
- Steam overlay hook → Steam overlay module: uses stored pointer (evidence: `README.md`)
- Steam overlay module → One-shot shellcode: dispatches on Present (evidence: `README.md`)
- Manual mapper → Syscall-stub fallback: patches when unavailable (evidence: `README.md`)
- Syscall-stub fallback → Target ntdll: patches syscall stub (evidence: `README.md`)
- Target ntdll → One-shot shellcode: dispatches patched stub (evidence: `README.md`)
- One-shot shellcode → Exception registration: registers function table (evidence: `README.md`)
- One-shot shellcode → Sea of Thieves process: calls DLL entry point (evidence: `README.md`)
- Manual mapper → Windows kernel APIs: uses kernel services (evidence: `README.md`)
