OpenStrikeのリリース:2004年の携帯ゲーム機で動くCounter-Strike風FPS
Shipping OpenStrike: A Counter-Strike-Shaped FPS on a 2004 Handheld (pocketjs.dev)
要約
この記事では、2004年のSony PSPで動作する、Counter-Strike風のシングルプレイヤーFPS「OpenStrike」のリリースを発表しています。Rustでゲームエンジンを、TypeScriptとSolidJSでゲームロジックとUIを構築し、Web技術のエルゴノミクスを活かしつつもWebスタックのオーバーヘッドなしで、PSP上で60FPSを維持する単一の実行ファイルとして出荷されています。このプロジェクトは、最新のWeb開発手法が古いハードウェア上でのリアルタイム3Dゲームにも応用可能であることを示しており、ビルドプロセスで計算負荷の高い処理を事前に実行することでパフォーマンスを最適化しています。
全文翻訳
OpenStrikeのリリース:2004年の携帯ゲーム機で動作するCounter-Strike風FPS
本日、OpenStrikeをリリースしました。これはシングルプレイヤーで、Counter-Strike風のFPSであり、クラシックなGoldSrc時代のマップ、ボット、トレーサー、リコイル、ラウンドの流れ、そしてJSXのHUDをプレイできます。ラウンドのルールはTypeScriptで記述されています。HUDはSolidアプリです。そして、この全てが2004年のSony PSP上でロックされた60FPSを維持し、Memory Stickにドロップするだけで動作する単一のファイルとして提供されます。
[画像: OpenStrike on a PSP: the sunlit dust2 courtyard at 480×272 — cliffs, green ammo crates, the rifle viewmodel, and the JSX HUD showing HP 100, ammo 30/90, HOSTILES 3/3]
ネイティブな480×272出力のリリースビルドを2倍で表示。このフレームおよび本投稿の他の全てのスクリーンショットは、エミュレータ上でバイト単位で正確なテストを実行している際のPSP実行ファイル自身のフレームバッファです。
OpenStrikeはpocket-nexus/open-strikeでオープンソースとして公開されています。これはPocketランタイムファミリー(PocketJSの基盤となるアーキテクチャ)上で構築された最初のゲームであり、「Webスタックの機械的な部分なしでのWebスタックのエルゴノミクス」が、UIを超えて、iPhone以前のハードウェア上でリアルタイム3Dゲームにまでスケールすることを示すことを目的としています。
この記事は、ブラウザ向けにJavaScriptを出荷したことがあり、ゲームコンソールに触れたことのない人々を対象としています。組み込みやグラフィックスの経験は想定していません。これは完全なストーリーです。マシンが実際には何であるか、TypeScriptがどのようにして内部に入るのか、1999年のマップフォーマットがあなたのバンドラーとどう関係するのか、シェーダーなしでどのように描画するのか、そしてミリ秒がどこへ消えたのか、といったことです。
問題のマシン
PSP-1000は、333MHzのシングルコアMIPS CPUを搭載しています。インオーダー実行、投機的実行は一切なく、そして—これが私たちにとって最も重要な点ですが—JavaScriptのJITはありません。そのため、全てのクロージャは解釈実行され、全てのフレームで実行されます。32MBのRAMを搭載しており、ユーザープログラムからは24MBが利用可能です。あなたが今読んでいるブラウザタブのJavaScriptヒープは、このマシンの総メモリよりも大きいです。
GPU—ソニーはこれをGraphics Engineと呼んでいます—はプログラマブルシェーダー以前のものです。頂点シェーダーやフラグメントシェーダーをアップロードすることはできません。アップロードする場所がありません。これは固定機能パイプラインです。三角形をマトリックスで変換し、各三角形に色を補間し、バイリニアフィルタリングでテクスチャをサンプリングし、デプスをテストし、ブレンド—レジスタで設定された固定メニューで、2MBのビデオメモリから480×272の画面にフィードします。
そして、あなたが意味するようなオペレーティングシステムはありません。プロセス、仮想メモリ、ダイナミックリンカはなく、console.logの出力先もありません。ゲーム全体—Rustエンジン、JavaScriptインタープリタ、JSバンドル、マップ—は単一の実行ファイル(PSPの.exeであるEBOOT.PBP)にリンクされ、実行されるとマシンが渡されます。クラッシュすると、マシンがクラッシュします。
それがデプロイターゲットです。私たちがデプロイしたものはこちらです。
1つの製品、2つのマシン
OpenStrikeは、Web開発者がすぐに認識できる線—ネイティブアプリの分割—で分割されています。これは移植されたものです:エンジンはRust、製品はJavaScriptです。
Rust側(openstrike-coreとPocket3Dレンダラー)は、フレームを落としてはならない全てのもの—プレイヤーの移動と衝突、ボットAI、弾丸、そして世界の描画—を所有します。JavaScript側は、それが単なるゲームではなくこのゲームである理由の全て—rules.tsはラウンドの流れ、スコアリング、武器とボットのチューニングテーブルです。hud.tsxはHUD全体—体力、弾薬、クロスヘア、スコア—であり、通常のSolidコンポーネントツリーでTailwindクラスでスタイリングされ、PocketJS上で実行されます。ベースゲームは、modが決して持てないような特権を自身に与えません。rules.tsを変更すれば、あなたはmodを作成したことになります。
実行ファイルに組み込まれているJSエンジンはQuickJSです。これはFabrice Bellardによる、数百キロバイトにコンパイルされる完全なES2023エンジンです。QuickJSは、このPSPにとってNodeにおけるV8のようなものです。ホストはそれにstrike APIサーフェスとui APIサーフェスを渡し、同じopenstrike.jsバンドルが全てのターゲットでそれらにブートします。
全てのターゲット—複数形であり、それがリリースの真のヘッドラインです:
openstrike.js + openstrike.pak 製品 — TypeScript、単一バンドル、両マシンでバイト単位で同一 rules.ts · ラウンドの流れ、スコアリング、武器+ボットテーブル hud.tsx · HUD — Solidアプリ、Tailwindクラス QuickJS guest rquickjs経由で組み込み strike + ui サーフェス 状態スナップショット ↓ · コマンド ↑ openstrike-core — シミュレーション no_std Rust、そのまま共有 pocket3d · wgpu レンダラー Metal / Vulkan / DX12、任意の解像度あなたのラップトップ cargo run -p openstrike QuickJS、MIPS向けにコンパイルされたインタープリタのみ — このCPUではJITなし strike + ui サーフェス 同じ語彙、フィールドごとにミラーリング openstrike-core — シミュレーション 同じクレート、MIPS向けに再コンパイル pocket3d-gu · sceGu レンダラー 固定機能GE、480×272、2MB VRAM 2004 Sony PSP 単一EBOOT.PBP — エンジン、JS、マップ内 facts flow down (状態スナップショット + イベント) · intent flows up (コマンド) · guestはシミュレーションをブロックしない
ティックの順序は固定されており、内部化する価値があります。なぜなら、後続の全てがそれに依存するからです。毎秒60回:
every 16.7 ms (one vertical blank)
pad → SimInput buttons + analog stick
sim.tick(dt) movement, bots, bullets Rust
strike.__dispatch(state, events) one call into QuickJS JS
├─ rules.ts reacts queues commands
└─ hud.tsx re-renders only the bindings that changed
drain commands → core setPhase, configureWeapon… Rust
draw PVS → batches → GE
ファクトはプレーンな状態スナップショット(hp、ammo、phase、aliveBotsなど)とイベントバッチ(hit、playerDied、roundReset)として下に流れます。意図はキューイングされたコマンドとして上に流れます。JavaScriptはフレームごとに正確に1回だけ参照され、シミュレーションを遅延させることは決してありません—PocketJSがUIのために既に強制していた、フレームごとのクロスオーバー規律が、今やゲームのルールを所有しています。
1999年のジオメトリのためのバンドラー
さて、3D部分です。ゼロから始めます。
GoldSrc時代のマップ—Half-LifeとオリジナルのCounter-Strikeの背後にあるフォーマット—は、三角形のスープではありません。それはBSPファイルです。レベルのポリゴンは、バイナリ空間分割木に事前に整理されて格納されています。これは1990年代のデータ構造で、再帰的に世界を平面でスライスし、全ての位置がリーフと呼ばれる凸状のセルに入るまで続きます。このフォーマットのキラー機能はPVS—潜在的視覚セットです。各リーフについて、ファイルは、ドアを通り抜け、箱を越え、あらゆる角度から、そこからいつでも見える可能性のある他の全てのリーフの、事前に計算された圧縮ビットセットを格納します。これを計算するには、レベルデザイナーのマシンで1999年に一度、数分かかりました。消費するには、永遠にマイクロ秒かかります。
Web用語で言うと、PVSはロックファイルとしてのオクルージョンカリングです。高負荷な計算は全てオフラインで行われ、ランタイムは答えを参照するだけです。dust2の中庭に立っているとき、レンダラーはトンネルのジオメトリを全く考慮しません—「速く描画する」のではなく、決して触れません。
私たちはその1999年の精神を維持し、モダンな動きでそれを拡張しました:コンソールをデプロイターゲットとして扱い、コンパイラを前に置く。PSPはBSPファイルを解析したり、テクスチャをデコードしたり、ロード時にデータを再形成したりする余裕がありません—それは中間コピーのためのRAMと、ボットに使いたいCPUを消費します。そのため、OpenStrikeのビルドステップは、あなたのラップトップ上でpocket3d-cookを実行します。これはマップとそれに関連する.wadテクスチャアーカイブを読み込み、.p3dファイルを生成します。このファイルのバイトは、PSPのGPUが読み取る必要があるものと全く同じレイアウト、アライメント、バイトオーダーです。
de_dust2.bsp BSP v30 — GoldSrc, 1999
- .wad テクスチャアーカイブ(ゲームの自身のコピーから—マップデータは再配布されません)
pocket3d-cook ビルドタイム、ラップトップ上
· 32ユニットグリッド上のダイスの面
· ライトマップ → 頂点カラー
· 位置をi16に量子化
· pow²、バイリニアにリサンプリング
· CLUT8 + スウィズル + mip
· PVS + 衝突形状をパック
GPUのDMAエンジンが読み取るそのままのバイトレイアウト
de_dust2.p3d — 3.8 MB
WVTX 58k verts × 20 B
WIDX u16 indices
WBAT draw batches
WTEX スウィズル化されたCLUT8 + mip
WVIS PVS
WCLP 衝突形状
WENT スポーン、サン、バウンズ
ロード時の解析ゼロ、コピーゼロ
EBOOTにリンク—GPUはこれらのバイトをインプレースで読み取ります。「レベルのロード」は単一のキャッシュライトバック呼び出しです。
「ベーキング」とは、ランタイムコストをビルドタイムに移動させることを指し、クッカーは積極的にベーキングします:
- ライティングは頂点カラーにベイクされます。 GoldSrcマップはライトマップ—表面ごとのシャドウテクスチャ—を出荷します。GEはそれらをマルチテクスチャ化できましたが、各テクスチャユニットは私たちが使いたくない帯域幅を消費します。そのため、クッカーは各ポリゴンをグリッドに分割し、ライトマップを頂点のカラーチャンネルにサンプリングします。GEは三角形全体で色を無料で補間するため、太陽光、シャドウエッジ、そしてあのオレンジ色のdust2の輝きは、フレームあたり文字通り何もコストがかかりません。これはインライン化、光のためです。
- 位置は16ビット整数に量子化されます。 フロートのメモリとGPU読み取り帯域幅の半分です。(これにより、ポートのお気に入りのハードウェア考古学の断片がアンロックされました:3Dモードでは、GEはサイレントに整数頂点を正規化します—32768で割ります—これはどこにも文書化されていない動作です。対抗策は、モデルマトリックスで世界を32768でスケーリングし直すことです。エミュレータのソースコードを読むことで確認しました。このプラットフォームでは、開発者ドキュメントはソースコードのようなものです。)
- テクスチャはCLUT8になります:256色のパレットへの8ビットインデックス—RGBAの4倍小さいです。マップ全体のテクスチャセットが他の全てと一緒に収まるようになります。それらはべき乗の2のサイズ(GEのハード要件)にリサンプリングされ、スウィズル化—GPUのテクスチャキャッシュが望むタイルパターンに並べ替えられ(おおよそ「texelのための構造の配列」)、完全なミップチェーン(遠くの表面のための事前に縮小されたバージョン)が与えられます。
このビルドタイムへの執着の報酬は、私たちが持っていないロード画面です:.p3dは実行ファイルの読み取り専用データにリンクされ、GEはそれらのバイトから直接、インプレースでレンダリングします。ファイルI/Oなし、解凍なし、アップロードステップなし。ハードウェアの現実に唯一の譲歩は、ブート時の単一のキャッシュライトバック呼び出しです。なぜならGPUはCPUキャッシュの裏側にあるメモリを読み取るからです。レベルロードは即時です。なぜなら何もロードされないからです。
PocketJSを使用したことがあるなら、これはTailwindクラスをバイナリスタイルテーブルにコンパイルし、フォントをアトラスにベイクするのと同じ思想です—デバイスは決して解析せず、消費するだけ—それが3D世界全体に適用されています。
テクスチャのグロウアップ、または:マシンは何も隠さない
ポートの途中で、テクスチャが1999年にふさわしいよりも泥臭く見えることに気づき、その調査は、このハードウェアがいかに容赦なく—そしていかに読みやすいかを示す良いショーケースとなりました。3つの独立した原因があり、全てパイプラインの上にあります:
[画像: Before/after crop of the same crate on PSP: left, the coarse bake — muddy planks and smeared bricks; right, the refined bake — distinct planks, the X-brace reads clearly, brick courses resolve]
同じクレート、変更前と変更後、PSPフレームバッファの3倍クロップ。左:最近傍補間、切り捨てサイズ、デフォルトのミップ選択。右:バイリニアパレット対応補間、切り上げサイズ、−1.0ミップバイアス、および2倍密度のライトグリッド。
第一に、べき乗の2でないテクスチャ(例えば96×96のクレート面)は、目に見えて不規則なリズムでテクセル列を複製する最近傍補間を使用してGPU互換サイズに引き伸ばされていました。修正はバイリニア補間ですが、パレットを介します:RGBでサンプリングし、各結果をテクスチャ自身の256色に再量子化します。第二に、サイズポリシーは最も近いべき乗の2に丸められたため、320幅のテクスチャは256にドロップしてネイティブディテールを失いました。今では常に切り上げられます(GEの天井は512です)。第三に、GEには異方性フィルタリングがなく、その自動ミップ選択は、テクセル密度が要求するずっと前に、斜めの角度での床でぼやけます—−1.0のLODバイアスは、シャープなミップをもう1つの距離リング長く保持します。これはPSP時代の全ての出荷ゲームが静かに行ったトレードオフです。そして、私たちがそこにいた間、ライトベイクグリッドは96ワールドユニットから32に締められました—他の全てのライトマップサンプル—そのため、ベイクされたシャドウエッジは元の場所に戻ります。Dust2は26kから58k頂点になり、マップは0.9MB増加しましたが、次のセクションが示すように、予算は微動だにせず吸収されました。
16.7ミリ秒の戦い
60 FPSでは、1フレームは16.7msです—上記全ては、解釈実行されるJavaScriptを実行する333MHzコア上で、その中に収まる必要があります。これが、砂埃が落ち着いた後のポートの状況です。dust2のスクリプト化されたツアーを物理的なハンドヘルドで測定しました:
one frame at 60 fps 16.67 ms
JS ~2.2 ms
sim + bots + draw recording headroom — roughly half the frame
avg work: 6.8–8.4 ms
worst frame observed: 9.7 ms
GE (GPU) command time: <0.03 ms — PVS means it is only ever handed what the camera can see, preformatted.
快適な余地—しかし、2つの戦いの後であり、2番目の戦いはこのプロジェクトがJavaScript開発者に言える最も有用なことです。
最初の戦いは、私たちが勝つべきものではありませんでした。 最初のハードウェア実行は25 FPSで、プロファイリングしても全く説明できませんでした。なぜならコードは無実だったからです:開発ハーネスはコンソールを222MHzでブートし、リテール速度—333MHz—は1つのシステムコールで到達できます。教訓は一般化します:遅い組み込みターゲットを最適化する前に、それが実際にどのクロックで実行されているかを確認してください。
2番目の戦い:細粒度が細粒度を意味する。 HUDは当初、Solidに毎ティックの状態スナップショットを1つのシグナルでミラーリングしていました:
// before: one signal carries the whole snapshot —
// a fresh object every tick, so *every* binding re-runs, every frame
const [st, setSt] = createSignal(snapshot());
onState((s) => setSt({ ...s }));
// after: one signal per field, equality-gated —
// an unchanged hp/ammo/phase costs nothing
const [hp, setHp] = createSignal(100);
const [ammo, setAmmo] = createSignal(30);
onState((s) => { setHp(s.hp); setAmmo(s.ammo); /* ... */ });
デスクトップでは、この違いに全く気づかないでしょう。JITがそれを吸収します。333MHzのインタープリタでは、全スナップショットバージョンはフレームあたり20.6msのJavaScriptを消費しました—1つの三角形を描画する前に予算オーバーです—なぜなら新しいオブジェクトIDはフィールドが変更されたかどうかに関わらず全てのバインディングを再トリガーするからです。フィールドごとに等価性ゲーティングで分割すると、同じHUDは2.2msに削減されました。Solidのリアクティビティモデルはこのスケールでは好みではありません。それは、JSX HUDがここで可能である理由です。レンダラーの描画出力は変更前と後でバイト単位で同一でした。これは、私たちがその変更を恐れることなく行うことができた理由でもあります—それについては後述します。
メモリも、野心ではなく契約の同じ物語を語っています。JSエンジンのヒープは、同じ監査済み予算の中にあります:
PSP user RAM 24.0 MB
├─ executable (engine + QuickJS + JS bundle
│ + the entire cooked map) 6.2 MB
├─ arena high-water (QuickJS heap, engine
│ state, per-frame vertex pool) ~4.4 MB
└─ free ~13 MB
VRAM: framebuffers + depth 1.4 / 2 MB
決定論はデバッガーである
コンソールもデバッガUIもなく、画面共有もできないマシンをどのようにデバッグしますか?プログラムを純粋関数にし、ビルドタイムでレバレッジを置きます—クッカーと同じ賭けを、振る舞いに適用します。
OpenStrikeはPocketJSのクローズドワールドルールを継承しています:固定された1/60秒のタイムステップ、ウォールクロックなし、シード付き乱数、そしてボタンビットマスクと2つのアナログバイトだけのフレームごとの入力。フレームNは入力スクリプトの純粋関数です—そのため、スクリプト化された実行は、信頼性の高いエグゼキュータであれば、バイト単位で同一のフレームバッファを生成します。私たちのCIは、PPSSPPエミュレータの決定論的なソフトウェアレンダラーで実際のリリースEBOOTをブートし、スクリプト化された入力を駆動し、ダンプされたフレームをバイト単位でゴールデンPNGと比較します。上記のテクスチャ修正が適用されたとき、ゴールデンはどのピクセルが変更されたかを正確に示しました。リベースライン化は1つのコマンドでした。60 FPSという数字は、同じハーネスをUSBケーブル経由で実際のハンドヘルドに向け、フレームごとのタイミングをデスクにストリーミングすることから来ています。
[画像: Firing on PSP: the muzzle flash blooms over a crate, ammo reads 28/90 on the HUD, sunlit cliffs through the archway to the left]
スクリプト化された入力テープのフレーム507—バイト単位で再現可能であり、それがCI証拠であり、ブログのイラストでもある理由です。
そして、HUDがPocketJSアプリであるため、DevToolsのストーリー全体が変更なしで引き継がれます:コンポーネントインスペクタはハンドヘルドの物理画面上のノードをハイライトし、console.logはフレーム番号付きでデバイスからストリーミングされ、一時停止/ステップはボットを歩行中に凍結させます—全て同じケーブル経由です。
これが実際に証明すること
Pocketランタイムファミリーのテーゼは、製品—ゲームプレイのルール、UI、チューニング—はポータブルなJavaScriptアーティファクトであるべきであり、エンジンはネイティブで小さく、交換可能であるべきだということです。OpenStrikeは、そのテーゼのフルサイズのテストをハードウェアのギャップを越えて初めて行ったものです:同じopenstrike.jsが、バイト単位で、マルチコアラップトップ上のwgpuと、32MBのハンドヘルド上の固定機能GPUに対して実行され、ゲームはそれを区別できません。
[画像: The desktop build of OpenStrike on de_dust2 at high resolution — two bots advancing past green ammo crates, the same HUD in the corners]
デスクトップビルド:同じrules.ts、同じhud.tsx、同じクレート—ピクセル数は11倍、ピクセルごとのライトマップもあります。なぜなら、そのエンジンができるからです。
このパターンの何ものもPSP固有ではありません。コンソールは、PocketJSを紹介したときに言ったように、正直な審判です:怠惰なアーキテクチャを静かに吸収しないマシンです。TypeScriptでその頭脳を持つFPSがそこで60 FPSを維持することは、存在証明です。それよりも余裕のあるものは全て下り坂です。
プレイする
- pocket-nexus/open-strike — MIT。デスクトップビルドは
cargo run -p openstrikeで実行できます。READMEには、PSP EBOOT、ハードウェアベンチ、エミュレータのゴールデンについて説明されています。 - マップデータはValveのもので、リポジトリには含まれていません—ビルドをゲームの
.bsp/.wadファイルの自身のコピーに向けます。GoldSrc時代のマップならどれでも動作します。CSの8つのクラシックマップがテストセットです。 - PSPがない? PPSSPPはEBOOTを美しく実行します。実際のハードウェアにはカスタムファームウェアとPSPLINKが必要です—私たちのDevToolsが使用するのと同じケーブルです。
- docs/RUNTIMES.md — OpenStrikeがインスタンス化するランタイムファミリーアーキテクチャ。図の背後にあるオントロジーを知りたい場合。
次の情報については@pocket_jsをフォローしてください。ポケットは深まり続けています。