FPSゲームをAIで超簡単につくる方法【バイブコーディング入門&初心者向け】

Youtubeでも紹介しています
>> イラスト55 @ クリエイティブ情報を紹介

使用したツールとプログラムは次のリンクからダウンロード&プレイできます
ブラウザゲームとAIのゲームプログラムとゲーム制作ツールの無料配布ページ

HTML1ファイルだけで動作する、Project Warlock系のFPSプロトタイプを作ってください。

目的は完成品ではなく、まずワイヤーフレーム状態で 「3D舞台+2D敵+2D銃」 という構成が成立するか確認することです。

【必須条件】

・HTML1ファイルのみで動作 ・外部サーバー不要 ・Three.js使用可 ・PCブラウザ向け ・一人称視点FPS ・マウスで視点移動 ・WASDで移動
・Shiftで少し高速移動 ・壁をすり抜けない ・ESCでマウスロック解除

【舞台】

舞台はすべて簡易3D形状で構成してください。

・床 ・壁 ・天井 ・通路 ・小部屋

現段階ではテクスチャを使用せず、 床・壁・天井は色の違う単純な面または箱で表現してください。

見た目は完全なワイヤーフレームだけでなく、 形状が把握しやすい簡易グレーBOX表示にしてください。

必要であればワイヤーフレーム表示ON/OFFも付けてください。

【マップ構成】

マップはコード内の2次元配列またはJSONデータから生成してください。

例

0 = 空間 1 = 壁 2 = 敵 3 = アイテム 4 = 出入口

というように、後から簡単に編集できる構造にしてください。

マップ生成処理とFPS処理はできるだけ分離してください。

【敵】

敵は3Dモデルを使用しません。

2Dの板ポリゴンまたはSpriteを使用し、 常にプレイヤー方向を向くBillboard方式にしてください。

現段階では画像は不要です。

敵は色付きの四角形または簡単な人型シルエットで表示してください。

敵には最低限以下を実装してください。

・待機 ・プレイヤー発見 ・接近 ・攻撃 ・HP ・死亡

ただしAIは単純で構いません。

以下の仕様は実装すること 敵はゲーム開始後3秒間は攻撃してこない 敵は壁を貫通して移動できない

【銃】

銃は3Dモデルではなく、 画面下部中央に固定された2D表示にしてください。

現段階では画像を使わず、 単純な図形で銃の位置を表現してください。

左クリックで射撃。

射撃はRaycast方式で構いません。

敵に命中するとHPが減るようにしてください。

【HUD】

最低限、

・HP ・弾数 ・照準 ・FPS表示

を表示してください。

【プロトタイプ確認用UI】

画面右上などに小さなデバッグUIを作ってください。

以下をON/OFFできるようにしてください。

・ワイヤーフレーム表示 ・敵AI ・当たり判定表示 ・FPS表示

また、

「敵追加」 「敵全削除」 「プレイヤー位置リセット」

のボタンも付けてください。

【重要】

今回は見た目を作り込まないでください。

目的は以下の確認です。

・3D舞台をプログラムで生成できるか ・FPSとして移動しやすいか ・2D敵が3D空間で違和感なく見えるか ・2D銃表示が成立するか
・Raycast射撃が成立するか ・将来的にテクスチャを貼る構造へ発展できるか

コードは後から拡張しやすいようにしてください。

特に、

マップ生成 プレイヤー制御 敵AI 射撃 UI

を可能な範囲で関数・クラス単位に分けてください。

既存コードがある場合でも無関係な部分は勝手に削除しないでください。

まずは「遊べる簡易FPSプロトタイプ」として完成させてください。
添付した「FPS v3 バグ修正.html」をベースに改修してください。

HTML1ファイル構成を維持してください。

今回は以下の4機能を追加してください。

・ランダムマップ生成 ・マップテクスチャ設定 ・敵アニメーション ・武器アニメーション

既存機能は削除せず、現在正常に動作している敵AI、当たり判定、画像ライブラリ、保存・読込などを壊さないでください。

==================

1.  「マップ」タブを追加 ==================

現在の右メニュー

画像 プレイヤー 敵設定 設定

を

画像 プレイヤー 敵設定 マップ 設定

