Skip to content

Manager Flow

Sebastiano Gelmetti edited this page Feb 19, 2026 · 1 revision

╔══════════════════════════════════════════════════════════════════╗
║                                                                  ║
║        ██╗███╗░░██╗░██████╗████████╗░█████╗░██╗░░░░░██╗░░░░░    ║
║        ██║████╗░██║██╔════╝╚══██╔══╝██╔══██╗██║░░░░░██║░░░░░    ║
║        ██║██╔██╗██║╚█████╗░░░░██║░░░███████║██║░░░░░██║░░░░░    ║
║        ██║██║╚████║░╚═══██╗░░░██║░░░██╔══██║██║░░░░░██║░░░░░    ║
║        ██║██║░╚███║██████╔╝░░░██║░░░██║░░██║███████╗███████╗    ║
║        ╚═╝╚═╝░░╚══╝╚═════╝░░░░╚═╝░░░╚═╝░░╚═╝╚══════╝╚══════╝    ║
║                                                                  ║
║             F  L  O  W  S    &    P  R  O  T  O  C  O  L  S     ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

🎮 The Installation Pipeline

DarkCore's installation system is a multi-stage pipeline that adapts to user intent. Every path converges through a unified decision tree, ensuring consistency regardless of the entry point.

  ╔═══════════════════════════════════════════════════════════════════════╗
  ║                                                                       ║
  ║                    ┌──────────────┐    ┌──────────────┐               ║
  ║                    │  🔍 SEARCH   │    │  📂 IMPORT   │               ║
  ║                    │   Catalog    │    │   ZIP File   │               ║
  ║                    └──────┬───────┘    └──────┬───────┘               ║
  ║                           │                   │                       ║
  ║                           ▼                   ▼                       ║
  ║                    ┌──────────────────────────────────┐               ║
  ║                    │      📦 THE MANIFESTOR           │               ║
  ║                    │                                  │               ║
  ║                    │  • Fetch Game Hierarchy (API)    │               ║
  ║                    │  • Display Base Game + All DLCs  │               ║
  ║                    │  • Smart Slot Counter (130 max)  │               ║
  ║                    │  • Select / Deselect / Filter    │               ║
  ║                    │                                  │               ║
  ║                    │  ┌────────────────────────────┐  │               ║
  ║                    │  │  🔄 Morrenus Failover:     │  │               ║
  ║                    │  │  Vault Cache → API → Lua   │  │               ║
  ║                    │  │  (Token-Saving Protocol)   │  │               ║
  ║                    │  └────────────────────────────┘  │               ║
  ║                    └──────────────┬───────────────────┘               ║
  ║                                   │                                   ║
  ║                                   ▼                                   ║
  ║                    ┌──────────────────────────────────┐               ║
  ║                    │  🎮 FAMILY SHARED or ⬇ DOWNLOAD? │               ║
  ║                    └───────┬──────────────────┬───────┘               ║
  ║                            │                  │                       ║
  ║                    ┌───────▼───────┐  ┌───────▼────────┐             ║
  ║                    │  👨‍👩‍👧 FAMILY   │  │  💾 LIBRARY     │             ║
  ║                    │   SHARED      │  │   SELECTION     │             ║
  ║                    │               │  │                 │             ║
  ║                    │ Write AppList │  │ Select Drive +  │             ║
  ║                    │ (Base + DLCs) │  │ Install Folder  │             ║
  ║                    │ No Downloads  │  │ Smart Auto-Fill │             ║
  ║                    │ No API Calls  │  │ Scan Existing   │             ║
  ║                    │               │  └────────┬────────┘             ║
  ║                    │   ✅ DONE     │           │                      ║
  ║                    └───────────────┘           ▼                      ║
  ║                                    ┌───────────────────────┐         ║
  ║                                    │  ☁️ STEAM  or  ⚡ DIRECT │         ║
  ║                                    └─────┬───────────┬─────┘         ║
  ║                                          │           │               ║
  ║                                  ┌───────▼──┐  ┌─────▼────────┐     ║
  ║                                  │ Steam    │  │ Direct       │     ║
  ║                                  │ Protocol │  │ Download     │     ║
  ║                                  │          │  │              │     ║
  ║                                  │ • Inject │  │ • Parse Lua  │     ║
  ║                                  │ • ACF    │  │ • Auth Anon  │     ║
  ║                                  │ • Launch │  │ • Fetch CDN  │     ║
  ║                                  │ • WUDRM  │  │ • Decrypt    │     ║
  ║                                  └──────────┘  └──────────────┘     ║
  ║                                                                       ║
  ╚═══════════════════════════════════════════════════════════════════════╝

🧊 The Vault — Intelligent Caching Layer

The Vault is DarkCore's built-in token-saving caching system. Every API interaction passes through the Vault first, dramatically reducing external calls and enabling offline operation for previously configured games.

                        ┌────────────────────┐
                        │  📡 API Request    │
                        └─────────┬──────────┘
                                  │
                                  ▼
                     ╔════════════════════════╗
                     ║    🧊 VAULT CHECK     ║
                     ║                        ║
                     ║  Vault/{AppID}/        ║
                     ║  ├── {AppID}.lua       ║
                     ║  ├── {Depot}_{GID}     ║
                     ║  │   .manifest         ║
                     ║  └── {AppID}.zip       ║
                     ╚════════╤═══════════════╝
                              │
                    ┌─────────┴─────────┐
                    │                   │
               HIT  ▼              MISS ▼
          ┌──────────────┐    ┌──────────────┐
          │ ✅ Use Local │    │ 📡 Download  │
          │  (0 Tokens)  │    │  from API    │
          └──────────────┘    └──────┬───────┘
                                     │
                                     ▼
                              ┌──────────────┐
                              │ 💾 Save to   │
                              │    Vault     │
                              │ (Extracted)  │
                              └──────────────┘

The Vault also powers manifest version verification — comparing local {depot_id}_{gid}.manifest filenames against expected GIDs from the API, enabling automatic detection of outdated content.


Clone this wiki locally