Preserve approved pixel tower prototype as development baseline

This commit is contained in:
Codex
2026-09-09 07:51:16 +09:00
commit 423fd6dd2e
915 changed files with 95193 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
# The Tree
『The Tree』のゲーム制作環境です。Godot 4.7系、GDScript、2Dサイドビューを採用しています。
## 起動
make editor
Godotが開いたら、右上の実行ボタンまたは `F5` でプロジェクトを起動できます。エディタを開かず直接実行する場合は `make run` を使用します。
## ドット絵の世界樹を見る
『The Tower SP』のように断面の施設と小さな人物の営みを眺める方向で、マップをドット絵主体へ変更しました。KenneyのTiny Dungeon・Tiny Townの16px素材と、専用の部屋・家具描画を組み合わせています。従来の大きな生成背景は現在のマップ描画では使いません。上部の情報と操作バーを小さくし、建築・運営パネルは必要なときに開きます。
make preview-pixel # 受付・食堂・客室と実際の客・従業員が動く見学モード
make capture-pixel # 時間差のPNG 2枚と運営状態JSONを artifacts/pixel-tower に出力
make test-pixel-ui # ズーム、移動、実施設クリック、アニメーション停止の回帰テスト
見学モードは専用の仮設シナリオで、通常の新規ゲーム・セーブには反映しません。操作、確認できる内容、現時点の制約は [ドット絵表示と見学ガイド](docs/PIXEL_TOWER_VISUALS.md) を参照してください。
## 確認と書き出し
make test # S0〜S6と操作画面の全Headless自動テスト
make test-acceptance # 24時間実Tickと14日運営境界の受入試験
make test-perf-full # 200客・50従業員・150施設の24時間完全負荷試験
make check # 読み込みとメイン画面の起動確認
make export-windows # Windows版を build/windows に生成
## 設計方針
マップは次の2軸を混同しないように実装します。
- ゾーン:地上/境界/地下。合法性、客層、環境効果を決める。
- レイヤー:フロント/バック。客用空間と従業員・物流空間を決める。
ゲーム状態と画面を分離しているため、施設、客AI、シフト、関係状態を追加してもUI全体を書き直す必要はありません。現在は、決定的な時間進行、世界・掘削・実通路投影・建築、施設Queue、在庫・物流、Mana、複式台帳、客と従業員、雇用候補20人の選択画面、日次給与と破綻、関係Event、行政監査、世代保存とMigrationまでを実装しています。内部の状態遷移と異常時の扱いは [詳細システム仕様書](docs/SYSTEM_SPECIFICATION.md)、コード構成は [アーキテクチャ](docs/ARCHITECTURE.md)、実装済み範囲は [実装状況](docs/IMPLEMENTATION_STATUS.md) を参照してください。
## 仕様書
- [全体制作計画](docs/DEVELOPMENT_PLAN.md)
- [ドット絵表示と見学ガイド](docs/PIXEL_TOWER_VISUALS.md)
- [画像アセット制作・差し替え仕様書](docs/ART_ASSET_PRODUCTION_SPECIFICATION.md)
- [試遊ガイド](docs/PLAYTEST_GUIDE.md)
- [ゲーム仕様書](docs/GAME_SPECIFICATION.md)
- [詳細システム仕様書](docs/SYSTEM_SPECIFICATION.md)
- [設計判断記録](docs/DESIGN_DECISIONS.md)
- [アーキテクチャ](docs/ARCHITECTURE.md)
- [実装状況](docs/IMPLEMENTATION_STATUS.md)
- [自動テスト対応表](docs/TEST_MATRIX.md)
- [MVP 14日受入シナリオ](docs/MVP_ACCEPTANCE_SCENARIOS.md)
- [MVP施設カタログ注記](docs/data/FACILITY_CATALOG.md)
- [施設一覧・レイヤー分類](docs/FACILITY_LIST.md)
- [施設詳細データ設計](docs/FACILITY_DATA_DESIGN.md)