の5タブにしてください。

【マップタブ】

以下を配置してください。

■ ランダムマップ設定

・マップ横サイズ ・マップ縦サイズ ・壁密度 ・敵配置数

・「ランダムマップ生成」ボタン

「ランダムマップ生成」を押すと、新しいマップデータを自動生成し、その場で3Dマップを再構築してください。

単純に各マスを完全ランダムで壁にするだけではなく、プレイヤーが移動可能なマップになるようにしてください。

最低限、以下を保証してください。

・外周は必ず壁 ・プレイヤー開始地点を1か所生成 ・開始地点が壁の中にならない ・開始地点から移動可能な空間を確保する ・敵は壁の中に配置しない
・敵はプレイヤー開始地点と重ならない ・敵配置地点へプレイヤーが到達可能であること
・孤立した完全に到達不能なエリアを極力作らない

迷路生成方式など、到達可能性を保証しやすい方式を使用して構いません。

生成結果は現在のMAP_DATA相当の2次元配列として管理してください。

【マップ再生成時の重要事項】

現在表示されているマップを正しく破棄してから新しいマップを生成してください。

再生成前に、

・既存の壁Mesh ・床Mesh ・天井Mesh ・wallBoxes ・wallMeshes ・enemySpawnPoints ・現在配置されている敵
・敵のProjectile

など、古いマップに依存する情報を正しく初期化してください。

再生成後に、

・古い壁が残る ・透明な当たり判定が残る ・床や天井が二重になる ・古い敵が残る ・古い敵スポーン地点が残る

といった状態が発生しないようにしてください。

================== 2. マップテクスチャ ==================

マップタブに、

・壁テクスチャ ・床テクスチャ ・天井テクスチャ

の設定欄を追加してください。

画像タブの「画像ライブラリ」に登録されている画像から選択できるようにしてください。

「適用」ボタンを用意してください。

選択した画像をそれぞれ

壁 床 天井

のThree.jsマテリアルへ適用してください。

画像未指定の場合は、現在のデフォルト色を使用してください。

テクスチャは必要に応じてRepeatWrappingを使用し、不自然に1枚の巨大画像が引き伸ばされる状態を避けてください。

既存のAssetManagerの画像・Texture管理を利用してください。

AssetManagerが所有している共有Textureを、MapGenerator側からdisposeしないでください。

================== 3. 敵アニメーション ==================

現在の「敵設定」タブを拡張してください。

敵1種類につき画像1枚だけではなく、状態ごとの画像を登録できるようにしてください。

【登録できる画像】

・待機画像 ・移動画像 ・攻撃画像 ・被弾画像 ・死亡画像

すべて画像ライブラリに登録されている画像から選択してください。

未指定の状態については、

「待機画像を代用」

するようにしてください。

つまり、5種類すべて用意しなくても敵を作れるようにしてください。

【敵状態との連動】

現在のEnemyの状態に合わせて表示画像を自動変更してください。

idle → 待機画像

chase → 移動画像

attack → 攻撃画像

takeDamage時 → 被弾画像を短時間表示

dead → 死亡画像

被弾画像は一時的に表示し、その後現在のAI状態に対応する画像へ戻してください。

死亡後は死亡画像を表示したままにしてください。

【重要】

今回は本格的なスプライトシート再生機能までは必要ありません。

まずは

状態ごとに1枚の画像を切り替える方式

にしてください。

将来的に複数フレームアニメーションへ拡張しやすいデータ構造にしてください。

既存の

・近接 ・遠距離 ・突進

の攻撃パターンは維持してください。

敵AIのロジック自体は変更しないでください。

================== 4. 武器アニメーション ==================

現在の「プレイヤー」タブを拡張してください。

左手と右手それぞれについて、

・通常画像 ・発射画像

を画像ライブラリから設定できるようにしてください。

例:

右手

通常画像:gun_idle.png 発射画像:gun_fire.png

通常時は通常画像を表示してください。

射撃した瞬間だけ発射画像へ変更し、短時間後に通常画像へ戻してください。

現在存在する射撃時の武器移動アニメーションも残してください。

つまり射撃時には、

通常画像 ↓ 発射画像 + 現在の反動アニメーション ↓ 通常画像

