コズミックフォージ3D - 惑星生成×重力バトルロイヤル

## 1. アプリの目的・ターゲットユーザー
プロシージャル生成された3D惑星の表面を舞台に、重力を操りながら敵を次々と撃破していく爽快感MAXの3Dアクションシューティングゲーム。「惑星ごとに全く異なるフィールド」「重力反転・重力波・ブラックホール生成などの物理ギミック」「ジャングルジム的な立体移動」を軸にした、ついつい何周もしてしまう中毒性設計。ターゲットは10代〜30代のゲーム好きなブラウザユーザー。

---

## 2. 主要機能

- **プロシージャル惑星生成エンジン**
Three.js の SphereGeometry + PerlinNoise (内製JS実装) で毎回異なる地形・色・重力強度・大気色を持つ惑星を生成。砂漠・氷・溶岩・結晶・霧の5バイオームからランダム選択。惑星表面をそのままステージとして使用し、プレイヤーは惑星外周を全方向に移動できる。

- **重力アクション移動システム**
プレイヤーは常に惑星中心方向に引き寄せられる球面重力の上を走る。スペースキー/タップでジャンプ、ダブルタップで重力反転(一時的に惑星から離脱して上空を浮遊)、長押しで「重力波弾」を発射して敵をまとめて吹き飛ばす爽快アクション。

- **敵ウェーブ＆ボスシステム**
各惑星で10ウェーブの敵軍が出現。ウェーブごとに敵の種類・数・スピードが増加。5ウェーブごとにボスが登場(惑星サイズの巨大ロボット・重力砲台・群体スライム)。ボスは弱点部位を狙った集中攻撃で破壊可能。

- **武器フォージ(鍛造)システム**
倒した敵がドロップする「星屑クリスタル」を消費して武器をアップグレード。基本砲→レーザーブレード→ブラックホール砲→ノババーストの4段階進化。武器は一時的な強化なのでリプレイ性を確保。

- **リッチなビジュアル＆オーディオ**
Three.js によるフルWebGL3Dレンダリング。ParticleSystem で爆発・重力波・ブラックホール吸引エフェクトを表現。BGMはWeb Audio APIのオシレーター＋フィルターで宇宙的なアンビエントサウンドをプロシージャル生成(4テーマ: 静寂宇宙 / 激戦 / ボス戦 / 勝利)。効果音もWeb Audio APIで完結。惑星ごとに背景の星雲・ネビュラ色が変化。

- **スコア＆ランキング**
コンボ数・クリアウェーブ数・撃破数・タイムボーナスを集計してスコア算出。MySQL にプレイヤー名とスコアを保存しグローバルランキングTop50を表示。デイリーチャレンジ(固定シード惑星)でスコア競争。

---

## 3. 画面構成

### タイトル画面
- フルスクリーンの回転する3D惑星がバックに漂うタイトルロゴ(Three.jsアニメーション)
- 「PLAY」「RANKING」「HOW TO PLAY」の3ボタン
- 毎回異なるランダム惑星プレビューが回転表示
- プロシージャル生成BGMが自動再生

### 惑星選択画面
- 「RANDOM PLANET」「DAILY CHALLENGE」「SEED入力」の3モード
- Randomを押すと3秒でリアルタイム惑星生成アニメーション
- 生成された惑星のバイオーム・重力強度・難易度インジケーターを表示

### メインゲーム画面(Three.js全画面Canvas)
- 中央に3D惑星+プレイヤーキャラ(三人称視点カメラ追従)
- 画面左上: HP・シールドゲージ・武器アイコン
- 画面右上: スコア・コンボカウンター・ウェーブ表示
- 画面下中央: 重力反転クールダウンゲージ
- スマホ: 左側バーチャルスティック・右側ジャンプ/攻撃/重力反転ボタン
- PC: WASD移動・マウス照準・スペースジャンプ・Shift重力反転・クリック攻撃
- ボス登場時: ボスHPバーが画面上部にアニメーション表示
- コンボ時: 画面中央に派手なコンボテキストエフェクト

### リザルト画面
- クリア演出: 惑星が爆発して星屑が広がるパーティクルアニメーション
- スコア内訳・最長コンボ・クリアタイム・獲得クリスタル量の表示
- 「次の惑星へ」「タイトルへ」「スコアを登録」ボタン

### ランキング画面
- グローバルTop50(サーバー取得)
- デイリーチャレンジとオールタイムの2タブ
- 自分のスコアをハイライト表示

---

## 4. データ構造(DBテーブル)

```sql
-- グローバルスコア
CREATE TABLE scores (
id INT AUTO_INCREMENT PRIMARY KEY,
player_name VARCHAR(20) NOT NULL,
score INT NOT NULL,
wave_reached INT NOT NULL,
planet_seed VARCHAR(20) NOT NULL,
biome VARCHAR(20) NOT NULL,
is_daily TINYINT(1) DEFAULT 0,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- デイリーチャレンジシード(1日1レコード)
CREATE TABLE daily_challenge (
id INT AUTO_INCREMENT PRIMARY KEY,
challenge_date DATE NOT NULL UNIQUE,
planet_seed VARCHAR(20) NOT NULL,
biome VARCHAR(20) NOT NULL
);
```

ゲームロジック・惑星生成・物理演算・オーディオは全てクライアントJSで完結。サーバーPHPはスコア登録とランキング取得・デイリーシード管理のみ担当。

---

## 5. デザインの方向性

- **宇宙SF×映画クオリティ**: 深い宇宙黒背景に鮮やかなネビュラ(星雲)カラーが映える高コントラストデザイン。惑星ごとに全く異なるカラーパレット(溶岩=赤オレンジ・氷=シアンブルー・結晶=パープル・砂漠=ゴールド・霧=エメラルド)
- **UIはSFホログラム風**: 半透明グラスモーフィズム+発光エッジのUI要素。フォントはOrbitron(Google Fonts)またはモノスペース系
- **爆発・パーティクルを惜しまない**: コンボ・ボス撃破・重力波発動の都度に画面を揺らすヒットストップ+画面端フラッシュエフェクト
- **スマホファースト**: ゲーム中のUIは最低限に絞り、タッチ操作の誤押しを防ぐため各ボタンを画面端に配置。横持ち強制推奨メッセージを縦向き時に表示
- **ローディング画面**: 惑星生成中は星雲が渦巻くアニメーションとプログレスバーで「今まさに宇宙が作られている感」を演出

---

## 実装技術スタック
- **フロントエンド**: Three.js(WebGL 3D)、Web Audio API(BGM/SE生成)、内製PerlinNoise JS(地形生成)
- **バックエンド**: PHP 8(スコア登録/取得REST風API・デイリーシード管理)
- **DB**: MySQL(scoresテーブル・daily_challengeテーブルのみ)
- **ライブラリ**: Three.js CDN、OrbitControls、フォントはGoogle Fonts
- **対応**: PC(Chrome/Firefox/Safari)・スマホ横持ち対応
- **規模感**: JS約2000行、PHP約200行で完結する現実的なサイズ