搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

ivall/xcl

游戏

在 Windows 上原生运行 Xbox Series X|S 游戏文件的实验性兼容层,适合研究主机兼容与着色器重编译的技术用户。

147
10
Rust
GPL-2.0
创建于 1 天前

项目介绍

XCL 是一个实验性的 Xbox Series X|S 兼容层:它不做 CPU 模拟,游戏里的 x64 代码在 PC 上原生执行,XCL 代替 PC 上不存在的控制台库(kernelx.dll、XGameRuntime、d3d12_xs.dll 等),思路类似 Wine/Proton。主机 GPU 代码原本是 RDNA2 机器码,会被重编译成 HLSL,再生成 PC 可用的 DXIL。项目处理的是用户自己拥有的、已解包的游戏文件 ivall/xcl。

当前进度

项目方称基础部分已用一款零售游戏的数据完成验证:样本着色器包中的 24,064 个 RDNA2 程序全部转成 HLSL,游戏自带的 Bink 2 视频、光线追踪 BVH 构建和 AMD FSR 4 等控制台 DLL 能在 PC 上运行,样本纹理包中 909/912 张纹理逐字节一致,另有 150 个自动化测试。尚未完成的是 D3D12.X 的绘制提交和 PresentX 路径;作者表示这部分必须借助真实游戏可执行文件才能推进,因此目前还不能让游戏出画面。具体测量和后续步骤见 HANDOFF.md,设计见 设计文档。

快速使用

需要 Windows 10/11 x64、Rust 的 stable-x86_64-pc-windows-msvc 工具链、带 DXC(dxcompiler.dll 和 dxil.dll)的 Windows SDK、支持 Shader Model 6.6 的 D3D12 GPU,以及系统自带的 xgameruntime.dll(随 Windows/Gaming Services 提供)。开发与测试基于 AMD RDNA4,其他 GPU 未经验证。

cargo build --release --workspace          # 生成 target\release\xcl.exe

xcl inspect D:\Game\game.exe               # 查看游戏导入及 XCL 的对应处理
xcl run D:\Game [-- game arguments]        # 尝试运行已解包的游戏目录
xcl disasm <shader.bin> [--hex]            # RDNA2 反汇编
xcl shaders D:\data\shaders.rpf --top 50   # 着色器包统计
xcl rpf D:\data\shaders.rpf --extract NAME --out folder

每次运行都会在 %LOCALAPPDATA%\XCL\<title>\ 下写入 logs\report.json,记录被调用的桩、未知的 D3D12.X 槽位、运行库类、着色器统计和崩溃信息,可作为下一步的工作清单。测试可用 scripts\test.ps1 运行;真实游戏数据测试需通过 XCL_SAMPLE_RPF、XCL_SAMPLE_DLLS、XCL_SAMPLE_TTPF、XCL_SAMPLE_BK2、XCL_SAMPLE_BVH4、XCL_SAMPLE_AWC 等环境变量指向自己的文件,未设置时相关测试会跳过。

使用约束

XCL 只处理用户自己拥有的已解包游戏文件,不负责解密 XVC 包或绕过 DRM,Xbox Live 和商店授权明确不在计划内。游戏目录不会被修改,写入会落到标题数据目录下的覆盖层。图形绘制提交和呈现尚未实现,因此不能认为现在已能渲染游戏画面。项目使用 GPL-2.0-only 许可,仓库不包含主机 SDK 的头文件或二进制文件 许可与范围说明。

HotRepo 点评

XCL 是 2026 年 11 月创建的新仓库,目前没有记录到全语言 GitHub 日榜名次。在 2026-11-22 记录的新项目榜中,它在约一个半小时的统计窗口内从 119 星增至 139 星,新增 32 星,另有 10 个 fork。它值得关注的地方在于证据具体:整包零售着色器全部完成转换、真实主机 DLL 能运行,并且把图形提交这个缺口说得很明确。但就当前状态而言,它还不是能用来玩游戏的工具。

本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. R0Y00/Xbox2Windows研究把 Xbox Series X|S 软件静态重编译到 x64 Windows 的实验项目,以 GTA VI 为案例。Python134
  2. Freminet/ScarlettX在 Windows x64 上运行合法获取的 Xbox Series X|S GDK 游戏的高层模拟器实验项目。C++105
  3. omonkeyz/xbox-emulator用 Rust 实现 Xbox Series X|S 运行时,让已解密的游戏转储以 Windows 进程运行,并记录兼容进度。Python119
  4. Spark198rus/black-pc用自己手里的 Xbox 光盘,在 Windows 上原生运行《BLACK》,不用装模拟器。C++331
  5. Shagg88/COGBox通过静态重编译把四款 Xbox 360《战争机器》移植为原生 Windows 程序,用自带启动器加载玩家自己的游戏副本。C++544