Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

ivall/xcl

Games

Run Xbox Series X|S game files natively on Windows without CPU emulation, for technical users experimenting with console compatibility.

147
10
Rust
GPL-2.0
1 day old

What it is

XCL is an experimental compatibility layer that runs Xbox Series X|S GDK game files on a Windows PC without CPU emulation. The game's x64 code executes natively while XCL substitutes for console-only libraries such as kernelx.dll, XGameRuntime and d3d12_xs.dll, roughly in the Wine/Proton model. Console GPU code originally compiled for RDNA2 is recompiled to HLSL and then to DXIL for the PC GPU. Game-related code is organized around running unpacked files the user owns ivall/xcl.

Current state

The project describes its foundation as tested against data from a retail game. Its shader recompiler translated all 24,064 RDNA2 programs in the sample shader pack, the game's own console DLLs run for Bink 2 video, ray-tracing BVH building and AMD FSR 4 setup, and 909 of 912 textures in the sample archive decoded byte-for-byte. There are 150 automated tests. What remains before a title produces its first frame is the D3D12.X draw submission and present path, which the authors say requires a game executable to work out. The README's status table marks graphics submission as the main gap. The technical next steps and measurements are in HANDOFF.md, with the design in the design spec.

Build and run

You need Windows 10/11 x64, the Rust stable-x86_64-pc-windows-msvc toolchain, the Windows SDK with DXC (dxcompiler.dll and dxil.dll), a D3D12 GPU with Shader Model 6.6, and the system xgameruntime.dll that ships with Windows/Gaming Services. Development and testing were done on AMD RDNA4; other GPUs are untested.

cargo build --release --workspace          # produces target\release\xcl.exe

xcl inspect D:\Game\game.exe               # show imports and XCL's handling
xcl run D:\Game [-- game arguments]        # attempt to run unpacked game files
xcl disasm <shader.bin> [--hex]            # RDNA2 disassembler
xcl shaders D:\data\shaders.rpf --top 50   # shader pack statistics
xcl rpf D:\data\shaders.rpf --extract NAME --out folder

Each run writes logs\report.json under %LOCALAPPDATA%\XCL\<title>\, recording called stubs, unknown D3D12.X slots, runtime classes, shader statistics and crashes; this is intended as the to-do list for the next step. To run the test suite, use scripts\test.ps1. Tests against real game data are opt-in through environment variables such as XCL_SAMPLE_RPF, XCL_SAMPLE_DLLS, XCL_SAMPLE_TTPF, XCL_SAMPLE_BK2, XCL_SAMPLE_BVH4 and XCL_SAMPLE_AWC pointing at files you own; without them, those tests are skipped.

Constraints

XCL works only on unpacked game files you own. It does not decrypt XVC packages or circumvent DRM, and Xbox Live and Store licensing are explicitly out of scope. The game folder is never modified: writes go to an overlay under the title data directory. Graphics draw submission and present are not yet implemented, so the README does not claim any game renders a frame. The code is GPL-2.0-only, and no console SDK headers or binaries are included license and scope notes.

HotRepo's take

XCL is a young repository, created in November 2026, and it has no recorded all-language GitHub daily rank. In the 32-star growth window measured on 2026-11-22, it went from 119 to 139 stars in about an hour and a half according to the new-project board, with 10 forks. The project stands out for its unusually concrete evidence: a complete retail shader pack translated, real console DLLs executing, and a named missing piece in graphics submission. That makes it worth watching for readers interested in console compatibility layers, but it is not yet a way to play a game.

Written by AI from the project's public information and HotRepo's records, updated . The project's own docs are the source of truth.

You might also like

  1. R0Y00/Xbox2WindowsXbox Series X|S static recompilation research for x64 Windows, using GTA VI as a case study.Python134
  2. Freminet/ScarlettXAn experimental high-level emulator that runs legally obtained Xbox Series X|S GDK titles on Windows x64.C++105
  3. omonkeyz/xbox-emulatorA Rust Xbox Series X|S runtime experiment that runs decrypted game dumps as Windows processes, tracking compatibility progress.Python119
  4. Spark198rus/black-pcRun the original Xbox version of BLACK natively on Windows using your own game disc, without an emulator.C++331
  5. Shagg88/COGBoxPC ports of the four Xbox 360 Gears of War games via static recompilation, played through a launcher using your own game copies.C++544