# iamtherealcat/coddumper architecture

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

- Interactive diagram: https://gitdiagram.com/iamtherealcat/coddumper
- Repository: https://github.com/iamtherealcat/coddumper

## Overview

This is a Windows DLL-based Call of Duty signature scanner and dumper. A caller invokes an exported scan function; the dumper initializes a process scanner, scans the target module using configured signatures, then prints results or writes them to a file. The implementation is compact, so the graph focuses on its actual runtime stages rather than treating the many signature entries as separate features. Process discovery and memory reads are shown as external interactions; both are implemented through Windows APIs in the scanner source.

Main entry points: [`MemoryScanner.cpp`](https://github.com/iamtherealcat/coddumper/blob/main/MemoryScanner.cpp) (Memory scanner), [`coddumper.cpp`](https://github.com/iamtherealcat/coddumper/blob/main/coddumper.cpp) (Scan coordinator), [`dllmain.cpp`](https://github.com/iamtherealcat/coddumper/blob/main/dllmain.cpp) (Exported scan API), [`Signatures.cpp`](https://github.com/iamtherealcat/coddumper/blob/main/Signatures.cpp) (Signature catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["DLL entry"]
  node_exports["Exported scan API<br/>[dllmain.cpp]"]
  node_dumper["Scan coordinator<br/>[coddumper.cpp]"]
end

subgraph group_scanning["Scanning"]
  node_scanner["Memory scanner<br/>[MemoryScanner.cpp]"]
  node_discovery["Process and module lookup<br/>[MemoryScanner.cpp]"]
  node_signatures["Signature catalog<br/>[Signatures.cpp]"]
end

subgraph group_results["Results"]
  node_console["Console output"]
  node_file["Dump file"]
end

node_caller(("DLL caller"))
node_target["Target process memory"]

node_caller -->|"calls"| node_exports
node_exports -->|"dispatches"| node_dumper
node_dumper -->|"initializes and scans"| node_scanner
node_scanner -->|"locates process"| node_discovery
node_scanner -->|"loads patterns"| node_signatures
node_scanner -->|"reads memory"| node_target
node_dumper -->|"prints results"| node_console
node_scanner -->|"writes results"| node_file

click node_exports "https://github.com/iamtherealcat/coddumper/blob/main/dllmain.cpp"
click node_dumper "https://github.com/iamtherealcat/coddumper/blob/main/coddumper.cpp"
click node_scanner "https://github.com/iamtherealcat/coddumper/blob/main/MemoryScanner.cpp"
click node_discovery "https://github.com/iamtherealcat/coddumper/blob/main/MemoryScanner.cpp"
click node_signatures "https://github.com/iamtherealcat/coddumper/blob/main/Signatures.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_exports,node_dumper toneBlue
class node_scanner,node_discovery,node_signatures toneAmber
class node_console,node_file toneMint
class node_caller,node_target toneIndigo
```

## Components

### DLL entry

- [Exported scan API](https://github.com/iamtherealcat/coddumper/blob/main/dllmain.cpp): `dllmain.cpp`
- [Scan coordinator](https://github.com/iamtherealcat/coddumper/blob/main/coddumper.cpp): `coddumper.cpp`

### Scanning

- [Memory scanner](https://github.com/iamtherealcat/coddumper/blob/main/MemoryScanner.cpp): `MemoryScanner.cpp`
- [Process and module lookup](https://github.com/iamtherealcat/coddumper/blob/main/MemoryScanner.cpp): `MemoryScanner.cpp`
- [Signature catalog](https://github.com/iamtherealcat/coddumper/blob/main/Signatures.cpp): `Signatures.cpp`

### Results

- **Console output**
- **Dump file**

### Other components

- **DLL caller**
- **Target process memory**

## Connections

- DLL caller → Exported scan API: calls (evidence: `dllmain.cpp`)
- Exported scan API → Scan coordinator: dispatches (evidence: `dllmain.cpp`)
- Scan coordinator → Memory scanner: initializes and scans (evidence: `coddumper.cpp`)
- Memory scanner → Process and module lookup: locates process (evidence: `MemoryScanner.cpp`)
- Memory scanner → Signature catalog: loads patterns (evidence: `MemoryScanner.cpp`)
- Memory scanner → Target process memory: reads memory (evidence: `MemoryScanner.cpp`)
- Scan coordinator → Console output: prints results (evidence: `coddumper.cpp`)
- Memory scanner → Dump file: writes results (evidence: `MemoryScanner.cpp`)
