寝殿造り3D探訪

平安貴族の邸宅様式「寝殿造り」を、3D空間を歩きながら学べるブラウザ完結型の学習ゲームです。建物・建具・調度品・人物・怪異・和歌・年中行事を、自由散策、クイズ、物語、ミニゲームで体験できます。

現在の正本は GitHub origin/main です。作業前と公開前は必ず git fetch origin し、古いローカルHTMLを正本にしないでください。

現在の主な機能

• 3D寝殿造り探索: 寝殿、対屋、渡殿、釣殿、築地、門、庭、池、季節植物を歩いて確認できます。
• 図鑑と名称札: 建築、建具、調度品、人物、怪異、生き物、霊獣、和歌を項目別に記録します。
• 名称当てクイズ / タイムアタック: 対象を探してクリック/タップし、端末内記録と接続時の共有順位を保存します。
• オンライン御前試合 / 共同討伐: 六文字の部屋番号で二人が集まり、御前五番勝負、名称当てクイズ、蹴鞠、香合わせの対戦に加え、四季の怪異を二人で祓えます。共同討伐は操作と敵AIを各端末で処理し、サーバー確定の共有HPと行動だけを同期するため、遅延時も移動操作を止めません。
• 御前五番勝負: 名称当て、貝合わせ、香合わせ、歌合、蹴鞠を各1000点、合計5000点で競う3〜5分の総合戦です。対戦ではサーバー発行シードから同じ札・配置・鞠順を生成し、各局終了時だけ進捗を同期します。
• 貴族の一日: 男性貴族・女性貴族の生活導線を短い体験モードとして学べます。
• 垣間見ミッション: 東格子、北壁代、妻戸先の観察地点を使い、巡回や警戒を避けて進みます。
• 物の怪退治: 破魔の矢/札、ガード、回避、御神酒、季節ボス、専用HUDを備えた戦闘モードです。
• 物語モード「御簾の向こうへ」: 6章構成、選択肢、章別BGM、ミニゲーム連携、5種のED分岐、回想、手動記録を備えています。
• 章選択と記録: 章メニュー、オートセーブ、3枠の手動セーブを備え、旧保存形式も安全に読み替えます。
• ED分岐ゲージ: 結末到達後に章メニューへ解放され、現/雅/蝕の予兆を可視化します。
• 薫物合（香合わせ）: 三局の依頼に対し、六種の香材、香名、火加減を組み合わせて調香し、完成した香の聞書きを残します。固定の一問一答ではなく、配合の調和と見立てを評価します。
• 蹴鞠「八人の鞠庭」: 四つの懸を巡り、位置取り、受け、高蹴り、渡しを使い分けて八人で鞠をつなぐ協力型ラリーゲームです。
• 恋愛/陰陽系の基盤: 恋の母屋ハブ、恋愛内の香合わせ、牛車外出、30日イベント、陰陽寮の占い補正が入っています。
• 車宿と牛車運び: 散策中に車宿/牛車を調べると、車寄まで牛車を運ぶミニゲームを開始できます。
• 太極六壬式盤の占い: 散策中に式盤を調べ、西暦/干支/十二天将/五行を使った占断を表示できます。
• 絵巻断片収集: 邸内の断片を集め、西の対の継ぎ台で導線を確認できます。
• 屋敷の生活: 主人、北の方、子女、家司、乳母、命婦、下女、随身、舎人、下男などを配置。7役は朝昼夕夜の日課で行動し、会話の聞き耳や使者・来客・牛車の到着が発生します。
• 軽量描画モード: 低性能端末向けに画質、影、ブルーム、季節粒子、フレームレートを一括で抑え、解除時は元の設定へ戻します。
• 季節・時間・天候演出: 春夏秋冬、昼/夕/夜/夜明け、雨、桜吹雪、灯籠流し、月映りなどが連動します。
• 音響: 環境音、足音、管弦、退治SE、ボスBGM、物語BGMを使用し、欠損時は合成音へフォールバックします。

詳細な実装済み/ブランチ状況は IMPLEMENTATION_STATUS.md を参照してください。

起動方法

1. 寝殿造り3D探訪_統合版.html をブラウザで開きます。
2. 音を鳴らす場合は、同じ階層に sounds/ フォルダを置いてください。
3. GitHub Pages では index.html から本体HTMLへ遷移します。

操作

環境	移動	視点	調べる
PC	WASD / 矢印キー、Shiftで早歩き	ドラッグ	クリック
タブレット/スマホ	左下ジョイスティック	ドラッグ	タップ / 右下「調べる」

上部バーから、モード、季節、時刻、名称札、図鑑、画質、音量を切り替えられます。物語/退治/恋愛など一部モードでは専用HUDが優先されます。

開発と検証

初回のみ:

npm install

よく使う検証:

npm run build:story:check
npm run verify:html
npm run verify:story
npm run verify:routes
npm run smoke
npm run verify:public
npm test

npm test は、アプリ/物語ビルド同期、HTML静的検証、ストーリー整合、EDルート、Playwrightスモークをまとめて確認します。スモークでは香合わせ三局、蹴鞠四懸、御前五番勝負、共同討伐の出陣/共有ダメージ/決着、固定シード、共有順位、Canvas描画、390px幅も検査します。公開後のGitHub Pages確認は npm run verify:public で行います。

描画・牛車・季節切替の回帰検査も npm test に含みます。npm run test:visual-backlog は積雪の上下面、追加植栽の通行線、灯台との連動、省電力復元、資源再利用を単独確認します。改修記録は ビジュアル残件の対応状況、今後の候補は 追加改善案 を参照してください。

ファイル構成

寝殿造り3D探訪_統合版.html     アプリ本体。Three.js r128、主要テクスチャ、手続き生成モデルを内蔵
index.html                     GitHub Pages 用エントリ
package.json                   検証コマンドと Playwright devDependency
scripts/                       ビルド/検証/スモーク/公開URL確認スクリプト
src/app/                       HTMLへ埋め込むUI・データ・追加機能の正本
supabase/                      オンライン対戦・共有順位のDB定義と導入手順
story/                         物語モードの章JSON、設定資料、QA資料
sounds/                        環境音・効果音・BGMとクレジット
assets/bosses/                 退治ボス用GLBとマニフェスト（一部大型モデルはルートGLBから派生）
icons/                         PWA/OGP等のアイコン素材
docs/                          ハンドブック、計画書、メトリクス、古い引き継ぎの保管場所
IMPLEMENTATION_STATUS.md       main/ブランチの実装済み状況
docs/handbook/HANDOFF_LATEST.md 次作業者向けの最新引き継ぎ
docs/handbook/PROJECT_MAP.md   単一HTMLの編集地図と衝突回避ルール

保守ルール

• Three.js は r128 前提です。outputEncoding / sRGBEncoding / texture.encoding を維持し、新しい colorSpace API は使いません。
• 単一HTML方針を維持します。分割や外部CDN追加は、配布性とオフライン性への影響を確認してから行ってください。
• src/app/ と story/ に正本がある埋め込み範囲はHTMLを直接編集せず、npm run build:app、続けて npm run build:story の順に再生成してください。2つの書き込みビルドを並列実行しないでください。
• ITEMS, register(), pick(), enterMode(), animate(), CSS HUD、音声初期化は衝突しやすい領域です。
• Claude/Codex 並行作業時は、必ずブランチで作業し、origin/main を取り込んでから push してください。

ライセンス・クレジット

• 3D描画エンジン: Three.js r128, MIT License
• 環境音・効果音・BGM: sounds/CREDITS.md
• 追加素材/ボスモデル: 各マニフェスト、クレジット、生成元メモを参照