Skip to content

Direct Downloader

Sebastiano Gelmetti edited this page Feb 19, 2026 · 1 revision
╔══════════════════════════════════════════════════════════════════════════╗
║                                                                          ║
║     ██████╗ ██╗██████╗ ███████╗ ██████╗████████╗                        ║
║     ██╔══██╗██║██╔══██╗██╔════╝██╔════╝╚══██╔══╝                        ║
║     ██║  ██║██║██████╔╝█████╗  ██║      ░░██║░░░                        ║
║     ██║  ██║██║██╔══██╗██╔══╝  ██║      ░░██║░░░                        ║
║     ██████╔╝██║██║  ██║███████╗╚██████╗ ░░██║░░░                        ║
║     ╚═════╝ ╚═╝╚═╝  ╚═╝╚══════╝ ╚═════╝ ░░╚═╝░░░                        ║
║                                                                          ║
║     ██████╗  ██████╗ ██╗    ██╗███╗   ██╗██╗      ██████╗  █████╗ ██████╗║
║     ██╔══██╗██╔═══██╗██║    ██║████╗  ██║██║     ██╔═══██╗██╔══██╗██╔══██║
║     ██║  ██║██║   ██║██║ █╗ ██║██╔██╗ ██║██║     ██║   ██║███████║██║  ██║
║     ██║  ██║██║   ██║██║███╗██║██║╚██╗██║██║     ██║   ██║██╔══██║██║  ██║
║     ██████╔╝╚██████╔╝╚███╔███╔╝██║ ╚████║███████╗╚██████╔╝██║  ██║██████╔║
║     ╚═════╝  ╚═════╝  ╚══╝╚══╝ ╚═╝  ╚═══╝╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚═════╝║
║                                                                          ║
║              E  N  G  I  N  E    I  N  T  E  R  N  A  L  S               ║
║                                                                          ║
╚══════════════════════════════════════════════════════════════════════════╝

The Direct Download engine is DarkCore's experimental CDN-direct acquisition system. It bypasses the Steam client entirely, downloading game content directly from Valve's content servers.

How It Works

  ┌──────────────────────────────────────────────────────────────────┐
  │                                                                  │
  │    ┌───────────┐     ┌───────────┐     ┌───────────────────┐    │
  │    │ 1. FETCH  │     │ 2. PARSE  │     │ 3. AUTHENTICATE   │    │
  │    │           │     │           │     │                   │    │
  │    │ Download  │────▶│ Extract   │────▶│ Anonymous Steam   │    │
  │    │ Morrenus  │     │ Lua +     │     │ Login via         │    │
  │    │ ZIP       │     │ Manifests │     │ steam-vent        │    │
  │    └───────────┘     └───────────┘     └─────────┬─────────┘    │
  │                                                  │              │
  │    ┌───────────────────────────────────────────────              │
  │    │                                                             │
  │    ▼                                                             │
  │    ┌───────────────────┐     ┌───────────────────┐              │
  │    │ 4. DOWNLOAD       │     │ 5. DECRYPT        │              │
  │    │                   │     │                   │              │
  │    │ Fetch chunks      │────▶│ AES-256-ECB       │              │
  │    │ from Steam CDN    │     │ Depot key from    │              │
  │    │ (Parallel I/O)    │     │ Morrenus Lua      │              │
  │    └───────────────────┘     └─────────┬─────────┘              │
  │                                        │                        │
  │                                        ▼                        │
  │                              ┌───────────────────┐              │
  │                              │ 6. FINALIZE       │              │
  │                              │                   │              │
  │                              │ • Write ACF       │              │
  │                              │ • Place Manifests │              │
  │                              │ • Inject AppList  │              │
  │                              │ • Update VDF      │              │
  │                              └───────────────────┘              │
  │                                                                  │
  └──────────────────────────────────────────────────────────────────┘

🔑 Key Technical Details

  • Chunk-Level Parallelism — Multiple depot chunks downloaded concurrently via tokio async tasks
  • AES-256-ECB Decryption — Depot keys extracted from Morrenus Lua scripts decrypt chunk payloads
  • Manifest Parsing — Custom binary parser for Steam's protobuf-based .manifest format
  • Progress Tracking — Real-time speed calculation with byte-level accuracy, displayed in the UI progress bar

🛡️ Safety Guarantees

  • Vault Integration — Downloaded manifests and Lua scripts are immediately cached in the Vault
  • Atomic Writes — File operations use temporary paths to prevent corruption on failure
  • State MachineIdle → Initializing → FetchingManifest → Downloading → Decrypting → Verifying → Finalizing → Completed
  • Error Recovery — Each stage reports to the UI terminal with full error context

Clone this wiki locally