Nexus moved its Xodus changes from patch files in xodus-nexus into a backend fork (domsvoboda/nexus-backend, GPL-3.0). prepare.py now fetches that fork at backend-v0.2.15 (e7884a27, same Xodus base 53ea781d, same Rust 1.99.0) and applies the DroidDeck patches, rebased onto it: - droiddeck-credentials, -launch-view, -library-subscriptions: same rebase as Bannerlator's 0.2.15 update (identical patches before and after). - droiddeck-credential-fallback, -credential-diagnostics: applied unchanged. - droiddeck-cloud-token: session::prepare now also returns the account snapshot; the ticket checks it like upstream's profile/social commands. - droiddeck-licensing-device-ticket: upstream 0.2.15 already formats delegation-compact device tickets for Store license tokens (27c335e), so only the content licensing path is patched. Upstream now writes compact JWE delegation tickets as t=, so the d= prefix check is replaced by the token type, the same rule as upstream's store_license.rs. droiddeck-xbox-ticket.patch is dropped: upstream sends compact JWE delegation tickets to Xbox Live sign-in in a form it accepts, with tests. Runtime: domsvoboda/nexus-runtime runtime-11.0-20261102-g76c6dd13 (was xodus-nexus runtime-11.0-20261018). Same six modules at the same path; xgameruntime.dll is the C++ implementation (nexus-xgameruntime 455b1ba9). Archive sha512 from the release's .sha512sum, source sha256 from its candidate.json, module sha256 from the extracted files. The PlayFab Game Saves proxy is a newer build at the same path and still passes droiddeck-xbox's export checks; its license moved to share/doc/nexus-runtime/. DLC mounting: the C++ runtime mounts downloadable content only inside a host-managed workspace named by XODUS_MOUNT_ROOT (src/System/Package/Mount.h returns E_NOTIMPL without it). DroidDeck starts Wine itself (droiddeck:prepare), so droiddeck-dlc-mount.patch (ported from Bannerlator) creates the workspace in the launch directory for the prepare session and reports it as mountRoot; XboxRuntime passes it in the xbox-prepare reply and droiddeck-xbox sets XODUS_MOUNT_ROOT to its Z: path. XODUS_CONTENT_ROOTS is unchanged and still read by the runtime. Upstream fixes since the old pins include sign-in for some accounts, offline play, cloud-save conflict handling, DLC mounting, duplicate token requests and per-game fixes (Ori, AoE, MSFS, Forza Motorsport).
8.5 KiB
Xbox backend for DroidDeck
DroidDeck uses the Nexus backend protocol with a native Linux AArch64 CLI and
service. It does not install the Nexus desktop launcher or x86 Linux Wine.
backend.lock.json pins the Nexus backend (domsvoboda/nexus-backend, a fork of
Xodus that carries Nexus's changes as commits), its Xodus base, Rust and the
Cargo.lock checksum. runtime.lock.json pins the Nexus Windows runtime release
(domsvoboda/nexus-runtime) and each extracted PE DLL. prepare.py verifies the
source revision and Cargo.lock before applying the local transport, launch and
library patches.
droiddeck-cloud-token.patch adds xodus-cli cloud-token: the stored account's
Xbox Cloud Gaming sign-in (XSTS for http://gssv.xboxlive.com/, then the streaming
service's /v2/login/user) and the login proof token a session's /connect step
takes. It prints one JSON object and never opens a login or provisions a device.
Ported from Bannerlator.
droiddeck-library-subscriptions.patch queries fresh subscription membership
alongside product entitlements using the same Store session, account and market.
Android can validate a Game Pass child's parent plan when that plan is absent
from the product response. A failed membership query fails the refresh and
preserves the previous library. Empty membership results add no plan evidence;
valid plans already present in the product response retain their existing checks.
Build on AArch64 Ubuntu 24.04 with Rust from the lock, a C/C++ compiler, OpenSSL development headers, pkg-config, protoc, CMake, Git, Python 3 and xz:
bash tools/xbox/build.sh
On macOS, bash tools/xbox/build-local.sh uses an AArch64 Ubuntu container.
tools/build_local.sh includes this step and caches it by recipe inputs. CI
builds the same recipe on ubuntu-24.04-arm and transfers the result to the APK
job. Cache hits still download that build's Xbox artifact before APK assembly.
The build runs account-free CLI, credential and streaming tests. It retains the
patched backend source archive and the checksum-verified runtime source archive
in the build cache and publishes both in CI's xbox-corresponding-source
artifact; distribute corresponding sources with published binaries.
droiddeck-credential-fallback.patch names the reason when the backend cannot reach the
app's credential socket (NEXUS_CREDENTIAL_ERROR_V1 socket-refused, -denied, ...) and then
uses a keyed loopback port the app also listens on; some devices refuse the abstract socket
from inside PRoot. The key is passed in the backend's environment only.
droiddeck-licensing-device-ticket.patch sends a delegation-compact device ticket to content
licensing in the licensing wire form (t= or a bare compact JWE), as user tickets already are;
a plain compact device ticket is sent unchanged. Store license tokens already do this in
nexus-backend 0.2.15 (@domsvoboda's commit 27c335e); the
content licensing path does not yet (xodus-gaming/xodus#238).
droiddeck-dlc-mount.patch: the C++ XGameRuntime mounts downloadable content only inside a
host-owned workspace named by XODUS_MOUNT_ROOT. DroidDeck starts Wine itself, so the
droiddeck:prepare session creates that workspace in its launch directory, reports it as
mountRoot, and removes it when the session ends; droiddeck-xbox passes it to the game.
droiddeck-credential-diagnostics.patch names the step behind a credential-io failure: the
session lock (lock-dir-owner, lock-file-mode, lock-flock-<reason>, ...), a socket or loopback
exchange that broke after connecting (socket-exchange-<reason>), a malformed host reply, or a
missing socket name, port or key. Errno values without a name are spelled with letters, a = 0 ... j = 9.
droiddeck-credentials.patch replaces Linux Secret Service with a bounded,
Android abstract socket restricted to the backend process started by the host. The Android host encrypts every persistent
write using its existing Keystore cipher, verifies backend read-backs, and
rejects writes when Keystore is unavailable. No token values enter process
arguments, external storage, application logs or a plaintext credential file.
Account-generation invalidation prevents a signed-out child's later writes from
restoring credentials. Each backend gets its own socket. The host checks the peer UID, the PRoot tracer
owned by its live child, and an executable mapping of the backend file with a matching inode and
SHA-256 against the APK asset. PRoot's loader can occupy /proc/<pid>/exe, so
authentication checks the mapped backend image instead. A socket name alone grants no credential operations, including to another
copy of Xodus started by the guest.
Licensed launch-view preparation runs in an Android-owned Xodus child, which never starts Wine or a game. Steam and DroidDeck launch paths can request preparation for an installed Xbox title during a live session with an Xbox account. The reply contains a random launch lease, a materialized executable path, a game-service socket and the existing PlayFab game token; it contains no account credential endpoint. Leases bind product, account and session, expire without heartbeats, and release idempotently. Cancellation, session stop and account changes revoke leases; closing the child's stdin lets it remove its private view. Suspension preserves live leases. The Proton initialization and game processes do not inherit the raw credential channel or command-file environment variables. The authenticated GDK bridge remains available to the game. Like the other stores, games share DroidDeck's Linux environment and Android UID. The process checks close the direct credential-socket route; they do not isolate writable runtime files, prevent same-UID process tampering, or provide a sandbox against malicious games.
Microsoft sign-in uses Nexus's private stdio protocol in an isolated Android WebView process. Its page bridge is restricted to the allowed Microsoft/Xbox HTTPS origins and the main frame; it has no credential-store or launcher API. Cookies and page storage are cleared for each attempt. This protocol requires an embedded host for CloudExperienceHost messages; opening its URL in an ordinary Android browser does not complete it. Passkey behavior needs device testing.
droiddeck-launch-view.patch materializes all licensed encrypted images,
including DLLs, in a private temporary directory. Original package files remain
encrypted, and the temporary view is removed after the Wine child exits. Wine
receives normal files with no Xodus FD-map requirement. This costs temporary
storage proportional to the encrypted images. The app keeps the account service
alive for the session; an authenticated loopback bridge carries GDK requests.
Wine's builtin PE marker makes WINEDLLOVERRIDES=n reject the Nexus modules.
The extractor verifies their original hashes, then changes only that 16-byte DOS
stub marker to DroidDeck native; code, imports and exports stay unchanged. This
lets ARM64EC Wine load the AMD64 modules through its normal native DLL path.
Only each Xbox game's prefix receives these Windows modules. Existing
Steam games and other store prefixes retain their selected runtimes.
Cloud saves and in-game identity use the reused XGameRuntime/service interfaces; those are game-dependent. Entitlements distinguish purchases from Game Pass access, and the backend performs a fresh license check for downloads and launch. The store lists PC MSIXVC games only. It does not emulate Xbox consoles or add support for UWP/APPX packages. Update / verify refreshes an installed package through the normal licensed streaming path. Manage content resolves manifest-related licensed PC DLC into separate content roots and checks its parent identity after download. These flows still require game/account validation; runtime API presence does not establish that they work on Thor.
Upstream contribution restrictions are respected: these are launcher, storage, build and file-lifecycle adapters in DroidDeck, not submitted reverse-engineering contributions to Xodus.
Sources and licenses:
- Nexus backend: https://github.com/domsvoboda/nexus-backend, a fork of Xodus
https://github.com/xodus-gaming/xodus (GPL-3.0,
LICENSE.xodus). - Nexus launcher and runtime compatibility files: https://github.com/domsvoboda/nexus-launcher
(formerly xodus-nexus; MIT,
LICENSE.nexus,LICENSE.runtime-compat). - XGameRuntime/Wine modules: the exact source archive is identified in
runtime.lock.json(LGPL-2.1,LICENSE.LGPL-2.1). libnghttp2.dll: nghttp2, MIT; its license is retained in the runtime source archive and is packaged asLICENSE.nghttp2.