Skip to content

Add opensteamtool manifest provider, make it default #80

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
OpenSteam001 merged 1 commit into from
May 30, 2026
Merged

Add opensteamtool manifest provider, make it default #80

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ OpenSteamTool is a Windows DLL project built with CMake.
- Unlock an unlimited number of unowned games.
- Unlock all DLCs for unowned games.
- Support auto load depot decryption keys from Lua config.
- Support auto manifest download via `steamrun` / `wudrm` upstream APIs(default is `wudrm`), or a custom Lua endpoint (see [Manifest via Lua](#manifest-via-lua)).
- Support auto manifest download via `opensteamtool` / `steamrun` / `wudrm` upstream APIs (default is `opensteamtool`), or a custom Lua endpoint (see [Manifest via Lua](#manifest-via-lua)).
- Support downloading protected games or DLCs that require an access token.
- Support binding manifest to prevent specific games from being updated.

Expand Down Expand Up @@ -81,8 +81,8 @@ If no config file is found, built-in defaults are used — no auto-creation.
level = "info"

[manifest]
# Upstream API for depot manifest request codes. Options: "steamrun", "wudrm"
url = "steamrun"
# Upstream API for depot manifest request codes. Options: "opensteamtool", "steamrun", "wudrm"
url = "opensteamtool"

# HTTP timeouts for manifest requests (milliseconds)
timeout_resolve_ms = 5000
Expand Down
7 changes: 4 additions & 3 deletions opensteamtool.example.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,9 @@ level = "info"

[manifest]
# Which upstream API to query for depot manifest request codes.
# "steamrun" → https://manifest.steam.run/api/manifest/{gid}
# "wudrm" → http://gmrc.wudrm.com/manifest/{gid}
# "opensteamtool" → https://manifest.opensteamtool.com/{gid} (default)
# "wudrm" → http://gmrc.wudrm.com/manifest/{gid} (recommended for China users)
# "steamrun" → https://manifest.steam.run/api/manifest/{gid}
# If <Steam>/config/lua/manifest.lua defines fetch_manifest_code(gid) or
# fetch_manifest_code_ex(app_id, depot_id, gid), those Lua functions take
# priority over the url setting below.
Expand Down Expand Up @@ -43,7 +44,7 @@ level = "info"
# end
# return nil
# end
url = "steamrun"
url = "opensteamtool"

# HTTP timeouts for manifest requests (milliseconds).
# timeout_resolve_ms — DNS resolution (default: 5000)
Expand Down
1 change: 1 addition & 0 deletions src/CMakeLists.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,7 @@ add_library(OpenSteamTool SHARED
Utils/VehCommon.cpp
Utils/WinHttp.cpp
Utils/FileWatcher.cpp
Utils/ManifestClient.cpp

# Per-category hook modules
Hook/HookManager.cpp
Expand Down
324 changes: 81 additions & 243 deletions src/Hook/Hooks_Manifest.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,243 +1,81 @@
#include "Hooks_Manifest.h"
#include "HookMacros.h"
#include "dllmain.h"
#include "Utils/WinHttp.h"
#include <charconv>
#include <format>
#include <mutex>

// ═══════════════════════════════════════════════════════════════════
// Manifest override hooks:
// BuildDepotDependency — patches depot entries' gid/size directly
// in the output vector (replaces the old KV-tree approach).
//
// GetManifestRequestCode — migrated to Hooks_NetPacket_Manifest
// (NetPacket layer, async HTTP via ContentServerDirectory#1).
// ═══════════════════════════════════════════════════════════════════
namespace {

// ── helper ─────────────────────────────────────────────────────

std::string DepotEntryDebug(const DepotEntry& e) {
return std::format("DepotId={} AppId={} Gid={} Size={} Dlc={} Lcs={} Carry={} Shared={}",
e.DepotId, e.AppId, e.ManifestGid, e.ManifestSize, e.DlcAppId,
(int)e.LcsRequired, (int)e.bNotNewTarget, (int)e.SharedInstall);
}

// ── BuildDepotDependency hook ──────────────────────────────────
// After Steam builds the depot list for an app, patch ManifestGid
// and ManifestSize for any depots we have overrides for.

HOOK_FUNC(BuildDepotDependency, bool, void* pUserAppMgr, AppId_t AppId,
void* pUserConfig, CUtlVector<DepotEntry>* pDepotInfo,
CUtlVector<DepotEntry>* pSharedDepotInfo, void* pSteamApp,
uint32* pBuildId, bool* pbBetaFallback)
{
bool result = oBuildDepotDependency(pUserAppMgr, AppId, pUserConfig,
pDepotInfo, pSharedDepotInfo, pSteamApp, pBuildId, pbBetaFallback);

LOG_MANIFEST_TRACE("BuildDepotDependency: AppId={} pUserConfig=0x{:X} result={} pSteamApp=0x{:X} pBuildId={} pbBetaFallback={}",
AppId, (uintptr_t)pUserConfig, result, (uintptr_t)pSteamApp,
pBuildId ? *pBuildId : 0, pbBetaFallback ? *pbBetaFallback : false);
if (pDepotInfo) {
LOG_MANIFEST_TRACE("pDepotInfo->nCount={}", pDepotInfo->m_Size);
for (uint32 i = 0; i < pDepotInfo->m_Size; ++i) {
LOG_MANIFEST_TRACE(" [{}] {}", i, DepotEntryDebug(pDepotInfo->m_Memory.m_pMemory[i]));
}
}
if (pSharedDepotInfo) {
LOG_MANIFEST_TRACE("pSharedDepotInfo->nCount={}", pSharedDepotInfo->m_Size);
for (uint32 i = 0; i < pSharedDepotInfo->m_Size; ++i) {
LOG_MANIFEST_TRACE(" shared[{}] {}", i, DepotEntryDebug(pSharedDepotInfo->m_Memory.m_pMemory[i]));
}
}

if (!result) return result;

const auto& overrides = LuaConfig::GetManifestOverrides();
if (overrides.empty()) return result;

if (pDepotInfo && pDepotInfo->m_Size) {
for (uint32 i = 0; i < pDepotInfo->m_Size; ++i) {
DepotEntry& e = pDepotInfo->m_Memory.m_pMemory[i];
auto it = overrides.find(e.DepotId);
if (it != overrides.end()) {
// if size=0 in the override, keep the original size(affects download display but not the actual download)
uint64_t newSize = it->second.size ? it->second.size : e.ManifestSize;
LOG_MANIFEST_INFO("BuildDepotDependency: patching depot {} gid={}->{} size={}->{}",
e.DepotId, e.ManifestGid, it->second.gid,
e.ManifestSize, newSize);
e.ManifestGid = it->second.gid;
e.ManifestSize = newSize;
}
}
}
return result;
}

} // anonymous namespace

// ═══════════════════════════════════════════════════════════════════
// Manifest HTTP providers (thread-safe via g_ConnectionMutex)
// ═══════════════════════════════════════════════════════════════════
namespace Hooks_Manifest {

std::mutex g_ConnectionMutex;
HINTERNET g_hSession = nullptr;
HINTERNET g_hConnect = nullptr;
bool g_tls = false;

void EnsureConnection(const wchar_t* host, INTERNET_PORT port, bool tls) {
// Already connected to the right host — reuse
if (g_hSession && g_hConnect)
return;

// Clean up stale handles
if (g_hConnect) { WinHttpCloseHandle(g_hConnect); g_hConnect = nullptr; }
if (g_hSession) { WinHttpCloseHandle(g_hSession); g_hSession = nullptr; }

g_tls = tls;
g_hSession = WinHttpOpen(L"OpenSteamTool/1.0",
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
WINHTTP_NO_PROXY_NAME, WINHTTP_NO_PROXY_BYPASS, 0);
if (!g_hSession) return;

WinHttpSetTimeouts(g_hSession,
Config::manifestTimeoutResolve,
Config::manifestTimeoutConnect,
Config::manifestTimeoutSend,
Config::manifestTimeoutRecv);

g_hConnect = WinHttpConnect(g_hSession, host, port, 0);
if (!g_hConnect) {
WinHttpCloseHandle(g_hSession);
g_hSession = nullptr;
}
}

void CloseConnection() {
if (g_hConnect) { WinHttpCloseHandle(g_hConnect); g_hConnect = nullptr; }
if (g_hSession) { WinHttpCloseHandle(g_hSession); g_hSession = nullptr; }
}

// Try ExecuteEx on the persistent connection; on failure reset
// the connection so the next call reconnects.
WinHttp::Result DoGet(const wchar_t* path, const char* urlForLog) {
auto r = WinHttp::ExecuteEx(g_hSession, g_hConnect, g_tls,
L"GET", path, nullptr, 0, nullptr,
urlForLog);
if (!r.ok)
CloseConnection();
return r;
}

// ── HTTP providers ────────────────────────────────────────────

// GET https://manifest.steam.run/api/manifest/{gid}
// Response: {"content":"1666836470726104466"}
bool FetchSteamRun(uint64_t manifest_gid, uint64_t* outRequestCode) {
EnsureConnection(L"manifest.steam.run", INTERNET_DEFAULT_HTTPS_PORT, true);
if (!g_hConnect) return false;

wchar_t path[80];
swprintf_s(path, L"/api/manifest/%llu", manifest_gid);

char urlForLog[128];
snprintf(urlForLog, sizeof(urlForLog), "https://manifest.steam.run/api/manifest/%llu", manifest_gid);

auto r = DoGet(path, urlForLog);
LOG_MANIFEST_INFO("Manifest steamrun status={} gid={}", r.status, manifest_gid);

if (!r.ok || r.status != 200) return false;

if (size_t key = r.body.find("\"content\""); key != std::string::npos) {
if (size_t q1 = r.body.find('"', key + 9); q1 != std::string::npos) {
if (size_t q2 = r.body.find('"', q1 + 1); q2 != std::string::npos) {
uint64_t code = 0;
auto [_, ec] = std::from_chars(
r.body.data() + q1 + 1, r.body.data() + q2, code);
if (ec == std::errc{}) {
*outRequestCode = code;
return true;
}
}
}
}
return false;
}

// ── provider: gmrc.wudrm.com ───────────────────────────────────
// GET http://gmrc.wudrm.com/manifest/{gid}
// Response: plain-text uint64_t, e.g. "10570517747114638659"
bool FetchWudrm(uint64_t manifest_gid, uint64_t* outRequestCode) {
EnsureConnection(L"gmrc.wudrm.com", INTERNET_DEFAULT_HTTP_PORT, false);
if (!g_hConnect) return false;

wchar_t path[80];
swprintf_s(path, L"/manifest/%llu", manifest_gid);

char urlForLog[128];
snprintf(urlForLog, sizeof(urlForLog), "http://gmrc.wudrm.com/manifest/%llu", manifest_gid);

auto r = DoGet(path, urlForLog);
LOG_MANIFEST_INFO("Manifest wudrm status={} gid={}", r.status, manifest_gid);

if (!r.ok || r.status != 200) return false;

uint64_t code = 0;
auto [_, ec] = std::from_chars(r.body.data(), r.body.data() + r.body.size(), code);
if (ec == std::errc{}) {
*outRequestCode = code;
return true;
}
return false;
}

// ── resolve (single-provider, no fallback) ────────────────────
bool FetchManifestRequestCode(uint64_t manifestGid, uint64_t* outRequestCode, AppId_t AppId, AppId_t DepotId) {
std::lock_guard<std::mutex> lock(g_ConnectionMutex);

// Try extended Lua function first (receives app_id, depot_id, gid)
if (AppId && DepotId && LuaConfig::HasManifestCodeFuncEx()) {
if (LuaConfig::CallManifestFetchCodeEx(AppId, DepotId, manifestGid, outRequestCode)) {
LOG_MANIFEST_INFO("Manifest gid={} resolved via fetch_manifest_code_ex", manifestGid);
return true;
}
LOG_MANIFEST_WARN("Manifest gid={} fetch_manifest_code_ex returned nil, trying fetch_manifest_code", manifestGid);
}

// Fall back to original Lua function (receives gid only)
if (LuaConfig::HasManifestCodeFunc()) {
if (LuaConfig::CallManifestFetchCode(manifestGid, outRequestCode)) {
LOG_MANIFEST_INFO("Manifest gid={} resolved via manifest.lua", manifestGid);
return true;
}
LOG_MANIFEST_WARN("Manifest gid={} lua returned nil, falling back to config", manifestGid);
}

switch (Config::manifestUrl) {
case Config::ManifestUrl::Wudrm:
return FetchWudrm(manifestGid, outRequestCode);
case Config::ManifestUrl::SteamRun:
default:
return FetchSteamRun(manifestGid, outRequestCode);
}
}

// ═══════════════════════════════════════════════════════════════
// Install / Uninstall
// ═══════════════════════════════════════════════════════════════

void Install() {
HOOK_BEGIN();
INSTALL_HOOK_C(BuildDepotDependency);
HOOK_END();
}

void Uninstall() {
UNHOOK_BEGIN();
UNINSTALL_HOOK(BuildDepotDependency);
UNHOOK_END();
CloseConnection();
}
}
#include "Hooks_Manifest.h"
#include "HookMacros.h"
#include "dllmain.h"
#include <format>

// ═══════════════════════════════════════════════════════════════════
// Manifest override hooks:
// BuildDepotDependency — patches depot entries' gid/size directly
// in the output vector (replaces the old KV-tree approach).
// ═══════════════════════════════════════════════════════════════════
namespace {

std::string DepotEntryDebug(const DepotEntry& e) {
return std::format("DepotId={} AppId={} Gid={} Size={} Dlc={} Lcs={} Carry={} Shared={}",
e.DepotId, e.AppId, e.ManifestGid, e.ManifestSize, e.DlcAppId,
(int)e.LcsRequired, (int)e.bNotNewTarget, (int)e.SharedInstall);
}

HOOK_FUNC(BuildDepotDependency, bool, void* pUserAppMgr, AppId_t AppId,
void* pUserConfig, CUtlVector<DepotEntry>* pDepotInfo,
CUtlVector<DepotEntry>* pSharedDepotInfo, void* pSteamApp,
uint32* pBuildId, bool* pbBetaFallback)
{
bool result = oBuildDepotDependency(pUserAppMgr, AppId, pUserConfig,
pDepotInfo, pSharedDepotInfo, pSteamApp, pBuildId, pbBetaFallback);

LOG_MANIFEST_TRACE("BuildDepotDependency: AppId={} pUserConfig=0x{:X} result={} pSteamApp=0x{:X} pBuildId={} pbBetaFallback={}",
AppId, (uintptr_t)pUserConfig, result, (uintptr_t)pSteamApp,
pBuildId ? *pBuildId : 0, pbBetaFallback ? *pbBetaFallback : false);
if (pDepotInfo) {
LOG_MANIFEST_TRACE("pDepotInfo->nCount={}", pDepotInfo->m_Size);
for (uint32 i = 0; i < pDepotInfo->m_Size; ++i) {
LOG_MANIFEST_TRACE(" [{}] {}", i, DepotEntryDebug(pDepotInfo->m_Memory.m_pMemory[i]));
}
}
if (pSharedDepotInfo) {
LOG_MANIFEST_TRACE("pSharedDepotInfo->nCount={}", pSharedDepotInfo->m_Size);
for (uint32 i = 0; i < pSharedDepotInfo->m_Size; ++i) {
LOG_MANIFEST_TRACE(" shared[{}] {}", i, DepotEntryDebug(pSharedDepotInfo->m_Memory.m_pMemory[i]));
}
}

if (!result) return result;

const auto& overrides = LuaConfig::GetManifestOverrides();
if (overrides.empty()) return result;

if (pDepotInfo && pDepotInfo->m_Size) {
for (uint32 i = 0; i < pDepotInfo->m_Size; ++i) {
DepotEntry& e = pDepotInfo->m_Memory.m_pMemory[i];
auto it = overrides.find(e.DepotId);
if (it != overrides.end()) {
// if size=0 in the override, keep the original size(affects download display but not the actual download)
uint64_t newSize = it->second.size ? it->second.size : e.ManifestSize;
LOG_MANIFEST_INFO("BuildDepotDependency: patching depot {} gid={}->{} size={}->{}",
e.DepotId, e.ManifestGid, it->second.gid,
e.ManifestSize, newSize);
e.ManifestGid = it->second.gid;
e.ManifestSize = newSize;
}
}
}
return result;
}

} // anonymous namespace

namespace Hooks_Manifest {

void Install() {
HOOK_BEGIN();
INSTALL_HOOK_C(BuildDepotDependency);
HOOK_END();
}

void Uninstall() {
UNHOOK_BEGIN();
UNINSTALL_HOOK(BuildDepotDependency);
UNHOOK_END();
}
}
20 changes: 6 additions & 14 deletions src/Hook/Hooks_Manifest.h
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,6 @@
#pragma once
#include "Steam/Types.h"

namespace Hooks_Manifest {
void Install();
void Uninstall();

// Fetch a manifest request code from online providers.
// Thread-safe — serialises access to the underlying WinHTTP connection.
// Returns true and sets *outRequestCode on success.
// AppId and DepotId are optional; when provided, enables fetch_manifest_code_ex.
bool FetchManifestRequestCode(uint64_t manifestGid, uint64_t* outRequestCode,
AppId_t AppId = 0, AppId_t DepotId = 0);
}
#pragma once

namespace Hooks_Manifest {
void Install();
void Uninstall();
}
Loading
Loading