Running the Xbox Series X|S library on PC. A continuation of drycheetah84/TomBox.
The runtime reimplements the console's platform layer (Xbox-flavoured Direct3D 12, precompiled RDNA2 shaders, unified-memory textures, system libraries) so dumped, already-decrypted Xbox Series X|S builds run as normal Windows processes. It is not tied to any single title. This repo tracks our continuation — new titles brought up, platform calls extended, shader stages unlocked.
Uses legally obtained, already-decrypted dumps. The runtime does no key extraction or package decryption.
Source code: the emulator's Rust workspace is in this repo: crates/, tools/ and Cargo.toml. It contains no game files, binaries or build output.
Contributing: pull requests are welcome, especially console library functions still marked missing in the library map. See CONTRIBUTING.md. Licensed GPL-3.0-or-later (see LICENSE). Releases before this change remain available under MIT OR Apache-2.0.
One square per item. The first four sections use upstream's definitions so the numbers stay comparable: green = done, amber = partial (a stub, a forwarder, or not verified to work), grey = not done — imported system functions of the Fortnite EXE, Direct3D 12.x interface methods, RDNA2 shader instructions the decoder knows, and the eight shader stages (mesh and amplification still grey). The fifth section is ours and covers Xbox console libraries only: the exports of the console OS DLLs (EmbeddedXvd of every analysed title, union, so the newest console OS sets the surface) that no same-named DLL in a PC's C:\Windows\System32 exports, so console-only DLLs (d3d12_xs, xg_xs, xmem, AcpHal, chad, xapu, xcrdapi, the *legacy variants, ...) count in full and modified PC DLLs (kernel32, advapi32, mfplat, ...) only for their console-only exports, plus the GDK wrappers the emulator redirects; plain Windows DLLs (ntdll, msvcrt, ucrtbase, combase, ...) are not shown. Coloured implemented / forwarded / stub / missing; lighter squares are functions an analysed title imports. Per-title import coverage likewise counts only imports from console libraries. Generated by tools/progress/gen.py; per-function tables in docs/LIBRARY_MAP.md, headline numbers in tools/progress/summary.json.
Counted live by tools/progress/gen.py; full table with evidence in docs/MILESTONES.md.
| Milestone | State |
|---|---|
| All imported system functions covered (671/671) | done |
| Full title shader sweep translated (105,506/105,506) | done |
| All Direct3D 12.x methods covered | in progress (map) |
| All RDNA2 instructions verified | in progress (map) |
| All shader stages (Mesh, Amplification) | in progress (map) |
| All Xbox console libraries covered | in progress (map) |
| Fortnite boots, first frames, login, hotfix, mode select, BR lobby | done (7 run milestones) |
| 3D scene correct | not reached |
| Keyboard / controller input | not reached |
| Audio | not reached |
| Gameplay | not reached |
| A second title running | not reached |
| Title | Build | Result |
|---|---|---|
| Fortnite (Chapter 2 Season 4) | 2.0.1461.7919 | Boots, logs in to a private server, reaches the lobby. 2D interface correct. 3D scene lit but the character material is wrong and bloom shows artifacts. No audio. Not playable. On this machine (2026-11-21): boots, first frames, window on the primary monitor, login complete, hotfix success, game-mode select, Battle Royale lobby (UI.State.Athena.Frontend). |
| XDefiant | dump examined | Not run. Imports and console OS (10.0.22000) mapped in docs/LIBRARY_MAP.md; new modules include XCurl, Bink2Scarlett, chad (XDsp*), xapu (XApu*). |
| Grand Theft Auto VI | 1.0.2.1 | Not run (dump has no executable). Shader package examined: 26,503 shaders, plain compressed Xbox shader containers. Of a 4,000-shader sample all disassemble cleanly; ~⅓ of vertex shaders translate. Blockers: mesh shaders, shaders without root signatures. |
- docs/DEVELOPMENT_LOG.md — chronological log
- docs/BLOCKERS.md — standing walls
- docs/LIBRARY_MAP.md — per-library, per-function status (generated)
- docs/LIBRARY_DISCOVERY.md — what the dumps contain
Upstream: drycheetah84/TomBox (base commit 7e8064f). The map and badges here are generated in this repo by tools/progress/gen.py, which keeps upstream's metric definitions and style for the first four sections.