となるようにしてください。

左手についても同じ仕組みにしてください。

「なし」を選択した場合は現在と同じように非表示にしてください。

発射画像が設定されていない場合は通常画像のまま反動アニメーションだけ実行してください。

現在の

・弾薬 ・fireRate ・Raycast ・敵へのダメージ ・左右武器表示

などの射撃ロジックは変更しないでください。

================== 5. 保存・読込 ==================

JSON保存対象へ今回追加した情報も含めてください。

保存するもの:

・現在のランダムマップデータ ・マップサイズ ・壁密度 ・敵配置数 ・壁テクスチャ ・床テクスチャ ・天井テクスチャ ・敵タイプごとの状態画像設定
・左右武器の通常画像 ・左右武器の発射画像

JSONを読み込んだ場合は、保存時と同じマップ・テクスチャ・敵設定・武器設定を復元してください。

既存の保存データとの互換性も可能な範囲で維持してください。

古いJSONに新しい項目が存在しない場合はデフォルト値を使用し、エラーで停止しないようにしてください。

================== 6. UIについて ==================

現在のレトロFPS風デザインを維持してください。

右メニューの開閉方式も変更しないでください。

タブが5個になるため、タブ名が潰れたり重なったりしないようにしてください。

必要ならタブ文字を少し小さくしてください。

画像選択には既存の画像ライブラリを利用し、同じ画像を何度もアップロードさせる設計にはしないでください。

================== 重要な制約 ==================

・HTML1ファイルを維持する ・既存機能を削除しない ・既存UIを必要以上に変更しない ・既存の敵AIを壊さない ・プレイヤー操作を壊さない
・当たり判定を壊さない ・射撃Raycastを壊さない ・画像ライブラリをそのまま利用する
・Texture管理はAssetManager中心とする ・共有Textureを誤ってdisposeしない ・JSON保存・読込を壊さない
・マップ再生成を何度行っても古いMeshや当たり判定が残らないようにする ・機能追加後も既存のデバッグ機能を使用できるようにする

完成後はコードの一部分だけではなく、修正済みHTMLファイル全体を出力してください。

FPSゲームのドット絵のピクセルスプライトシート 
//正面画のみ、他方向は不要  
//2足歩行の骸骨魔導士のモンスター 
//右手に魔法の杖をもっている
//正面に向かって歩いている(9コマ)
//魔法攻撃の右手を上げる(5コマ) 
//ペルソナのゲームにインスパイアされた
//文字、枠、はいれない
//上記のモーション
//エフェクトは入れない
//各モーションに対応するフレームがあること
//純白背景


FPSゲームのドット絵のピクセルスプライトシート 
//正面画のみ、他方向は不要  
//デビル風海賊船の船員
//右手にナイフをもっている
//正面に向かって歩いている(9コマ)
//ナイフで攻撃(5コマ) 
//ペルソナのゲームにインスパイアされた
//文字、枠、はいれない
//上記のモーション
//エフェクトは入れない
//各モーションに対応するフレームがあること
//純白背景

肌を白人っぽく グローブを西部劇のような 銃を金色にしてビンテージの立派な銃 画面の端から腕が出ているのではなく、下から腕をだすこと 両腕は通常のFPSと同様に離れている FPSの素材ということを考慮して生成すること

FPSのピクセルドット画像の生成
青色ベースのサイバーパンク風の壁テクスチャ
現代の壊れかかったビルの地下通路




真横から見た画像であること  

FPSゲームのドット絵のピクセルスプライトシート
//正面画のみ、他方向は不要
//2足歩行の闇のゴースト魔導士のモンスター
//正面に向かって歩いている(9コマ)
//魔法攻撃の両手を上げる(5コマ)
//ペルソナのゲームにインスパイアされた
//文字、枠、はいれない
//上記のモーション
//エフェクトは入れない
//各モーションに対応するフレームがあること
//純白背景

添付した Fps v4_mapfix(1).html を直接解析したうえで改修してください。

新規に別のFPSを作り直すのではなく、現在のコードをベースとして拡張してください。

今回の改修は、

