Skip to content

High-performance orchestration tool for Steam compatibility layers. Rust-native, memory-safe, and designed for advanced local library management & VDF virtualization.

License

Notifications You must be signed in to change notification settings

hkmodd/DarkCore-Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DarkCore Logo

██████╗  █████╗ ██████╗ ██╗  ██╗ ██████╗ ██████╗ ██████╗ ███████╗
██╔══██╗██╔══██╗██╔══██╗██║ ██╔╝██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║  ██║███████║██████╔╝█████╔╝ ██║     ██║   ██║██████╔╝█████╗  
██║  ██║██╔══██║██╔══██╗██╔═██╗ ██║     ██║   ██║██╔══██╗██╔══╝  
██████╔╝██║  ██║██║  ██║██║  ██╗╚██████╗╚██████╔╝██║  ██║███████╗
╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝
  

Advanced System Orchestration & Compatibility Layer

High-Performance. Memory-Safe. Aesthetics.

🌌 DarkCore Manager v1.5

The Rust-Native Orchestrator for External Compatibility Layers. Zero Dependency. Zero Bloat. Pure Power.

Version Status License

Rust Windows



Note

RESEARCH & INTEROPERABILITY DISCLAIMER

  1. Educational Sandbox: DarkCore Manager is a technical demonstration of Rust UI patterns, IPC (Inter-Process Communication), and local file system management.
  2. External Dependencies: This tool acts solely as a Launcher/Manager for third-party tools (GreenLuma, Steamless, etc.). It does not contain, distribute, or modify their binaries.
  3. No Proprietary Data: This repository does NOT host any copyrighted game binaries or proprietary code. It operates strictly by managing local configuration text files (e.g., AppList/*.txt).
  4. User Agency: The user retains full control over their local environment. The author assumes NO LIABILITY for the usage of this tool or the behavior of third-party dependencies managed by it.

🚀 System Overview

DarkCore Manager redefines the local library management experience. Abandoning legacy script-based approaches, it introduces a Rust-native architecture designed for speed, safety, and visual immersion.

Acting as a sophisticated Middleware Orchestrator, it automates the complex interplay between the Client environment, external compatibility layers, and local configuration files, wrapping it all in a "God-Tier" interface.

🧠 Architecture: Under the Hood

  • Deterministic Configuration: Dynamically builds and sorts the AppList directory structure, ensuring precise loading orders for external injectors.
  • Search & Indexing: Powered by external Metadata APIs, enabling rapid retrieval of AppID information for local configuration.
  • Depot Management: Parses Lua scripts to structurally align key-values into config.vdf and manages depotcache manifest placement for correct client recognition.
  • Profile Virtualization: Overcomes legacy limitations by implementing a hot-swappable Profile System for AppList configurations.
  • Process Supervision: Manages the lifecycle of child processes via native Win32 calls, ensuring clean startup and termination sequences.

It doesn't just run commands. It governs the environment.

🗝️ System Attributes: Core Modules

To achieve seamless interoperability, four components must work in unison. DarkCore orchestrates them all:

1. 🔓 Binary Preprocessor (Wrapper for Steamless)

  • Role: Automated File Preparation.
  • Function: Interfacing with the Steamless CLI to prepare executables for offline or sandboxed execution, ensuring compatibility with custom environments.
  • DarkCore Integration: Fully automated workflow. Handles .bak creation, processing, and file restoration with 100% safety checks.

2. 🔑 Parameter Injection (Wrapper for GreenLuma)

  • Role: Environment Variable Management.
  • Function: Orchestrates the injection of specific AppIDs into the client's runtime context, leveraging legitimate "Family Sharing" protocols for extended library management.
  • DarkCore Integration: Feeds the AppList configuration dynamically based on the active user profile.

3. 📡 Metadata Aggregation (Morrenus Integration)

  • Role: Manifest & Config Synchronization.
  • Function: Facilitates the retrieval of public Manifests and configuration scripts necessary for client validation.
  • DarkCore Integration: Automates the alignment of Lua scripts and Manifests to ensure config.vdf and depotcache consistency.

4. 🧠 TITAN Module - NEW!

  • Role: Local API Proxy & State Virtualization.
  • Function: A custom dll layer that intercepts ISteamRemoteStorage and ISteamUserStats calls to virtualize them locally.
  • Capabilities:
    • 💾 Local Storage Sandbox: Redirects save game I/O to a user-controlled local directory, decoupling it from cloud dependencies.
    • ☁️ State Harmonization: Manages localconfig.vdf and remotecache.vdf to ensure the Client UI reflects a consistent state, resolving synchronization conflicts.
    • 🏆 Offline Statistics: Persists unlocked statistics to a local database (stats.txt), preserving user progress in offline/sandboxed scenarios.

✨ Feature Matrix

🟢 Hybrid Operation Mode

DarkCore adapts to your environment in real-time.

Mode Status Functionality
Authenticated FULL ACCESS Complete API integration. Precise AppID resolution. Manifest/Lua synchronization enabled.
Standard LOCAL ONLY Fallback to Public Store API. Instant Search & DLC listings. Ideal for local Family Sharing management.

Note

BYOL (Bring Your Own License): GreenLuma, Steamless, and API Keys are third-party resources. You must acquire and configure them independently.

🛡️ Integrity Validation

When a valid API connection is established, DarkCore enforces Strict Validation, preventing the configuration of invalid AppIDs. If the metadata doesn't exist, the configuration is rejected to maintain system stability.

⚡ Technical Highlights

  • Rust Native: Compiled to machine code. Zero interpreter overhead. Only 18.5MB standalone binary.
  • Project Neon UI: Rebuilt with a "Glass & Glow" design language. Features fixed Sidebar navigation, adaptive layouts, and fade animations.
  • Smart Discovery: Algorithms scan library folders to auto-fill installation paths, minimizing manual configuration.
  • Audio-Reactive: Custom "Neon Wave" volume control with real-time spectrum visualization.
  • Secure Input: API Key fields feature a "Glitch" security visualization.
  • Zero-Compromise Engineering: The entire codebase (Manager + Titan) compiles with 0 Warnings, adhering to strict Rust 2024 standards.
  • Native Process Injection: Utilizes advanced QueueUserAPC calls for stable, thread-safe module loading. This ensures seamless integration without the instability of legacy injection methods.
  • Profile Swapping: Proprietary system allows for unlimited library configurations by hot-swapping AppList files.

🛠️ Compilation Source

We believe in transparency. Build it yourself.

Prerequisites

Build Sequence

  1. Clone Repository

    git clone [https://github.com/hkmodd/DarkCore-Manager.git](https://github.com/hkmodd/DarkCore-Manager.git)
    cd DarkCore-Manager
  2. Asset Injection (Optional)

    • Logo: Automatically embedded (baked-in) at compile time.
    • Icon: Place your icon.ico in the manager/ directory.
  3. Compile System

    cargo build --release

    This command compiles the entire workspace:

    • Manager: target/release/darkcore-manager.exe (The UI Application)
    • Titan Hook: target/release/titan_hook.dll (The Compatibility Layer)

    [!TIP] Ensure both files are in the same directory for deployment to work correctly.


⚙️ Operational Protocol

1. Environment Mapping (Initialization)

Upon first boot, the core system requires mapping to your local ecosystem. Navigate to the SETTINGS tab to initialize the environment:

  • Steam Root: The directory housing the client executable.
  • Compatibility Artifact: The folder containing the GreenLuma binary (GreenLuma_2025_x64.dll).
  • Preprocessor Binary: Path to Steamless.CLI.exe.
  • API Key: (Optional) Input your private API key for metadata retrieval.

2. The Execution Cycle

DarkCore streamlines the deployment process into a deterministic linear workflow:

  1. Query: Navigate to SEARCH, input a specific AppID or Game Name.
  2. Engage: Click INSTALL for metadata integration, Right-click for basic AppID listing.
  3. Titan Activation (Post-Install): If you require local save management, return to DarkCore Library section and click ACTIVATE TITAN.
    • Automation: The system automatically manages the client process, deploys the Titan Hook, patches the local configuration, and restarts the environment.

Tip

Process Hygiene: DarkCore handles process termination during critical operations (Injection & Titan Deployment) to prevent file locking.



"Wake up, Samurai. We have a compiled language to burn."

About

High-performance orchestration tool for Steam compatibility layers. Rust-native, memory-safe, and designed for advanced local library management & VDF virtualization.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published