Leonida — Xbox版GTA6のPC向けネイティブ静的リコンパイル基盤
ItsNotRexed/Leonida
★ 5,700 ・ Python ・ GPL-3.0
概要
Leonida は、Xbox Series 版『Grand Theft Auto VI』のデータを、ユーザー自身が所有する正規パッケージから読み込み、Windows PC 向けにネイティブ動作させることを目指している静的リコンパイル(Static Recompilation)プロジェクトです。リポジトリの主な実装言語は Python で構成されています。
現時点において本プロジェクトは初期開発段階にあり、ゲーム自体の起動やプレイはまだ行えません。現行の実装では、ゲームの実行ファイルがなくても進められる基盤部分――具体的にはパッケージの検査、RDNA2 シェーダーコードの SPIR-V(Vulkan)へのトランスレート、3Dモデルやテクスチャ・オーディオといった各種アセットの抽出・デコード、Direct3D 12 呼び出しを Vulkan へ変換するレイヤーの開発などが中心となっています。
コンソールゲームの静的リコンパイル技術や、コンソール固有の GPU 命令を Vulkan 向けにトランスレートするグラフィックスパイプラインの設計に関心がある開発者・技術者にとって、興味深い実装資料となっています。
主な特徴
- RDNA2 から SPIR-V への静的シェーダー変換
Xbox Series 向けにプリコンパイルされた RDNA2 GPU プログラム(計26,503個)をアンパック・逆アセンブルし、Vulkan 互換の SPIR-V へ変換します。Vertex、Pixel、Compute、Mesh、Geometry の各シェーダーステージに対応しており、変換後のバイナリはspirv-valによる検証を通過しています。 - 32-wide 環境向けの Wave64 エミュレーション
AMD GPU(64-wide サブグループ)向けに書かれた Wave64 シェーダーを、NVIDIA や Intel などの 32-wide サブグループ環境でも正確に実行できるよう、コンピュートおよびメッシュシェーダー向けのエミュレーション機能を備えています。 - アセットの抽出とフォーマット変換
ゲームパッケージから、モデルデータ(OBJ 形式)、テクスチャ辞書(DDS 形式)、オーディオバンク(AWC 形式)を抽出するツール群が含まれています。音声は Opus から Ogg Opus への可逆再パッケージングや、XMA2 のデコードに対応しています。 - Xbox 固有 Direct3D 12 から Vulkan へのトランスレーション層
Xbox の ABI プロキシの背後で、Vulkan バックエンドを用いたキュー、コマンドリスト、フェンス、デスクリプタヒープ、各種リソースの生成およびメモリ操作を行う変換レイヤーが開発されています。 - ローカル完結型のクリーンなビルド構成
ゲームデータや暗号鍵、実行ファイルはリポジトリ内に一切含まず、利用者が所有するローカルディスク上のパッケージのみから必要なファイルを生成する設計になっています。
使い方
前提条件
Leonida をビルドして実行するには、以下の環境が必要です。
- Xbox Series 版パッケージ(バージョン 1.0.2.1)の平文データ
- Windows 10/11 x64(作業用スペースとして約350GBの空き容量が必要)
- Python 3.12 以上(
PATHへの追加が必要) - .NET 8 SDK
- Vulkan SDK(
spirv-as/spirv-valの利用のため) - AMDGPU ターゲットを有効化した LLVM 21 以上(
llvm-mc用。Windows ではリポジトリ付属のscripts\build_llvm_mc.ps1や WSL 経由の Ubuntu パッケージを利用可能) - Visual Studio 2022(「C++ によるデスクトップ開発」ワークロードが必要)
- ffmpeg(
PATH上に配置。XMA2 ストリームのデコードや WAV 出力時に使用)
ビルド手順
リポジトリをサブモジュール込みでクローンします。
git clone --recursive https://github.com/ItsNotRexed/Leonida
もっとも簡単な方法は、プロジェクトルートにある Build.bat を実行することです。
バッチファイルを実行すると、ローカル PC 内(ダウンロード、デスクトップ、ドキュメント、各ドライブの直下など)から該当するゲームパッケージを自動的に検索し、前提ソフトウェアの導入状態やディスク空き容量をチェックした上で処理を開始します。ビルド成果物は Documents\Leonida に出力されます。
CLI からの実行
make_game.py を直接実行することで、パイプラインの段階的な実行やオプション指定が可能です。
# PC 内のゲームコピーを検索
python -I make_game.py --find
# パッケージの整合性チェックのみを実行
python -I make_game.py --check
# パスを明示してビルドを実行
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
# 音声を PCM WAV にも展開
python -I make_game.py --game "D:\path\to\your\package" --wav
# Wave64 エミュレーションの設定を明示(auto / on / off)
python -I make_game.py --wave64-emulate off
ビルドステージは check、shaders、assets、runtime、pipelines の順序で実行されます。pipelines ステージでは、変換されたすべてのシェーダーをドライバー上でパイプラインとしてコンパイルし、キャッシュを事前生成します。
Linux 環境での Vulkan 診断
Linux 上では、シェーダーの診断ツールである vk_pipeline_check をビルドして実行できます(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
技術的なポイント
静的リコンパイルの構成方針
Xbox Series の CPU は PC と同じ x86-64 アーキテクチャを採用しているため、CPU 命令のエミュレータを用意するのではなく、元のゲームコードをネイティブにロードして実行し、コンソール側のシステムソフトウェアや API 呼び出しをシム(Shim)で置き換える方式を採っています。
PE ローダーおよびインポートシムの段階では、CRT の起動、静的領域の初期化、ヒープ、ファイルアクセス、スレッド生成、GDK インポートなどを模擬するスタンドイン実行ファイルを用いたエンドツーエンドのテスト(gta6rt --run)が実装されています。
シェーダー逆アセンブルと Vulkan 変換
Xbox 向けに事前コンパイルされた RDNA2 GPU 命令は、AMDGPU ターゲットを持つ llvm-mc を用いて逆アセンブルされ、中間構造を経て SPIR-V へとトランスレートされます。全26,503個のシェーダーに対して以下のような内訳と検証が行われています。
- 頂点シェーダー(VS):2,236
- ピクセルシェーダー(PS):12,101
- コンピュートシェーダー(CS):2,689
- メッシュシェーダー:9,282
- ジオメトリシェーダー:195
変換された SPIR-V はすべて spirv-val で検証されるとともに、パイプライン作成用のメタデータインデックスが生成されます。
また、ハードウェア構造の違いに起因するサブグループサイズ(Wavefront サイズ)の差異を解決するため、Wave64 エミュレーションが導入されています。AMD 環境(64-wide)ではネイティブに動作する一方、NVIDIA や Intel などの 32-wide 環境では、コンピュートおよびメッシュシェーダー向けに --wave64-emulate を適用することで正確性を確保しています。
Xbox D3D12 から Vulkan への API マッピング
グラフィックス API に関しては、Xbox 向け Direct3D 12 の実装を Vulkan へブリッジするランタイムが開発中です。キュー、コマンドリスト、フェンス、デスクリプタヒープ、各種コミット/予約リソース、レンダーターゲットビュー、深度ビュー、テクスチャビューおよびサンプラー(バインドレスセットへの登録)の作成が Vulkan 上にマッピングされています。バリア、クリア、アップロード、コピー(ブロック圧縮テクスチャ含む)、カラーリゾルブの各操作が Vulkan 上で実装されています。
一方で、バッファビュー、ルートシグネチャ、パイプライン、ドローコール、スワップチェーンといった描画の中核機能は、現段階では未実装となっています。
注意点
- ゲームはまだ起動しません
プロジェクトステータスは「Early」であり、README に明記されている通り「Booting, story mode, anything playable: ❌ No」となっています。ゲーム本体を起動して遊ぶことは現時点では不可能です。 - ゲームデータ・実行ファイルは一切付属しません
リポジトリにはゲーム本体、暗号鍵、実行ファイルは含まれておらず、暗号の解除やプロテクションの回避を行う仕組みも提供されていません。動作させるには、すでにディスク上に平文として読み出せる状態の正規パッケージ(Xbox Series 1.0.2.1)を自前で用意する必要があります。 - 動作要件とストレージ消費
ビルド作業領域として約 350GB の空き容量が必要です。また、AMDGPU ターゲットを含めた LLVM 21 の手動ビルドや、Visual Studio 2022、Vulkan SDK、.NET 8 SDK など多数の開発環境のセットアップが求められます。 - ライセンス
本プロジェクトは GNU General Public License v3.0(GPL-3.0)の下で公開されています。
まとめ
Leonida は、Xbox Series 向け『GTA 6』のバイナリ資産を PC 上でネイティブ動作させることを目標に掲げた静的リコンパイルプロジェクトです。現時点ではゲーム自体の起動には至っていませんが、RDNA2 から SPIR-V への大量のシェーダー変換や、D3D12 から Vulkan へのマッピングなど、高度なグラフィックス基盤の解析・実装が進められています。





