はじめに

SKYWARDは、ローカルのExpress/Viteプロセスからゲームを配信します。

前提

• Node.js 22.12以上。プロジェクトの検証済みバージョンはNode.js 24です。
• 3D表示に対応したデスクトップブラウザとWebGL。
• JEV LIVE を使う場合だけAPIキーが必要です。ローカルプレイには不要です。

ローカル起動

git clone https://github.com/Sunwood-ai-labs/jev-flight-combat.git
cd jev-flight-combat
npm ci
npm run dev

http://127.0.0.1:4173/ を開きます。初期状態はキー不要のローカル操縦です。手動 はキーボード操作、JEV LIVE はサーバー設定後に選びます。

JEVを使う場合

.env.exampleを参考にプロジェクト直下の .env を作り、AI_GATEWAY_API_KEY を設定します。サーバーはプロジェクトの .env を優先し、キーをブラウザへ送信しません。

npm run flight:jev -- --max-calls=30 --frames-per-decision=30

ヘッドレスコマンドは上限付きの検証リプレイで、artifacts/ にJSONを保存します。ブラウザの実時間飛行とは別の記録です。

確認

npm test
npm run build

キーを使わずに試すときは静的デモを使えます。手動操縦とローカルAIだけで、ブラウザからJEV APIへ接続することはありません。