xbox-emulator — Xbox Series X|S ビルドを PC で動かす Rust 製ランタイム
omonkeyz/xbox-emulator
★ 784 ・ Rust ・ Apache-2.0
概要
omonkeyz/xbox-emulator は、Xbox Series X|S 向けにビルドされたソフトウェアを PC 上で通常の Windows プロセスとして動作させることを目指す、オープンソースの実験的ランタイム環境です。先行プロジェクトである drycheetah84/TomBox の継続プロジェクトとして開発が進められており、特定の単一タイトルに依存しない汎用的なプラットフォーム層の再実装を目標としています。
本プロジェクトは、低レイヤーのシステムプログラミング、コンソールゲーム機の OS アーキテクチャ、Direct3D 12 の拡張機能、あるいは AMD RDNA2 アーキテクチャ向けバイナリシェーダーの解析・変換に興味を持つ開発者やリサーチャーに適した内容となっています。
なお、本ソフトウェアは法的に取得され、すでに復号(暗号化解除)されたダンプデータを前提として動作します。著作権保護技術の回避や鍵の抽出、パッケージの復号を行う機能は一切実装されておらず、リポジトリ内にもゲームデータや商用バイナリは含まれていません。
主な特徴
-
コンソール専用プラットフォーム層の再実装 Xbox Series X|S 向けにカスタマイズされた Direct3D 12(Direct3D 12.x)、事前コンパイル済み RDNA2 シェーダー、統合メモリテクスチャ、およびコンソール独自のシステムライブラリ群を Windows 上でエミュレート/再実装しています。
-
復号済みダンプのみを対象とするクリーンな設計 リポジトリにはゲームファイルや暗号解除キー、ファームウェアのバイナリは一切含まれていません。すでに復号済みのダンプのみを対象とし、ランタイム自身は復号処理を排した設計となっています。
-
Rust ワークスペースによるモジュール構成 コア機能は Rust 言語で記述されており、ルートの
Cargo.tomlのもとでcrates/やtools/ディレクトリに整理されたワークスペース構造を採用しています。 -
自動化された詳細な進捗トラッキング
tools/progress/gen.pyスクリプトを用いて、システム API、Direct3D 12.x メソッド、RDNA2 命令セット、各シェーダーステージの網羅率を機械的に集計し、マイルストーンやライブラリマップとして公開しています。 -
実タイトルでの検証データとログ Fortnite(Chapter 2 Season 4)のビルドにおいて、起動からプライベートサーバーへのログイン、ロビー画面到達までのマイルストーンを達成した記録が詳細にドキュメント化されています。
使い方
README には、エンドユーザー向けのインストール手順やバイナリの実行コマンド(具体的な起動オプション等)は明記されていません。
開発やコードの確認を行いたい場合は、Rust のビルド環境を用意してリポジトリを取得する構成となっています。
git clone https://github.com/omonkeyz/xbox-emulator.git
cd xbox-emulator
リポジトリ内には Rust ワークスペースを構成する Cargo.toml、各クレートが含まれる crates/、および進捗計測用のスクリプト等が含まれる tools/ が配置されています。また、不足しているコンソールライブラリ関数の実装への貢献を歓迎しており、実装状況は docs/LIBRARY_MAP.md、コントリビューション手順は CONTRIBUTING.md で案内されています。
技術的なポイント
コンソール専用 DLL と Windows システム DLL の分離
Xbox Series X|S の OS は Windows ベースですが、PC 上の C:\Windows\System32 に存在する通常の Windows DLL とは異なるエクスポートや、コンソール専用の DLL が多数存在します。本プロジェクトでは、タイトル解析から得られたコンソール専用ライブラリ群(d3d12_xs、xg_xs、xmem、AcpHal、chad、xapu、xcrdapi など)を特定し、それらのエクスポート関数の実装やフォワーディングを行っています。
また、kernel32.dll や advapi32.dll、mfplat.dll などの標準的な Windows DLL に対しても、コンソール向けに拡張・改変されたエクスポートが存在するため、それらを個別に追跡してスタブやラッパーを提供しています。
RDNA2 シェーダーのデコードと変換
Xbox Series X|S では、事前コンパイルされた RDNA2 向けのシェーダーバイナリが実行されます。プロジェクトではシェーダーデコーダーを備えており、検証された Fortnite のタイトル内シェーダー(105,506 件)については sweep 変換のマイルストーンを達成しています。
一方で、近年の新しいグラフィックスパイプライン機能であるメッシュシェーダー(Mesh Shader)や増幅シェーダー(Amplification Shader)、あるいはルートシグネチャを持たないシェーダーの変換については、依然として対応中のブロッカー(課題)として位置付けられています。
テストタイトルでの検証状況
README では、いくつかのタイトルを対象にした検証状況が報告されています。
- Fortnite(Chapter 2 Season 4 / Build 2.0.1461.7919): 起動、初期フレーム描画、プライベートサーバーへのログイン、ホットフィックス適用、ゲームモード選択を経て、バトルロイヤルのロビー画面(
UI.State.Athena.Frontend)への到達が確認されています。2D インターフェースは正常に描画されますが、3D シーンではキャラクターのマテリアル不備やブルーム処理のアーティファクトが発生しており、音声や操作入力には未対応です。 - XDefiant: ダンプ解析を実施。コンソール OS(10.0.22000)のインポートがマッピングされ、
XCurl、Bink2Scarlett、chad、xapuなどの新モジュールが確認されていますが、実行は行われていません。 - Grand Theft Auto VI(Build 1.0.2.1): 実行バイナリが含まれないダンプのため未実行。シェーダーパッケージ(26,503 シェーダー)のサンプリング調査が実施されています。
注意点
- 開発の進行段階 本プロジェクトは非常に初期かつ実験的な開発段階にあります。マイルストーン表にある通り、キーボード/コントローラー入力、オーディオ出力、実際のゲームプレイ動作などは「not reached(未達成)」となっており、ゲームを遊ぶためのエミュレータとしては動作しません。
- ライセンスの表記
GitHub のメタデータ上では
Apache-2.0が指定されていますが、README 内の Contributing セクションにはMIT OR Apache-2.0(デュアルライセンス)と記載されています。利用や貢献にあたってはリポジトリのライセンスファイルおよびCONTRIBUTING.mdを確認してください。 - 動作要件と対象データ Windows 環境での動作を想定しています。暗号化されたままの公式ディスクイメージやパッケージを直接復号して起動することはできず、適切な手段で復号済みのファイル群が必要です。
まとめ
omonkeyz/xbox-emulator は、Xbox Series X|S 向けのバイナリを Windows 上で直接走らせる互換レイヤーの構築に挑戦している Rust 製プロジェクトです。ゲームプレイが可能な段階には至っていませんが、コンソール専用 OS API や RDNA2 シェーダーパイプラインの緻密なマッピングが進められており、最新コンソールの低レイヤー構造に関心があるエンジニアにとって注目の取り組みです。





