PS2 Web Recomp

PS2 Web Recomp の環境準備

ゲームを変換する前にビルド環境を確認します。上流の必要条件には Git、CMake、Ninja、C++20 コンパイラー、Python 3 が含まれ、圧縮形式によっては展開ツールも必要です。別のパソコンでの成功例だけを根拠にせず、最新の公式手順で自分の環境を確認してください。

リポジトリ、ゲームイメージ、生成物を区別できる場所に置き、コマンドで使う識別名を決めます。開始時のツールのバージョンを記録し、比較の途中でコンパイラーやブラウザを同時に変更しないようにすると、問題の原因を絞り込みやすくなります。

ローカルでのビルド手順とコマンド

リポジトリを取得したら、そのディレクトリで以下の例を実行します。引用符内のファイル名は自分のゲームイメージに置き換えてください。mygame は説明用の識別名で、配布ゲーム名ではありません。サーバー起動時にも同じ識別名を使い、生成物の場所を一致させます。

cd ps2-web-recomp
scripts/port.sh mygame "My Game.iso"
python3 scripts/serve.py build/web-mygame games/mygame/disc.iso

ビルド時とブラウザ実行時の問題は分けて調べます。コンパイルに失敗した場合は、ブラウザを開く前に最初の有用なエラーを保存してください。成功後はツールが案内するローカルサーバーとアドレスを使い、HTML の直接起動や異なる実行回のファイルの混在を避けます。

既存の Emscripten を使う場合、ビルドを実行する端末で環境設定が有効か確認します。別の端末には同じ PATH が引き継がれないことがあります。SDK とプロジェクトのリビジョンを記録し、ソース変更とツール変更の影響を区別してください。

ブラウザ実行で止まったときの確認

実際にゲームを動かす端末で機能を確認します。WebGPU の利用可否はブラウザだけでなく、OS、GPU、ドライバー構成にも左右されます。ブラウザ名だけで対応を判断せず、グラフィックス診断とページのエラーを調べ、アダプターを利用できるか確認します。

SharedArrayBuffer やスレッド関連のエラーでは、開発者コンソールの crossOriginIsolated を確認します。クロスオリジン分離にはレスポンスヘッダーなどの条件があり、HTTPS に置くだけでは有効になりません。公式の配信手順に従い、サーバー設定とコンパイルの問題を切り分けてください。

ページが開いてから停止した場合は、最初のコンソールエラーと対応する通信を保存します。要求されたパスにファイルが存在するか、返されたものが HTML のエラーページではないかを確認し、一度に一つずつ条件を変えます。ファイル不足、GPU の問題、未対応のゲーム機能は別々に調べる必要があります。

ブラウザのセーブと生成ファイルを分ける

上流のプレイヤーにはメモリーカードの読み込みと書き出しがあります。サイトデータの削除、ブラウザのプロファイル変更、別のローカルアドレスでの実験の前にバックアップを取ってください。カードは日付付きの場所へ保存し、ビルド生成物とは分けます。Web ファイルのコピーだけで進行状況も移るとは限りません。

どのゲームとアドレスで作成したセーブかを記録し、復元は複製したカードで試してください。唯一のバックアップを上書きせずに確認すると、保存処理の問題か、ゲーム自体がまだ動作段階に達していないのかを判断しやすくなります。

再現できる動作報告の書き方

タイトル画面が出ることと、ゲーム全体が遊べることは別です。起動、メニュー、操作可能な場面、音声、画面遷移、セーブやロードについて、実際に確認できた段階を記録します。未確認の項目は不明とし、短い成功例だけで完全対応と判断しないでください。

ゲームの版と地域、プロジェクトのリビジョン、OS、ブラウザのバージョン、GPU、ビルドコマンド、再現手順を添えます。性能を測った場合は場面、解像度、測定方法も記録し、同じ条件で比較してから差を判断します。具体的な記録があると、他の読者も検証しやすくなります。

HY8BIT の現時点のゲーム情報は作者の報告をまとめたものです。ここで示すチェックリストは個人検証のための編集上の提案で、HY8BIT がこれらのテストを実施したという意味ではありません。個人の結果と上流の報告を分け、共有時には該当する issue やリビジョンを示してください。