1.  既知バグの修正
2.  プレイヤー武器アニメーション改善
3.  敵アニメーション簡略化
4.  Tracer / 着弾エフェクト
5.  敵のファイヤー / エネルギー攻撃
6.  法線マップ自動生成
7.  JSON保存・復元対応

までを含みます。

1. 最重要方針

今回もっとも重要なのは、

高機能化よりも、設定完了までの時間を短くすること

です。

設定できる項目を大量に増やさないでください。

プログラム側で自動判断できるものは、可能な限り自動化してください。

ユーザーに、

  - Loop設定
  - フレームイベント設定
  - Normal Map画像の管理
  - idle / hurt / dead画像の個別登録
  - 発射タイミングの細かい指定
  - Normal MapのX/Y反転
  - Blur
  - フレームごとのイベント設定

などを毎回させないでください。

理想は、

敵1種類、武器1種類を数十秒~1分程度で設定できること

です。

2. 既存機能を維持する

以下の既存機能を削除しないでください。

  - ランダムマップ生成
  - 壁・床・天井
  - InstancedMeshによる床・天井
  - 壁衝突判定
  - プレイヤー移動
  - 敵AI
  - 近接攻撃
  - 遠距離攻撃
  - 突進
  - 敵スポーン
  - 画像ライブラリ
  - 武器表示
  - Raycast射撃
  - HUD
  - JSON保存
  - JSON読み込み
  - ワイヤーフレーム
  - Hitbox
  - サイドバー
  - 各タブ
  - Pointer Lock
  - マップテクスチャ
  - 敵配置数設定

現在正常に動いている処理を壊さないようにしてください。

3. 発見済みバグの修正【必須】

機能追加より前に、以下の既知バグ・問題を必ず修正してください。

「確認したが問題なし」と省略せず、現在コードを実際に追跡して修正してください。

3-1. 画像テクスチャ読込

AssetManager.addImage() では、

Imageのloadイベントを設定してから img.src を代入してください。

現在のような、

img.src = dataUrl ↓ img.onload = ...

という順番にはしないでください。

Data URLやキャッシュ画像でもThree.js Textureが確実に更新されるようにしてください。

3-2. Pointer Lock終了時のカーソル消失

Chrome / Edgeで、

ゲーム開始 ↓ Pointer Lockでカーソル非表示 ↓ その状態でページ・タブ・ウィンドウを閉じる ↓ 別タブでもカーソルが見えなくなる

問題が実際に発生しているため修正してください。

pointerlockchange だけに依存せず、

  - pagehide
  - beforeunload
  - visibilitychange
  - blur
  - pointerlockerror

など適切な終了経路でPointer Lock解除・カーソル復旧を行ってください。

document.body.style.cursor = 'auto' などもフォールバックとして使用してください。

3-3. マウス視点操作の引っ掛かり

現在の mousemove 内で毎回Camera Quaternionを直接更新する方式を改善してください。

movementX / movementY を一時蓄積し、

Gameの requestAnimationFrame 側で1フレームに1回まとめて視点へ適用してください。

可能なブラウザでは、

requestPointerLock({ unadjustedMovement: true })

を試してください。

非対応の場合は通常Pointer Lockへ自動フォールバックしてください。

マウス感度設定も追加・維持してください。

不要なスムージングは追加しないでください。

3-4. 敵配置数0

敵配置数を0に設定した場合、本当に0体で生成してください。

0をfalse扱いしてデフォルト4体へ戻してはいけません。

現在存在する Number.isFinite() を使用した処理を壊さないでください。

3-5. マップ再生成時の残留物

ランダムマップを再生成するとき、

  - 敵
  - Projectile
  - Tracer
  - 着弾エフェクト
  - 火花
  - 煙
  - 弾痕
  - ファイヤー攻撃
  - エネルギー攻撃

など旧マップに属する一時オブジェクトを完全にクリアしてください。

古いエフェクトが新しいマップへ残らないようにしてください。

3-6. 複数画像化後の画像削除

敵・武器アニメーションが複数画像配列になるため、

単一imageIdだけを確認する削除判定では不十分です。

frames配列のどこかで使用されている画像は削除できないようにしてください。

3-7. プレイヤー着弾Raycast

射撃Raycastの対象を、

  - 敵Hitbox
  - 壁
  - 床
  - 天井

