搜索你想找的开源项目

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

分享到微信

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

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

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

R0Y00/Xbox2Windows

游戏

研究把 Xbox Series X|S 软件静态重编译到 x64 Windows 的实验项目,以 GTA VI 为案例。

198
12
Python
MIT
今天创建

项目介绍

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 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. 0marContreras/gta6recomp一个面向《GTA VI》PC 版的实验性着色器与流式加载优化框架,目前只有说明文档。618
  2. ItsNotRexed/Leonida一个在 Windows 上从玩家自有 Xbox Series 游戏包构建原生运行环境的静态重编译项目。Python102
  3. andrewnakas/gtav-recomp把 Xbox 360 版 GTA V(TU27)静态重编译为原生代码,让持有原版光盘的玩家能在 PC 和手机上运行。C++289
  4. Mabec-games/Conker-Recomped-and-Reloaded用自己持有的 Xbox 光盘镜像在本机构建《Conker: Live & Reloaded》原生重编译版,支持宽屏、高帧率与房间码联机。C++105
  5. Shagg88/COGBox把四款 Xbox 360《战争机器》静态重编译为原生 Windows 程序,并附带启动器统一管理游戏、存档和画面设置。C++473