R0Y00/Xbox2Windows
游戏研究把 Xbox Series X|S 软件静态重编译到 x64 Windows 的实验项目,以 GTA VI 为案例。
项目介绍
Xbox2Windows 是一个研究性仓库,探索把 Xbox Series X|S(Scarlett)软件静态重编译到 x64 Windows,并以《GTA VI》作为案例。它把重编译拆成一组可验证的实验,而不是一个可直接游玩的移植版本:从 PE 机器码出发的 x64 函数经 C++ 翻译成新的 Windows DLL;选定的 gfx1013 像素着色器经 HLSL 翻译为桌面 DXIL;另外还涉及 FidelityFX 上采样器的 provider 循环、BC7 纹理 mip 渲染和脚本状态回放。
项目面向希望逐项复现实验的研究者和贡献者,主要通过 CTest 测试夹具验证结果;标题级 CPU 代码执行、完整游戏启动和帧率目前仍未验证。
快速使用
如果只想跑 GPU 检查,可以不安装游戏:下载GPU check 发布包,校验 SHA-256 后解压,在解压目录的 PowerShell 中运行:
.\Run-GpuCheck.ps1
该包自带着色器,不需要编译器、主机或游戏文件。脚本会生成 gpu-report-hardware.md,可在硬件覆盖讨论帖中反馈。
从源码构建完整测试套件时,需要在 x64 Windows 上安装 Visual Studio 的“使用 C++ 的桌面开发”工作负载,包含 x64 MSVC、带 Ninja 的 C++ CMake 工具、Windows SDK 10.0.26100 与 DXC,然后在仓库根目录运行:
.\tools\dev.ps1
cmake --preset dev
cmake --build --preset dev
ctest --preset dev --no-tests=error -R 'desktop_root_signature|era_heap_allocation|offscreen_warp'
这组命令先跑 D3D12 根签名、堆分配和软件渲染三项冒烟测试。若要启用脚本、着色器、纹理和 PE 夹具测试,还需要 x64 Python 3.11 或更新版本(CI 用 3.12):创建虚拟环境、安装 requirements-dev.txt、重新配置 CMake,然后运行 ctest --preset dev --no-tests=error 执行完整套件。已有独立贡献者在 Windows 11 和 VS Build Tools 2022 环境下完成干净构建,并记录了冒烟测试与完整套件的通过情况。
实验选择
每个实验都有对应的 CTest 过滤命令,可以只关注一个方向:静态 CPU 重编译、脚本状态树、纹理恢复、像素着色器到 DXIL 翻译、D3D12 与光线追踪、Windows 运行时行为、PE 导入解析等。贡献方式和证据要求参见贡献指南,各项结果记录在实验笔记中。
硬件覆盖
仓库持续记录 NVIDIA、AMD 和 WARP 适配器的结果。已列出的配置中,408 条 BVH 差异查询均通过;AMD Radeon 卡还完成了强制 wave64 分组,而部分 NVIDIA 配置和 WARP 因报告的 lane 范围不含 64 而跳过该路径。每条记录包含适配器、驱动版本、提交和结果。
使用约束
- GTA VI 案例基于安装元数据中列出的 Scarlett 可执行文件,但检查的文件里没有主可执行文件;公开回归套件使用源码构建的夹具和独立构建的着色器。
- 主要环境是 x64 Windows 与 MSVC、Windows SDK、DXC 工具链(独立构建者使用 Windows 11 build 26300.9974 和 SDK 10.0.26100)。
- 公开套件自建夹具,因此大多数检查不需要游戏安装;只有 GPU 检查以打包发布形式提供。
- 项目代码和文档使用 MIT 许可证;第三方游戏、素材、SDK 和商标归各自所有者,项目与 Rockstar Games、Take-Two、Microsoft、AMD 均无关联。
- 标题级 CPU 执行、完整游戏启动和帧率尚未验证,因此它还不是可玩移植版。
HotRepo 点评
Xbox2Windows 在 HotRepo 新项目榜 2026-11-21 的记录中,统计窗口从 2026-11-20 开始,新增 133 个 Star;目前累计 134 Star、5 Fork。项目自己明确把成果定位为实验证据而非能运行的 Xbox 游戏:README 列明标题级 CPU 执行、完整游戏启动和帧率均未验证,案例检查时也缺少主可执行文件。相对扎实的部分是测试面:408 条 BVH 差异查询、逐适配器的硬件报告,以及以夹具为基础的回归测试。GTA VI 的名字带来了初期关注,但项目可信度来自可复现的测试和硬件反馈流程,而不是“能运行游戏”的主张。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- 0marContreras/gta6recomp一个面向《GTA VI》PC 版的实验性着色器与流式加载优化框架,目前只有说明文档。
- ItsNotRexed/Leonida一个在 Windows 上从玩家自有 Xbox Series 游戏包构建原生运行环境的静态重编译项目。
- andrewnakas/gtav-recomp把 Xbox 360 版 GTA V(TU27)静态重编译为原生代码,让持有原版光盘的玩家能在 PC 和手机上运行。
- Mabec-games/Conker-Recomped-and-Reloaded用自己持有的 Xbox 光盘镜像在本机构建《Conker: Live & Reloaded》原生重编译版,支持宽屏、高帧率与房间码联机。
- Shagg88/COGBox把四款 Xbox 360《战争机器》静态重编译为原生 Windows 程序,并附带启动器统一管理游戏、存档和画面设置。