にしてください。

床・天井はInstancedMeshであるため、

着弾地点の面法線を正しくワールド座標へ変換してから着弾エフェクトへ渡してください。

これにより、

壁 床 天井

すべてに正しい方向で、

  - 火花
  - 煙
  - 弾痕

を表示してください。

3-8. 壁際移動

現在の、

  - 円形XZ衝突判定
  - X / Z分離移動
  - 移動量分割

を維持してください。

以前発生していた壁角での引っ掛かりや大きな巻き戻りを再発させないでください。

3-9. Z-fighting

床・天井を壁セルへ生成しない現在の仕様を維持してください。

壁下面・上面と床・天井が完全同一平面になってZ-fightingする問題を再発させないでください。

3-10. テクスチャ表示再発防止

マップテクスチャの読み込み・適用処理を変更した場合でも、

  - 壁
  - 床
  - 天井

の既存テクスチャ表示を壊さないでください。

4. プレイヤータブを簡略化する

現在は左右それぞれ、

  - 通常画像1枚
  - 発射画像1枚

という構造です。

これを複数画像アニメーション対応に変更します。

ただしUIを複雑化しないでください。

右手武器

基本UI:

  - 通常アニメーション画像
  - 発射アニメーション画像
  - X位置
  - Y位置
  - Scale

左手武器

  - 使用する ON/OFF
  - 通常アニメーション画像
  - 発射アニメーション画像
  - X位置
  - Y位置
  - Scale

必要なら左右同期を追加して構いません。

5. 武器画像は画像ライブラリから複数選択

新しくPCから毎回ファイルを読み込ませるのではありません。

既存の画像ライブラリを利用してください。

例えば、

「通常画像を追加」

または

「発射画像を追加」

を押すと画像ライブラリが開き、

複数の登録済み画像を選択できるようにします。

例:

gun_001.png gun_002.png gun_003.png gun_004.png

を選択した場合、

001 → 002 → 003 → 004

の順番で自動再生してください。

ファイル名は自然順ソートしてください。

1枚なら静止画。

複数枚ならアニメーションです。

6. 武器アニメーション動作

通常

通常画像が1枚の場合:

静止表示。

複数枚の場合:

自動ループ。

発射

発射画像が複数の場合:

左クリック時に1回再生。

最後まで再生したら自動的に通常画像へ戻す。

ユーザーにLoop ON/OFFを設定させないでください。

内部で、

通常 = loop 発射 = one-shot

と自動設定してください。

7. 固定CSS反動を廃止

現在、

.weapon-left.firing

.weapon-right.firing

によって、

translateY rotate scale

を固定適用しています。

この固定反動は廃止してください。

武器画像そのものの差分アニメーションを邪魔するためです。

発射アニメーション画像によって反動を表現します。

8. フレームごとの複雑な編集は通常UIに出さない

以前検討していた、

  - 各フレームX
  - 各フレームY
  - 各フレームScale
  - Rotation
  - Duration
  - 発射イベント
  - muzzleイベント
  - tracerイベント

などは、

今回の通常UIには出さないでください。

まずは画像差分だけでアニメーションを作れるようにします。

内部構造は将来拡張可能にして構いません。

9. プレイヤー武器のマズルフラッシュ

プレイヤー武器の発射画像そのものに、

すでにマズルフラッシュが描かれている

ことを前提とします。

そのため、

  - 追加のマズルフラッシュ画像
  - Muzzle X
  - Muzzle Y
  - マズルサイズ
  - マズル寿命

などをプレイヤータブへ追加しないでください。

武器画像そのものを使用します。

10. プレイヤーTracer

プレイヤー射撃の命中判定は、

現在のRaycast方式を維持してください。

実弾オブジェクトを大量生成しません。

構造:

Raycast

当たり判定

Tracer

見た目

と分離します。

Tracerは、

画面中央の射線付近から、

Raycast命中地点または最大射程方向へ、

非常に短時間表示される細い発光線として描画してください。

通常UIでは、

  - Tracer ON/OFF
  - 表示率

程度で十分です。

太さ、寿命、明るさなどは適切な固定値にしてください。

設定項目を増やしすぎないでください。

11. プレイヤー着弾エフェクト

