ダンジョンクラッシュ3D - 重力反転ローグライク3Dアクション

## 1. アプリの目的・ターゲットユーザー
Three.jsで構築した完全3Dダンジョンを舞台に、「重力方向をリアルタイムに6方向切り替えながら敵を蹴散らす」爽快ローグライクアクションゲーム。1プレイ5〜15分で完結するため、スキマ時間でも熱中できる。ターゲットはスマホ・PCどちらでもプレイするゲーム好きの10代〜40代。アプリストア1位を狙う「つい次のダンジョンへ」の中毒性を最優先設計する。

---

## 2. 主要機能
- **重力フリップアクション**: ボタン1タップで重力を上下左右前後の6方向に瞬時に切り替え。プレイヤーが壁・天井を床として歩き回りながら敵を踏み潰す爽快感が核心。物理演算はThree.js＋独自AABB衝突で実装。
- **プロシージャル3Dダンジョン生成**: 毎回異なる部屋・通路・罠・宝箱配置をPHP側のシード計算で生成しJSON送信。ダンジョンは3〜7階層構成でフロアごとにギミック（溶岩床、氷床、逆重力ゾーン）が増加。
- **コンボ＆フィーバーシステム**: 重力切り替えを連続成功させるとコンボ倍率が上昇し、画面全体がネオンエフェクトに染まるフィーバー状態に突入。敵を一掃するほど気持ちいい連鎖爆発エフェクトをパーティクルで演出。
- **ボス戦（フロアボス×3種＋最終ボス×1種）**: 各ボスは「重力を逆手に取る行動パターン」を持ち、プレイヤーが正しい方向に重力を切り替えることで弱点を露出させる仕組み。ボスHPバーは画面上部に巨大表示。
- **ローグライク成長要素**: ダンジョン内の宝箱からランダムに「重力切り替え速度UP」「ブレイクスマッシュ強化」「磁力オーラ（周囲の敵を引き寄せ）」などのリレリック（遺物）を獲得。周回ごとに異なるビルドが生まれる。
- **グローバルスコアランキング**: MySQL保存の週次・通算ランキング。プレイ終了時にニックネームとスコアを1クリックで登録。上位3位はトップ画面に殿堂入り表示。

---

## 3. 画面構成

### タイトル画面
- 3Dで浮遊するダンジョン片と炎のパーティクルが背景アニメ
- 「PLAY」「ランキング」「操作説明」ボタン
- BGMはWeb Audio APIで生成するダーク×エレクトロニック風ループ音楽（オシレーター＋フィルター合成）
- 画面上部に「今週のランキング1位」表示

### ゲーム画面（Three.jsフルスクリーンCanvas）
- **左下**: 重力方向インジケーター（六面体ミニキューブがリアルタイム回転してどちらが「下」かを表示）
- **右下（PC）/ 画面四隅（スマホ）**: 重力切り替えボタン×6方向、攻撃ボタン、ダッシュボタン
- **上部**: HP・コンボカウンター・フィーバーゲージ・階層表示
- **中央奥**: プロシージャル生成された3Dダンジョンが遠景まで続くパースペクティブ表示
- ダメージ時に画面端が赤くフラッシュ、フィーバー時は全体がネオン発光

### ボス戦画面
- BGMが自動でボスBGM（緊張感あるエレクトロビート）に切り替わる
- ボスの巨大3Dモデルがカメラを揺らしながら登場するカットインアニメーション

### リザルト画面
- スコア、到達階層、倒した敵数、最大コンボ、使用したリレリックを一覧表示
- 共有用に「スコアカード」をCanvas描画してPNG保存可能
- ランキング登録フォーム（ニックネームのみ）

### ランキング画面
- 週次TOP20・通算TOP20をタブ切り替えで表示
- 自分のスコアが自動でハイライト

---

## 4. データ構造（MySQLテーブル概要）

```sql
-- スコアランキング
CREATE TABLE rankings (
id INT AUTO_INCREMENT PRIMARY KEY,
nickname VARCHAR(20) NOT NULL,
score INT NOT NULL,
floor_reached INT NOT NULL,
combo_max INT NOT NULL,
relics_used TEXT, -- JSON配列
played_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- デイリーシード管理（ダンジョン日替わり挑戦用）
CREATE TABLE daily_seeds (
id INT AUTO_INCREMENT PRIMARY KEY,
seed_date DATE UNIQUE NOT NULL,
seed_value VARCHAR(64) NOT NULL
);
```

ダンジョン構造はサーバー側でPHPのmt_rand(seed)で生成してJSONとして返すため、DBには保存しない。プレイヤーのセーブはLocalStorageで管理（リレリック選択中断復帰用）。

---

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

- **ビジュアルテーマ**: 「ダークファンタジー×ネオン」。石造りのダンジョン壁に魔法陣が光り輝き、重力切り替え時に全画面が青白い閃光で染まるエフェクト。Three.js のPointLightとEmissive Materialで魔法的な発光感を演出。
- **3Dグラフィック**: BoxGeometry中心のローポリゴンスタイル。アセット外部依存なし。敵キャラはプロシージャル生成した色違いの幾何学モンスター（球体＋コーン組み合わせ）。ボスは専用の複合Meshで存在感を出す。
- **BGM・SE**: Web Audio API完結。タイトルはアンビエントダーク、ゲーム中はアップテンポエレクトロ、フィーバーは更にBPMが上がりフィルターが開く演出。重力切り替え音、コンボ音、爆発音はオシレーターとエンベロープで合成。
- **UI**: 黒背景に金・シアン・マゼンタのアクセントカラー。フォントはシステムフォント＋CSSでレトロ感。ボタンは大きめでスマホの親指操作にも対応。
- **パフォーマンス**: Three.js r148以降を使用。モバイル向けにrenderer.setPixelRatio(1.5上限)、Frustum Culling、インスタンスメッシュを活用し60fps維持を目標とする。