PS2 Web Recomp - PS2の機械語を事前変換してブラウザーで動かす互換ランタイム
PS2 Web Recompは、PS2の主CPUであるEmotion Engine(EE)の機械語を事前にC++へ変換し、WebAssemblyとしてブラウザーで実行するプロジェクトだ。変換済みコードを、PS2のOSや周辺ハードウェアの互換実装と組み合わせる。描画にはWebGPU、補助プロセッサーIOPの命令実行にはインタープリターを使い、ベクトル演算にも事前変換と実行時変換を併用する。 中心にあるのは、タイトルごとの変換工程と、複数の実行方式を持つ互換ランタイムである。CPU命令を翻訳するだけではゲームは動かず、呼び出し先の発見、OS機能、演算の規則、描画や音声まで揃える必要がある。READMEで動作が報告されているのはGran Turismo 4とGod of War IIの2本で、他タイトルには互換機能の追加が必要になり得る。以下の構成はREADMEの説明に基づき、ソースコードとの一致や性能は独立検証されていない。
ポッドキャスト形式で聴く
約4分AI生成の会話音声です。記事の要点を短くまとめています。
なぜ注目されているか
2026年10月13日の取得時点でGitHubは398スター・23フォーク、Hacker Newsの投稿は279ポイント・146コメントを記録している。日次スター増加とGitHub Trendingの掲載順位は確認できない。これらは関心の量を示す観測値で、動作互換性や速度の裏付けではない。
なぜ重要なのか
この設計が示すのは、実行時に抱える仕事の一部を、タイトル別のビルド工程へ移す選択肢だ。静的解析だけで完結させず、ゲームを試行して未発見の呼び出し先を集め、再変換する。そのため変換工程そのものが、どこまでゲームを探索できたかに依存する。ブラウザー実行を成立させるには、生成コードの効率だけでなく、探索の到達範囲と互換ランタイムの完成度を一緒に管理する必要がある。
また、描画の最適化では、GPUへ何を何回送るかが大きな論点になる。事前変換、描画バッチの再編成、転送キャッシュ、workerへの分離を組み合わせる構成は、WebAssemblyとGPUの境界を研究する題材になる。ただし、2タイトルの動作報告から一般的な移植基盤としての成熟度までは判断できない。
この記事に出てくる言葉(7語)
- 静的再コンパイル
元の機械語を実行前に別のコードへ翻訳する方式。本ツールではEEコードからC++を生成し、WebAssemblyへビルドする。
- ゲストアドレス
PS2側のコード上のアドレス。変換対象の入口や、スレッド切り替え後の再開位置を表す。
- 高水準エミュレーション
本ツールでは、EE側のスレッドやセマフォなどのOS機能を互換処理として実装する方式を指す。
- VUマイクロプログラム
ゲームがベクトルユニットへアップロードする演算コード。既知のものは事前変換し、未知のものは実行中に変換する。
- GS
PS2の描画ハードウェア。本ツールはそのVRAM配置と描画処理を、GPUメモリーとWebGPUのcompute shaderで再現する。
- スウィズル配置
GSのVRAMで使われるメモリー配置。本ツールはその配置をGPU上にも保持し、同じメモリーを描画先やテクスチャーとして扱う。
- cross-origin isolation
SharedArrayBufferを使うために必要なブラウザー側の条件。本ツールの配信ではCOOPとCOEPのHTTPヘッダーを設定する。
1. 読む前に知っておきたいこと
実行ファイルの翻訳だけでは閉じない
PS2用実行ファイルをブラウザーで動かすには、EEの命令実行に加え、ゲームが依存する環境を再現する必要がある。生成コードが正しく分岐しても、スレッドや割り込み、ディスク読み出し、ベクトル演算、描画の意味が合わなければ動作は成立しない。移植の対象はCPUコードと、そのコードが前提とするOS・ハードウェアの契約である。
PS2 Web Recompは、この仕事を構成要素ごとに分ける。EEは事前変換、IOPは命令の解釈実行、OS機能はC++による互換実装、GSはWebGPUによる描画を担当する。READMEの「エミュレーターなし」という表現だけでは、この混合構成を説明しきれない。理解すべきなのは、どの処理を変換で置き換え、どの挙動を実行時に再現するかという境界だ。
このプロジェクトで露わになったボトルネック
初期実装ではVU1をインタープリターで実行し、GSをソフトウェアで描画していた。作者は最初のレースがネイティブ実行でも3fpsだったと報告する。GSのWebGPU化とVU1プログラムのコンパイル後には約70fpsになったという。機器型番や解像度は明記されず、ブラウザーでの測定でもないため、後述のブラウザー性能とは分けて読む必要がある。
この経緯から読み取れるのは、EEを事前変換するだけでは十分でなかったという点だ。演算と描画を高速化すると、今度はテクスチャー転送、描画バッチの分割、ブラウザーのスケジューリングが課題になる。ただし、従来ツール全般の方式や性能を比較する資料はなく、このプロジェクト内の改善過程として捉えるべきである。
注目の量と互換性の証拠を分ける
リポジトリは2026年10月8日に作成された。10月13日の観測値はGitHubで398スター、23フォーク、Hacker Newsで279ポイント、146コメントだった。日次スター増加は不明で、GitHub Trendingへの掲載や順位も確定できない。これらは直近の関心を示すが、技術的な正しさや対応タイトルの広さを裏づける数値ではない。
技術一次資料として与えられているのはREADMEとリポジトリメタデータである。動作例から構成を理解することはできても、実装の正確さや再現性の評価には、コードや試行結果の確認が残る。新しさと注目度を、互換ランタイムの完成度に読み替えないことが出発点になる。
2. どう動くのか
静的解析を実行トレースで補う
入口はport.shだ。ISO、またはISOを含むZIP・7zを受け取り、SYSTEM.CNFが指定する起動プログラムを読み取る。eerecompはそのEE機械語の制御フローを追い、関数を発見してC++を生成する。
ただし、関数ポインター経由の呼び出し先を静的解析だけですべて見つけることはできない。そこでヘッドレス実行を挟み、未発見の関数アドレスを記録する。そのアドレスを新たな入口として追加し、再変換する。新しいアドレスが出なくなるまで、試行と変換を反復する。同じ試行でアップロードされたVUマイクロプログラムも収集し、事前コンパイルの対象にする。最後にブラウザー用ページとネイティブランナーを生成する。
既定の探索入力はstartと5秒ごとのcrossで、--pressと--framesで変更できる。最終試行の画像も保存される。この反復が収束したことは、その入力で新しい入口が見つからなくなったことを意味する。未到達の場面にある間接呼び出し先まで網羅した保証は、取得資料からは確認できない。
EEの制御フローとOS機能を接続する
eerecompはゲストコードを16KiB単位でC++へ出力する。単位をまたぐジャンプは末尾呼び出しになり、スレッド切り替え時にはホストスタックを巻き戻して、ゲストアドレスから実行を再開する。PS2側の実行位置を、生成C++の呼び出し構造と再開位置へ写す仕組みだ。
生成コードはR5900の128ビットレジスター、マルチメディア命令、分岐遅延スロット、独自の浮動小数点規則を扱い、VU0をコプロセッサーとして扱う。そのコードに接続するEE側ランタイムは、スレッド、セマフォ、割り込み、アラーム、SIFを高水準エミュレーションで処理する。
IOP側は別の方針を採る。ディスク上のIRXモジュールをR3000インタープリターで実行し、IOPカーネルと呼び出し先ライブラリをC++で再実装する。したがって、EEの翻訳が成功していても、ゲームが必要とするOS呼び出しやIOPライブラリが欠ければ止まり得る。なお、EEの自己書き換えコードや動的コード生成への対応は資料では確認できず、次のVUの実行時変換とは分けて考える必要がある。
VUは演算結果と見えるタイミングを扱う
VU1では、命令の演算だけでなく、MAC・status・clipフラグのパイプライン遅延をモデル化する。ゲームにとっては、どのフラグ値がいつ見えるかも実行の意味に含まれるためだ。
試行で発見したマイクロプログラムはSIMD C++へ事前変換する。一方、実行中に初めて出会うものはWebAssemblyモジュールへ変換する。既知のプログラムをビルド時に処理し、未収録のプログラムを実行時に補う構成である。
ただし、特殊値や遅延のモデル化は、演算の完全一致を保証しない。VUの算術にはホスト側の演算を使うため、PS2の切り捨てや不完全な乗算器との差で、結果の最下位ビットが異なる場合がある。タイミングの互換性と数値のビット単位一致は、別の検証項目として残る。
GSのメモリー配置を保ち、転送を減らす
GS実装は4MBのVRAMを本来のスウィズル配置のままGPU上に保持する。同じメモリーを描画先、テクスチャー、パレットとして扱う関係を、その配置の上で再現する。三角形をタイルへ振り分け、WebGPUのcompute shaderで描画する。ソフトウェアGSも、GPU出力を比較するためのリファレンスとして残している。
転送の順序も性能に関わる。テクスチャーやパレットのアップロードが三角形バッチを分割すると、compute dispatchが増える。作者は、依存関係を保ちながらアップロードを関係のない三角形より先へ移し、フレーム当たりのdispatchを約650回から約80回へ減らしたと報告する。測定シーンと機器は不明であり、一般的な削減率とは扱えない。
作者によれば、Gran Turismo 4はレース中に毎フレーム同じ3MBのテクスチャーをアップロードする。GPUに16MBの内容キャッシュを置き、WebAssemblyから送るデータ量を約60%削減したという。GSメモリーはフレーム間で入れ替わるため、アップロード操作そのものは省略できない。内容の再利用で境界を越える転送量を減らす工夫であり、測定機器や集計区間は示されていない。
workerからGPU・音声・ディスクへつなぐ
エミュレーションとVU1は別々のworkerで動く。GSコマンドはリングバッファーを通り、WebGPUデバイスを所有するページスレッドへ届く。CPU側の互換実行とGPUへのコマンド供給は、スレッド間の受け渡しで接続される。READMEは、ネストしたsetTimeoutの4ms制限を避けるためMessageChannelでyieldし、エミュレーションをworkerへ移したとも説明している。
音声はSPU2の48音声、ADPCM、ADSR、ストリーミングDMAを再実装し、共有メモリーからAudioWorkletへ出力する。動画はIPUの実装でMPEG-2を復号する。命令変換と描画に加え、こうした出力系も互換ランタイムの責任範囲に入る。
ディスクはHTTP Rangeで必要部分を読む。起動時には実行ファイルを先にダウンロードし、ディスク全体の取得を待たない。実行はブラウザー内で進む一方、ディスクデータの供給は配信サーバーに依存する。メモリーカードはプレイ元アドレスに対応するブラウザーストレージへ保存され、PCSX2と同じ配置の.ps2ファイルをインポート・エクスポートできる。
3. 使いどころと限界
ローカルでのタイトル移植と互換性調査
向いているのは、所有するゲームを変換し、試行入力やフレーム数を変えながら、到達範囲と不足する互換機能を調べる開発者だ。静的解析で入口を集め、実行で補完する反復は、バイナリー変換工程を学ぶ題材にもなる。単にページ生成が終わることと、ゲーム全体が動くことは区別して確認する必要がある。
動作を立ち上げたタイトルはGran Turismo 4とGod of War IIの2本に限られる。READMEは他タイトルについて、未実装のシステムコール、IOPライブラリ、GS機能で停止する可能性が高いと注意している。幅広いタイトルが追加実装なしで動くことを前提にする用途には合わない。
PCSX2とはメモリーカード交換による補完関係がある。進行状況を引き継げる一方、取得資料だけでは両者の実行方式、速度、対応範囲を比較できない。PS2 Web Recompを全面的な代替として位置づける根拠はまだない。
速度報告は条件付きで読む
作者はGran Turismo 4のPAL版レースについて、Chrome、ノートPCの内蔵GPU、PS2の2倍の内部解像度で50fpsと報告する。God of War IIの激しい戦闘は、ChromeとノートPC内蔵GPUで、本来の解像度なら60fps、2倍なら48〜60fpsという。
どちらも作者報告であり、CPU・GPU型番、ブラウザー版、測定区間などが不足する。別ツールとの独立した性能比較や、別の端末で同じ速度が出る保証には使えない。先述のネイティブ実行における3fpsから約70fpsへの改善も、これらとは異なる条件の報告だ。
3D描画には実用上WebGPUが必要になる。WebGPUがなければソフトウェア描画へ切り替わるが、READMEでは3Dには遅すぎるとされる。LinuxのChrome・ChromiumにはWebGPUとVulkanのフラグ設定手順もある。ブラウザーで開けることだけでは、必要な描画経路を利用できるとは限らない。
ビルドと配信にも環境要件がある
READMEが報告するビルド実行環境はLinux x86-64で、C++20、CMake、Ninja、Python 3などが必要になる。ブラウザー向けビルドにはEmscriptenを使い、生成コードとビルドにゲーム当たり約300MBを要するという。他OSでのビルド対応は、この資料からは確認できない。
配信ではSharedArrayBufferのため、COOP: same-originとCOEP: require-corpによるcross-origin isolationが必要になる。ディスクの部分読み出しにはHTTP Range対応も要る。付属のserve.pyは両ヘッダーとRangeを扱うが、サーバーに到達できる人はゲームを読み込める。ローカル試行から配信範囲を広げる場合には、誰が到達できるかも運用上の判断になる。
コードのライセンスとゲームの配布を分ける
リポジトリのライセンスはMITで、IPUの一部テーブルにはPlay!由来のBSD 2-clause通知が残る。ただし、その表記から生成ゲームコードを自由に公開できるとは判断できない。
ゲームデータは同梱されず、所有するゲームのイメージを用意する必要がある。READMEは生成C++とWebAssemblyをゲーム実行ファイルの翻訳物として扱い、手元に留めて公開しないよう求めている。ブラウザー用ページを生成できることと、一般公開する運用が適切であることは別の問題だ。配布を伴う使い方では、生成物の権利と配布条件について人による確認が残る。
このツールから考える
ここからは、一次情報と限界を踏まえた編集上の考察です。
PS2 Web Recompから考えたいのは、事前変換によって実行時の仕事を減らしたとき、その責任がどこへ移るかだ。EEコードは先に翻訳できるが、入口の集合は試行で補完する。ゲームが依存するOSやハードウェアの挙動は、互換ランタイムが引き受ける。変換器の正しさ、探索の到達範囲、互換実装の充足度がつながって初めて、タイトルの動作を説明できる。
この方式を移植工程として扱うなら、生成物だけでなく、どの入力でどこまで実行したかも評価材料になるだろう。新しい入口が出なくなったことと、全経路を確認したことは同じではない。対応報告が2タイトルに限られ、演算にも実機との差が残る現在は、完成した汎用互換基盤より、移植と検証の責任分担を観察できる題材として読むのが妥当だ。今後見るべきなのは、追加タイトルで不足機能と未到達経路をどう切り分け、動作の根拠を積み上げられるかである。
検証に使用した一次情報
DevTool Lensでは、第三者の二次情報やREADMEの宣伝文句に依存せず、以下の公式リポジトリ・ドキュメント・リリース情報を精査して記事を作成しています。
- [readme]snuri00/ps2-web-recomp README
- [repo]snuri00/ps2-web-recomp GitHub Repository
- [github_trending]GitHub Trending Daily (2026-10-13)