壁、床、天井へ命中した場合、

  - 短い着弾フラッシュ
  - 火花
  - 少量の煙
  - 弾痕

を表示してください。

敵に命中した場合は壁用弾痕を出さないでください。

床・天井でも面の向きを取得して正しく表示してください。

大量のオブジェクトを残さないでください。

弾痕は上限数を設け、

古いものから削除してください。

12. 敵タブを大幅簡略化

現在存在する、

  - idle
  - chase
  - attack
  - hurt
  - dead

の5種類の画像設定欄を廃止してください。

通常ユーザーが設定する敵アニメーションは、

歩き 攻撃

の2種類だけにします。

UI:

敵の名前

攻撃パターン

HP

移動速度

歩きアニメーション [画像ライブラリから追加]

攻撃アニメーション [画像ライブラリから追加]

アニメーション速度

遠距離攻撃エフェクト

[敵タイプを登録]

程度にしてください。

13. 敵の歩きアニメーション

歩き画像は画像ライブラリから複数選択。

例:

walk_001.png walk_002.png walk_003.png walk_004.png

なら4フレームアニメーション。

自然順ソート。

敵が移動している間は自動ループします。

敵が停止している場合

idle画像を別途設定しません。

敵が停止した場合は、

歩きアニメーションの先頭フレーム

を静止表示してください。

これによりidle設定を不要にします。

14. 敵の攻撃アニメーション

攻撃画像も画像ライブラリから複数選択。

攻撃時に1回再生。

終了後、

歩きアニメーションまたは歩き先頭画像へ戻します。

Loop設定をユーザーにさせないでください。

自動的にone-shotとします。

15. hurt / dead画像設定は廃止

今回は、

hurt

dead

のアニメーション登録欄は不要です。

被弾

既存の短時間の色変化など、簡易フィードバックで構いません。

死亡

現在の死亡処理を維持してください。

死亡アニメーション追加は将来機能とします。

設定項目を増やさないことを優先します。

16. 敵遠距離攻撃エフェクト

敵登録UIに、

「遠距離攻撃エフェクト」

を追加してください。

選択肢:

  - 通常
  - ファイヤー
  - エネルギー

の3種類。

サンダーは今回入れません。

17. 通常遠距離攻撃

現在のProjectile方式を残してください。

既存の単純なProjectileを、

「通常」

として使用します。

既存機能との互換性を維持するため削除しません。

18. ファイヤー攻撃

Three.js上で実装してください。

見た目は、

敵 ↓ 火球生成 ↓ プレイヤー方向へ飛翔 ↓ 着弾 ↓ 爆発

とします。

火球は、

  - 高輝度の中心
  - オレンジ~赤の外周発光
  - 飛翔中の小さな炎粒子
  - 短い残光

を持たせます。

着弾時は、

  - 強い短時間フラッシュ
  - オレンジ系火花
  - 少量煙
  - 円形の衝撃波

を発生させます。

以前作成したThree.jsエフェクトサンプルのファイヤー表現を参考にしてください。

ただし大量のGeometry / Materialを毎フレーム生成し続けないようにしてください。

19. エネルギー攻撃

Three.js上で実装してください。

構造:

敵 ↓ 短いチャージ ↓ エネルギー弾発射 ↓ 残光 ↓ 着弾 ↓ 衝撃波

チャージ時には、

  - 中心発光
  - 周囲を回転する小さいエネルギー粒子

を表示。

飛翔時には、

  - 白~青緑の中心
  - 紫~青の外周
  - 短い残光

を表示。

着弾時には、

  - 強い発光
  - 粒子
  - 二重程度の衝撃波

を表示してください。

20. 敵攻撃とダメージ処理を分離

エフェクトの見た目とゲーム判定を密結合させすぎないでください。

例えば、

enemy.executeAttack()

↓ attackEffect = fire

↓ EffectManager.spawnFire(...)

という構造にしてください。

既存のEnemy AIそのものを全面的に作り直さないでください。

21. EffectManagerを導入

今回追加する、

  - Tracer
  - 着弾
  - 火花
  - 煙
  - 弾痕
  - ファイヤー
  - エネルギー

を一元管理できる EffectManager を追加してください。

Gameの animate() から、

