# savageduck26/gauntlet-delve architecture

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

- Interactive diagram: https://gitdiagram.com/savageduck26/gauntlet-delve
- Repository: https://github.com/savageduck26/gauntlet-delve

## Overview

Gauntlet Delve is a reverse-engineering toolchain for cataloguing Gauntlet: Slayer Edition assets, recovering hashed resource and bundle names, and inspecting or creating game resources and mods. The main recovery loop catalogs game bundles and known names, builds candidate vocabularies, searches unresolved hashes, records hits, then refreshes the catalogue. Separate branches support bundle/resource analysis and mod or asset conversion. The README documents these capabilities; unsampled script implementations are represented at their exact listed paths, with relationships shown only where the README or excerpts support them.

Main entry points: [`hashcracker/src/main.rs`](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/main.rs) (Hash Search CLI), [`hashcracker/tools/make_level_full.py`](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/make_level_full.py) (Candidate Vocabularies), [`scripts/list_game_bundles.py`](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/list_game_bundles.py) (Bundle Catalogue), [`scripts/bundle_tools.py`](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/bundle_tools.py) (Bundle Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalogue and Discovery"]
  node_catalogue["Bundle Catalogue"]
  node_bundlelib["Bundle Utilities<br/>[bundle_tools.py]"]
  node_hashdb["Hash Database Builder"]
end

subgraph group_crack["Name Recovery"]
  node_vocab["Candidate Vocabularies<br/>[make_level_full.py]"]
  node_context["Level Context Vocab"]
  node_spacegen["Grammar Enumeration"]
  node_cracker["Hash Search CLI<br/>[main.rs]"]
  node_patterns["Pattern Compiler<br/>[pattern.rs]"]
  node_arena["Candidate Arena<br/>[arena.rs]"]
  node_hashing["Murmur Hashing<br/>[murmur.rs]"]
  node_gpu["GPU Evaluation<br/>[gpu.rs]"]
  node_substitute["Context Substitution<br/>[substitute.rs]"]
  node_hits["Recovered Names"]
  node_merge["Match Merger<br/>[merge_matches.py]"]
end

subgraph group_inspect["Resource Analysis"]
  node_resource["Resource Read Write"]
  node_bundleinspect["Bundle Inspection<br/>[bundle_inspect.py]"]
  node_export["Resource Export"]
end

subgraph group_create["Asset and Mod Tools"]
  node_modbuilder["Mod Bundle Builder"]
  node_leveltools["Level Conversion<br/>[level_tools.py]"]
  node_glbunit["Template Unit Conversion"]
end

node_engineer(("Engineer"))

node_engineer -->|"catalogs bundles"| node_catalogue
node_catalogue -.->|"uses bundle tools"| node_bundlelib
node_engineer -.->|"builds hash database"| node_hashdb
node_hashdb -->|"reads bundle data"| node_bundlelib
node_engineer -->|"builds candidates"| node_vocab
node_vocab -->|"conditions level search"| node_context
node_engineer -->|"enumerates names"| node_spacegen
node_vocab -->|"supplies candidate inputs"| node_cracker
node_spacegen -.->|"supplies name candidates"| node_cracker
node_cracker -->|"compiles patterns"| node_patterns
node_cracker -->|"fills candidate storage"| node_arena
node_cracker -->|"hashes candidates"| node_hashing
node_cracker -->|"dispatches evaluation"| node_gpu
node_cracker -->|"dispatches subcommand"| node_substitute
node_substitute -->|"evaluates patterns"| node_gpu
node_cracker -->|"appends matches"| node_hits
node_hits -->|"folds in hits"| node_merge
node_merge -->|"refreshes catalogue"| node_catalogue
node_engineer -.->|"inspects bundles"| node_bundleinspect
node_bundleinspect -.->|"uses bundle utilities"| node_bundlelib
node_engineer -.->|"exports resources"| node_export
node_export -.->|"uses resource readers"| node_resource
node_engineer -.->|"builds mods"| node_modbuilder
node_modbuilder -.->|"builds level resources"| node_leveltools
node_engineer -.->|"converts templates"| node_glbunit

click node_catalogue "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/list_game_bundles.py"
click node_bundlelib "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/bundle_tools.py"
click node_hashdb "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/build_complete_hash_database.py"
click node_vocab "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/make_level_full.py"
click node_context "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/make_level_context.py"
click node_spacegen "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/enumerate_spaces.py"
click node_cracker "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/main.rs"
click node_patterns "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/pattern.rs"
click node_arena "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/arena.rs"
click node_hashing "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/murmur.rs"
click node_gpu "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/gpu.rs"
click node_substitute "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/substitute.rs"
click node_merge "https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/merge_matches.py"
click node_resource "https://github.com/savageduck26/gauntlet-delve/tree/main/scripts/resource_tools"
click node_bundleinspect "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/bundle_inspect.py"
click node_export "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/export_all_resources.py"
click node_modbuilder "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/mod_bundle_builder.py"
click node_leveltools "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/resource_tools/level_tools.py"
click node_glbunit "https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/glb_to_template_unit.py"

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_catalogue,node_bundlelib,node_hashdb toneBlue
class node_vocab,node_context,node_spacegen,node_cracker,node_patterns,node_arena,node_hashing,node_gpu,node_substitute,node_hits,node_merge toneAmber
class node_resource,node_bundleinspect,node_export toneMint
class node_modbuilder,node_leveltools,node_glbunit toneRose
class node_engineer toneIndigo
```

## Components

### Catalogue and Discovery

- [Bundle Catalogue](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/list_game_bundles.py): `scripts/list_game_bundles.py`
- [Bundle Utilities](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/bundle_tools.py): `scripts/bundle_tools.py`
- [Hash Database Builder](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/build_complete_hash_database.py): `scripts/build_complete_hash_database.py`

### Name Recovery

- [Candidate Vocabularies](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/make_level_full.py): `hashcracker/tools/make_level_full.py`
- [Level Context Vocab](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/make_level_context.py): `hashcracker/tools/make_level_context.py`
- [Grammar Enumeration](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/enumerate_spaces.py): `hashcracker/tools/enumerate_spaces.py`
- [Hash Search CLI](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/main.rs): `hashcracker/src/main.rs`
- [Pattern Compiler](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/pattern.rs): `hashcracker/src/pattern.rs`
- [Candidate Arena](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/arena.rs): `hashcracker/src/arena.rs`
- [Murmur Hashing](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/murmur.rs): `hashcracker/src/murmur.rs`
- [GPU Evaluation](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/gpu.rs): `hashcracker/src/gpu.rs`
- [Context Substitution](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/src/substitute.rs): `hashcracker/src/substitute.rs`
- **Recovered Names**
- [Match Merger](https://github.com/savageduck26/gauntlet-delve/blob/main/hashcracker/tools/merge_matches.py): `hashcracker/tools/merge_matches.py`

### Resource Analysis

- [Resource Read Write](https://github.com/savageduck26/gauntlet-delve/tree/main/scripts/resource_tools): `scripts/resource_tools`
- [Bundle Inspection](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/bundle_inspect.py): `scripts/bundle_inspect.py`
- [Resource Export](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/export_all_resources.py): `scripts/export_all_resources.py`

### Asset and Mod Tools

- [Mod Bundle Builder](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/mod_bundle_builder.py): `scripts/mod_bundle_builder.py`
- [Level Conversion](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/resource_tools/level_tools.py): `scripts/resource_tools/level_tools.py`
- [Template Unit Conversion](https://github.com/savageduck26/gauntlet-delve/blob/main/scripts/glb_to_template_unit.py): `scripts/glb_to_template_unit.py`

### Other components

- **Engineer**

## Connections

- Engineer → Bundle Catalogue: catalogs bundles
- Bundle Catalogue → Bundle Utilities: uses bundle tools
- Engineer → Hash Database Builder: builds hash database
- Hash Database Builder → Bundle Utilities: reads bundle data (evidence: `scripts/build_complete_hash_database.py`)
- Engineer → Candidate Vocabularies: builds candidates
- Candidate Vocabularies → Level Context Vocab: conditions level search (evidence: `hashcracker/tools/make_level_context.py`)
- Engineer → Grammar Enumeration: enumerates names (evidence: `hashcracker/tools/enumerate_spaces.py`)
- Candidate Vocabularies → Hash Search CLI: supplies candidate inputs
- Grammar Enumeration → Hash Search CLI: supplies name candidates
- Hash Search CLI → Pattern Compiler: compiles patterns (evidence: `hashcracker/src/main.rs`)
- Hash Search CLI → Candidate Arena: fills candidate storage (evidence: `hashcracker/src/main.rs`)
- Hash Search CLI → Murmur Hashing: hashes candidates (evidence: `hashcracker/src/main.rs`)
- Hash Search CLI → GPU Evaluation: dispatches evaluation (evidence: `hashcracker/src/main.rs`)
- Hash Search CLI → Context Substitution: dispatches subcommand (evidence: `hashcracker/src/main.rs`)
- Context Substitution → GPU Evaluation: evaluates patterns (evidence: `hashcracker/src/substitute.rs`)
- Hash Search CLI → Recovered Names: appends matches (evidence: `hashcracker/src/main.rs`)
- Recovered Names → Match Merger: folds in hits
- Match Merger → Bundle Catalogue: refreshes catalogue
- Engineer → Bundle Inspection: inspects bundles
- Bundle Inspection → Bundle Utilities: uses bundle utilities
- Engineer → Resource Export: exports resources
- Resource Export → Resource Read Write: uses resource readers
- Engineer → Mod Bundle Builder: builds mods
- Mod Bundle Builder → Level Conversion: builds level resources
- Engineer → Template Unit Conversion: converts templates
