How savageduck26/gauntlet-delve works
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: main.rs Hash Search CLI · make_level_full.py Candidate Vocabularies · list_game_bundles.py Bundle Catalogue · bundle_tools.py Bundle Utilities
Components 21
Catalogue and Discovery
- Bundle Catalogue
scripts/list_game_bundles.py - Bundle Utilities
scripts/bundle_tools.py - Hash Database Builder
scripts/build_complete_hash_database.py
Name Recovery
- Candidate Vocabularies
hashcracker/tools/make_level_full.py - Level Context Vocab
hashcracker/tools/make_level_context.py - Grammar Enumeration
hashcracker/tools/enumerate_spaces.py - Hash Search CLI
hashcracker/src/main.rs - Pattern Compiler
hashcracker/src/pattern.rs - Candidate Arena
hashcracker/src/arena.rs - Murmur Hashing
hashcracker/src/murmur.rs - GPU Evaluation
hashcracker/src/gpu.rs - Context Substitution
hashcracker/src/substitute.rs - Recovered Names
- Match Merger
hashcracker/tools/merge_matches.py
Resource Analysis
- Resource Read Write
scripts/resource_tools - Bundle Inspection
scripts/bundle_inspect.py - Resource Export
scripts/export_all_resources.py
Asset and Mod Tools
- Mod Bundle Builder
scripts/mod_bundle_builder.py - Level Conversion
scripts/resource_tools/level_tools.py - Template Unit Conversion
scripts/glb_to_template_unit.py
Other components
- Engineer
Connections 25
- 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
scripts/build_complete_hash_database.py - Engineer → Candidate Vocabularies: builds candidates
- Candidate Vocabularies → Level Context Vocab: conditions level search
hashcracker/tools/make_level_context.py - Engineer → Grammar Enumeration: enumerates names
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
hashcracker/src/main.rs - Hash Search CLI → Candidate Arena: fills candidate storage
hashcracker/src/main.rs - Hash Search CLI → Murmur Hashing: hashes candidates
hashcracker/src/main.rs - Hash Search CLI → GPU Evaluation: dispatches evaluation
hashcracker/src/main.rs - Hash Search CLI → Context Substitution: dispatches subcommand
hashcracker/src/main.rs - Context Substitution → GPU Evaluation: evaluates patterns
hashcracker/src/substitute.rs - Hash Search CLI → Recovered Names: appends matches
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