effectManager.update(dt)

を毎フレーム呼び出してください。

マップ再生成時は、

effectManager.clear()

で残留物を完全除去してください。

22. 法線マップを自動化

現在の壁・床・天井テクスチャ設定を維持します。

ただし各テクスチャの近くに、

「凹凸効果を追加」

または

「法線マップ自動適用」

ボタンを追加してください。

重要:

ユーザーにNormal Map画像を読み込ませません。

Normal Map画像の選択欄も作りません。

Normal Mapプレビューも不要です。

23. 法線マップ内部処理

例えば壁画像を設定後、

[凹凸効果を追加]

を押したら、

カラー画像 ↓ Canvas ↓ グレースケール ↓ 周囲ピクセル明度差 ↓ XYZ法線へ変換 ↓
THREE.CanvasTextureまたはTHREE.Texture ↓ material.normalMap

まで内部で自動処理してください。

ユーザーは生成画像を管理しません。

床・天井も同じです。

24. マテリアル

Normal Mapを使えるように、

必要に応じて、

MeshLambertMaterial

から

MeshStandardMaterial

へ変更してください。

ただし、

  - 従来テクスチャ
  - InstancedMesh床
  - InstancedMesh天井
  - 壁表示

を壊さないでください。

Normal Map未使用時も従来と同等に表示してください。

25. 法線設定UI

通常UIには、

壁画像 [画像]

[凹凸効果を追加]

床画像 [画像]

[凹凸効果を追加]

天井画像 [画像]

[凹凸効果を追加]

程度で十分です。

強度を入れる場合でも、

1本の簡単なスライダー程度にしてください。

X反転、Y反転、Blur、Normal画像選択などの高度設定は通常画面へ出さないでください。

26. 共通フレームアニメーション処理

敵と武器で、

完全に別々のフレーム再生ロジックをコピーして作らないでください。

内部では共通の軽量な AnimationClip / FrameAnimator を使用してください。

例えば、

AnimationClip { frames: [imageId, imageId, imageId...], fps: 10, loop: true }

程度で構いません。

今回、

フレームごとの細かい位置情報やイベントは必須ではありません。

重要なのは、

複数画像を渡せば自動で順番に表示できること

です。

27. アニメーション速度

敵:

  - 歩き速度
  - 攻撃速度

武器:

  - 通常速度
  - 発射速度

を変更できるようにしても構いません。

ただしUIを増やしすぎないでください。

可能なら、

「アニメーション速度」

1つの値で十分です。

28. 画像削除判定を更新

現在の画像ライブラリでは、

使用中の画像を削除できないようチェックしています。

複数画像アニメーション対応後は、

単一ID比較だけでは不十分です。

武器や敵の、

frames配列

の中に画像IDが存在するか確認してください。

使用中なら削除させないでください。

29. JSON保存

今回追加する内容はJSON保存対象にしてください。

最低限、

武器

  - 左右ON/OFF
  - 通常フレーム画像ID配列
  - 発射フレーム画像ID配列
  - X
  - Y
  - Scale
  - アニメーション速度
  - Tracer ON/OFF
  - Tracer表示率

敵

  - 歩きフレーム画像ID配列
  - 攻撃フレーム画像ID配列
  - アニメーション速度
  - 遠距離攻撃エフェクト種類

マップ

  - 壁画像
  - 床画像
  - 天井画像
  - 壁Normal ON/OFF
  - 床Normal ON/OFF
  - 天井Normal ON/OFF

を保存してください。

30. Normal Map自体は保存不要

Normal Mapは元画像から再生成できるため、

巨大なBase64 Normal画像をJSONへ保存する必要はありません。

保存するのは、

normalEnabled: true

などの設定だけで構いません。

JSON読み込み時に自動再生成してください。

31. 旧JSON互換

現在の、

weapons.left.idle

weapons.left.fire

weapons.right.idle

weapons.right.fire

や、

enemyTypes.images.idle

enemyTypes.images.chase

enemyTypes.images.attack

などの旧データを読み込んでもエラーにしないでください。

旧データの場合は、

単一画像ID ↓ frames配列1枚

へ自動変換してください。

例:

idle: "img_123"

なら、

frames: ["img_123"]

