跳到正文
Hacker News· ebrahimh·· 21 小时前AI 评分34

Leonida:将 Xbox 版 GTA 6 静态重编译到 PC 的项目

Leonida – PC Recompilation of the Xbox Version of GTA 6

AI 导读

Leonida 是一个静态重编译项目,让 Xbox Series 版《GTA 6》在 Windows 上原生运行,需用户自备游戏副本(版本 1.0.2.1)。项目已完成全部 26,503 个 RDNA2 着色器到 SPIR-V 的翻译并通过 spirv-val,模型、纹理与音频资源也已导出。目前游戏尚无法启动,Xbox D3D12 到 Vulkan 的转换仍在进行中。

正文 · AI 翻译

《侠盗猎车手 VI》(Xbox Series 版)在 Windows 上原生运行,由你在自己的 PC 上使用自己的游戏副本构建。

状态 | 如何构建 | 工作原理 | 想帮忙? | 致谢 | 许可证 | Discord

Leonida 是一个静态重编译项目。Xbox Series 的 CPU 与 PC 一样是 x86-64,因此游戏的代码会被加载并原生运行,而主机的系统软件则被重新实现。主机预编译的 RDNA2 GPU 程序会被翻译为 SPIR-V 以供 Vulkan 使用。游戏的模型、纹理和音频从你的包中读取。所有这些都在你的 PC 上、使用你自己的游戏副本完成。

重要

本仓库不包含游戏、密钥或可执行文件,也不说明如何获取它们。你需要自己的副本,且其文件已在磁盘上可读。此处没有任何内容会解密或绕过任何保护。构建所产生的一切(生成的着色器、提取的资源、运行时文件夹和你的存档)都来自你的游戏,并保留在你的 PC 上。切勿分享这些文件。

Discord:https://discord.gg/rexed

CA 8T3ztDSKxYK15SUBseqLeviqQwfcG9wUeDGP1wjBpump

项目状态

早期阶段。游戏尚无法启动。所有无需游戏可执行文件即可完成的工作均已就绪,因此一旦开发者拿到可执行文件,便可立即开始启动相关的工作。