として扱います。

32. パフォーマンス

エフェクト実装では特に注意してください。

毎フレーム大量に、

new SphereGeometry

new Material

new Texture

を生成しないでください。

可能な範囲で、

  - Geometry共有
  - Material共有
  - Object Pool
  - Sprite再利用

を使用してください。

エフェクト終了後は適切に非表示または再利用してください。

どうしてもdisposeする必要がある一時リソースはdisposeしてください。

33. UIで絶対に避けること

以下のようなUIにしないでください。

敵

idle画像 chase画像 attack画像 hurt画像 dead画像

をすべて設定させる。

Normal Map

Normal Map画像選択 Normal Mapプレビュー X反転 Y反転 Blur Normal画像保存

など大量の項目を通常UIへ並べる。

武器

Frame1イベント Frame2イベント Frame3イベント Muzzle event Tracer event Fire event

などを毎回ユーザーに設定させる。

これらは今回の目的に反します。

34. 今回の完成形

プレイヤー

画像ライブラリ ↓ 通常画像を複数選択 ↓ 発射画像を複数選択 ↓ 位置と大きさを調整 ↓ 完成

敵

名前 ↓ 攻撃パターン ↓ HP / 移動速度 ↓ 歩き画像を複数選択 ↓ 攻撃画像を複数選択 ↓ 遠距離ならエフェクト選択 ↓ 登録

マップ

壁画像を選択 ↓ 必要なら凹凸効果を追加

床画像を選択 ↓ 必要なら凹凸効果を追加

天井画像を選択 ↓ 必要なら凹凸効果を追加

これで完了するようにしてください。

35. 最終目標

このツールは、

「細かい設定が大量にできるエディタ」

ではなく、

「画像を登録したらすぐFPSとして動かせるエディタ」

を目指します。

自動化できる処理をユーザーに設定させないでください。

設定項目の追加には常に、

「この項目は本当にユーザーが毎回設定する必要があるのか?」

を考えてください。

必要がなければ内部で自動処理してください。

36. 完成後の確認項目

実装後は必ず、

1.  JavaScript構文エラーがない
2.  初期起動できる
3.  Pointer Lock開始・解除できる
4.  ウィンドウ・タブ終了後にカーソルが正常復旧する
5.  マウス視点操作が滑らか
6.  ランダムマップ生成できる
7.  敵数0で0体になる
8.  プレイヤー移動できる
9.  壁際移動で引っ掛かりが再発していない
10. Z-fightingが再発していない
11. 射撃できる
12. 敵へRaycast命中する
13. 壁へ着弾する
14. 床へ着弾する
15. 天井へ着弾する
16. Tracerが動く
17. 火花・煙・弾痕が動く
18. 敵スポーンできる
19. 敵AIが動く
20. 武器複数画像アニメーションが動く
21. 通常アニメーションから発射アニメーションへ移行できる
22. 発射終了後に通常へ戻る
23. 敵歩きアニメーションが動く
24. 敵停止時に歩き先頭画像が表示される
25. 敵攻撃アニメーションが1回再生される
26. ファイヤー攻撃が動く
27. エネルギー攻撃が動く
28. マップ再生成後に古いエフェクトが残らない
29. Normal Map自動生成が動く
30. 壁へNormal Mapが反映される
31. 床へNormal Mapが反映される
32. 天井へNormal Mapが反映される
33. Normal Map OFFでも従来表示が壊れない
34. 画像ライブラリ削除判定が複数フレームに対応している
35. JSON保存できる
36. JSON再読み込みで設定が完全復元される
37. Normal Mapが再読み込み時に自動再生成される
38. 旧JSONでも致命的エラーにならない
39. 使用中Texture / Geometry / Materialの無駄な大量生成がない
40. コンソールに重大なエラーが出ない

まで確認してください。

見た目だけのモックではなく、実際に使用できる完成状態にしてください。

着弾エフェクトがいまいちなので、改善できるか

エフェクトがいまいちなので、また攻撃にサンダーを入れて添付ファイルをもとに改善できるか

キャラクターの絵の比率がおかしいような気がする

遠距離攻撃の敵キャラがプレイヤーを見つけようとしない

以上を改修すること

コメント