项目 状态
查找并校验你的副本(Xbox Series 1.0.2.1) ✅ 可用
着色器:提取、解包原生 RDNA2 代码、反汇编 ✅ 全部 26,503 个
着色器:RDNA2 → SPIR-V 翻译 ✅ 全部 26,503 个(使用 LLVM 21 反汇编;LLVM 23 目前仍有 1,471 个被拒绝,#644):2,236 个 VS、12,101 个 PS、2,689 个 CS、9,282 个 mesh、195 个 geometry。全部通过 spirv-val,并带有用于创建管线的逐着色器元数据索引。⚠️ 其中 21,545 个为 wave64:在 64 宽子组(AMD)上精确。在 32 宽子组(NVIDIA、Intel)上,计算和 mesh 着色器通过 wave64 模拟(--wave64-emulate,在这些平台上默认开启)可达到精确;顶点、像素和几何着色器中的跨半波操作仍为近似
着色器翻译器已在真实 GPU 上验证 ⚠️ 手写的 GPU 测试(顶点获取、纹理采样、导出、ALU 操作、部分寄存器操作、重心坐标、波统一分支、计算 LDS/屏障/缓冲区存储、wave64 掩码)已在 30 多种 GPU 与驱动组合上运行,结果见 #166:NVIDIA Turing、Ampere、Ada 和 Blackwell(Windows 和 Linux);AMD GCN3、RDNA1、RDNA2、RDNA3 和 RDNA4(Windows 驱动和 RADV);Intel Gen9(ANV);Apple M1(MoltenVK,无几何或 mesh 阶段);以及 Mesa llvmpipe。Wave64 测试需要 64 宽子组(AMD)或 LEONIDA_W64_EMULATE=1。这些只是小型测试着色器:游戏自身的着色器由 spirv-val 和驱动管线创建(vk_pipeline_check)来验证,而非通过其输出验证
模型(带真实名称、UV、材质引用的 OBJ) ✅ 已导出。并非所有布局都已解码
纹理字典和世界纹理池(DDS) ✅ 已导出。以 BCPack 存储的池条目在导出时仍会被跳过;一个净室解码器(tools/bcpack.py)可重建 BC1、BC3、BC4 和 BC5,但尚未接入 rpf9dump(说明)
音频库(AWC:Opus、XMA2) ✅ 已完整导出。Opus 以无损方式重新封装为 Ogg Opus;PCM(编解码器 0/2)导出为 WAV;XMA2 使用 ffmpeg 解码。--wav 新增 16 位 PCM WAV(说明)
音乐/电台配置 ?已测量。1,589 条音频配置记录,包含精确时长和 AWC 流 ID;电台分组和内容 ID 列表;无逐轨起始偏移(备注)
PE 加载器和导入垫片 ⚠️ 端到端运行一个替代可执行文件(gta6rt --run:CRT 启动、静态数据、堆、文件、线程、通过垫片的 GDK 导入、返回退出码)。未针对真实可执行文件测试
Xbox D3D12 → Vulkan ⚠️ 进行中。Xbox-ABI 代理背后的 Vulkan 后端设备可创建队列、命令列表、围栏、描述符堆、提交式和保留式资源、渲染目标和深度视图、纹理视图和采样器(进入无绑定集),以及查询堆。屏障、清除、上传、复制(包括 BC)、颜色解析和遮挡、时间戳和管线统计查询在 Vulkan 上运行,已在单个 GPU 上验证。尚无缓冲区视图、根签名、管线、绘制或交换链(计划)
启动、故事模式、任何可玩内容 ❌ 否

如何构建

移植版并非现成下载。它是在你的 PC 上使用你自己的副本构建的。

简单方法:

  1. 安装下面的先决条件。
  2. 下载此项目及其子模块:git clone --recursive https://github.com/ItsNotRexed/Leonida。从 GitHub 的“下载 ZIP”会遗漏 third_party/rpf9-explorer。如果安装了 git,构建过程会获取它,否则会告诉你该怎么做。
  3. 双击 Build.bat。

它会自行找到你的游戏副本:它会查看下载、桌面、文档、游戏、你的主文件夹以及每个驱动器的顶层,深入两个文件夹。它通过几个文件大小识别版本,而不读取任何大文件。如果你有多个副本,它会询问是哪一个;如果找不到,它会要求你粘贴文件夹路径。开始前,它会检查下面所有内容是否已安装以及是否有足够的可用空间,并一次性列出所有缺失项。结果输出到 Documents\Leonida。停止的构建会从上次中断处继续。

你的游戏文件夹是包含 MicrosoftGame.Config 和 .rpf 归档(作为普通文件)的那个文件夹。

先决条件:

  • 你自己的副本,Xbox Series 包,版本 1.0.2.1。
  • Windows 10/11 x64,约 350 GB 可用空间用于工作文件。它们可以通过 --work 放到另一个驱动器上。
  • Python 3.12+(勾选“将 python.exe 添加到 PATH”)。
  • .NET 8 SDK。
  • Vulkan SDK,用于 spirv-as / spirv-val。
  • LLVM 21+ 带 AMDGPU 目标,用于 llvm-mc。官方 Windows 构建没有 AMDGPU 目标。在 Windows 上,scripts\build_llvm_mc.ps1 用它构建原生 llvm-mc.exe(无需 WSL;需要 git 和下面的 Visual Studio C++ 工具)并设置 LLVM_MC。或者在 WSL 中安装 llvm-21 并将 LLVM_MC 设置为整个命令 LLVM_MC="wsl -d Ubuntu -e /usr/lib/llvm-21/bin/llvm-mc"(见 docs/design.md)。在 Linux 上,PATH 中的 llvm-mc 就足够了。
  • Visual Studio 2022 带 使用 C++ 的桌面开发 和 Windows SDK 10.0.26100 或更新版本,用于运行时阶段(运行时使用版本 1.2 根签名,旧版 SDK 不声明)。
  • PATH 中的 ffmpeg(可选:解码 XMA2 流,--wav 需要)。

从终端,行为相同且控制更多:

python -I make_game.py --find                          # list the copies found on this PC
python -I make_game.py --check                         # check your copy, build nothing
python -I make_game.py --game "D:\path\to\your\package" --out "D:\Games\Leonida" --work "E:\leonida-work"
python -I make_game.py --stages shaders,assets         # only some stages
python -I make_game.py --game "D:\path\to\your\package" --wav   # also decode Opus to PCM WAV (large)
python -I make_game.py --wave64-emulate off            # auto (default), on or off; see below

--wave64-emulate 决定是否将 wave64 计算和网格着色器转换为在任何子组大小上都精确 (参见 docs/design.md 中的“Wave64 模拟”)。NVIDIA 和 Intel GPU 具有 32 宽的子组,需要 它。默认值 auto 会询问 vulkaninfo(Vulkan SDK 的一部分),并在以下情况下启用它:除非每个 GPU 都报告 64 宽 子组,或者无法判断时;当运行时将使用的 GPU 无法让计算和网格着色器以 64 宽运行时,它也会启用。该模式保存在翻译后的着色器旁边,更改它会重新翻译它们。 使用 auto 时,之前使用模拟的工作文件夹会在后续翻译和重试中保留它,即使 当前 GPU 支持原生 wave64。使用 --wave64-emulate off 将其原生翻译。

构建会记录哪些翻译器源文件生成了着色器。对这些文件的更改会使用 保存的反汇编重新运行翻译。较旧的工作文件夹在升级后需要一次翻译来记录此信息。

各阶段按顺序运行:check、shaders、assets、runtime、pipelines(在您的 GPU 驱动程序上创建每个翻译后的着色器并保存管道缓存,因此首次启动时不会编译它们)。着色器翻译是最长的步骤:它在 --jobs 个进程上运行(默认情况下为 CPU 线程数的一半)。

--wav 默认关闭,因为 16 位 PCM WAV 比 Ogg Opus 大几倍。它在音频库步骤之后将重新打包的 Ogg Opus 流解码为 work\assets\audio\wav;当构建恢复时,现有的 WAV 文件会被跳过。

Linux 上的 Vulkan 诊断

使用 CMake 3.24+、C++20 编译器以及已安装的 Vulkan 开发头文件和加载器:

cmake -S runtime -B runtime/build/linux
cmake --build runtime/build/linux --parallel
./runtime/build/linux/vk_pipeline_check /path/to/spirv

将包含 index.json 的目录和翻译后的 SPIR-V 文件传递给 vk_pipeline_check。

make_game.py 也可在 Linux 上运行。pipelines 阶段使用上面构建的 vk_pipeline_check (runtime/build/linux 或 runtime/build)。runtime 阶段仅在 Windows 上构建,因此在 Linux 上它需要 runtime/ 的 Windows 构建;没有它,该阶段会被排除在默认阶段之外,请求它会在任何 工作开始之前失败。

在 Linux 上运行加载器

加载器是一个 Windows 程序,在 Wine 或 Proton 下运行;CI 在每次更改 runtime/ 时在 Wine 下运行其测试(Runtime 工作流的 wine 作业)。给 runtime 阶段一个包含 gta6rt.exe 和 gta6rt_tls_host.dll 的文件夹,例如该工作流 windows 作业的 runtime-windows 工件,解压后:

python3 -I make_game.py --runtime-build ~/Downloads/runtime-windows

它将两个文件复制到 --out 中,并在它们旁边写入 gta6rt.sh,这会使用 wine 启动 gta6rt.exe,或 使用 WINE 指定的 Wine(对于 Proton,为其 files/bin/wine)。相同的选项在 Windows 上跳过构建。

工作原理

组件 功能 位置
版本检查 每个受支持版本的每个包文件的名称、大小和 SHA-256 game/、make_game.py
着色器管道 从 shaders.rpf 中切出 DXBC 容器,而不使用其加密的目录表。解包 XBCH → FSSM 原生 RDNA2 程序,使用 LLVM(gfx1013)反汇编它并将其翻译为 SPIR-V tools/shader_carve.py、fssm_unpack.py、shader_disasm.py、rdna2spirv.py
资源导出 在 RPF9 归档和松散的 .ttpf 纹理池中查找已验证的资源 tools/rpf9dump(基于 rpf9-explorer 的 Core)
运行时 映射 PE 映像,将导入解析为垫片(GDK、XMem、d3d12_xs) runtime/
研究工具 PE/RTTI 检查、原始切出、纹理平铺探测、GPU 测试工具 tools/、runtime/test/

翻译器的运行时契约(用户 SGPR、推送常量、内存模型、无绑定图像、顶点获取、 系统值)以及所有格式说明都在 docs/design.md 中;格式、资源、运行时 和验证说明索引在 docs/README.md 中。Xbox D3D12 计划在 docs/d3d12_vulkan.md 中。音频库格式和导出工具在 docs/audio.md 中;docs/related_projects.md 记录了我们可能 阅读的先前技术及其许可限制。

想帮忙吗?

最大的开放部分:

  • 硬件上的着色器翻译器:compute、mesh 和 geometry 现已支持翻译(参见 docs/design.md 中的翻译器约定);仍未解决的是顶点着色器输入布局(如果主机以 NGG 方式运行 VS,则 v0 = VertexIndex 尚未验证)以及 32 宽子组上 VS/PS/GS 中的 wave64 跨半代码。
  • Xbox D3D12 → Vulkan:d3d12_xs 命令列表和描述符堆模型。
  • 解码器目前拒绝的模型布局。

参见 CONTRIBUTING.md。切勿将游戏文件、提取的资源或生成的着色器附加到 issue 或 pull request 中。

致谢

  • breadbbbb 的 rpf9-explorer:tools/rpf9dump 使用的 RPF9 模型、纹理池和 AWC 解码器(git 子模块)。
  • Mesa(MIT):GFX10 资源描述符布局(tools/gfx10_formats.json), 以及作为 16 位结果和着色器系统寄存器参考的 ACO/RADV 规则。
  • Microsoft 的 libHttpClient(MIT):third_party/xtaskqueue 中的 XTaskQueue/XAsync 实现, 由离线 xgameruntime shim 使用。
  • LLVM:AMDGPU 反汇编器。
  • Logo:SteamGridDB 上 SlyDevil 的“Grand Theft Auto VI”图标。
  • SPIRV-Tools:汇编和验证。

Grand Theft Auto 及所有相关名称均为其所有者的商标。本项目不隶属于他们, 也未获得他们的认可。

许可证

GPLv3(或任何更高版本)。参见 LICENSE。第三方代码保留其自己的许可证。

来源:Hacker News · github.com