hell-workers

Hell Workers

地獄の建設プロジェクトを指揮する、2Dピクセルアートの建築シミュレーションゲームです。

コンセプト

プレイヤーは地獄の「所長」として、永遠に放置されてきた**怠惰な魂（Soul）**たちを使い、地獄の王のための大規模施設を建設します。

ゲームの特徴

• マクロマネジメント重視: 個々の作業員を直接操作するのではなく、**使い魔（Familiar）**を通じて間接的に指揮します。
• 間接指揮: 使い魔に建設エリアや優先度を指示し、Soulへの作業割り当ては使い魔が自動で行います。
• リソース管理と物流: 資源の調達・搬送・在庫管理を計画し、効率的な物流網を構築します。
• 怠惰な魂たち: Soulは疲労やストレスでサボったり、井戸端会議を始めたり。マネジメントの腕が試されます。

ファンタジー × 建築シミュレーション

本作は建築プロジェクト管理のリアルな面白さを、「地獄」というファンタジー設定でラップしています。 これにより、リアリティの追求や細かい突っ込みどころを軽減しつつ、RimworldやFactorioが好きなプレイヤーに新鮮な体験を提供します。

これは○○ではありません

• マイクロマネジメントゲームではない: 作業員を一人一人クリックして指示するゲームではありません。
• 戦闘・タワーディフェンスゲームではない: 敵と戦うことが主目的ではありません。
• 忙しいリアルタイム操作ゲームではない: 計画と管理が重要で、常に忙しく操作する必要はありません。

---

技術スタック

• Engine: Bevy 0.19
• Language: Rust (Edition 2024)
• UI System: Bevy UI + project-owned debug gizmos/dev panel
• Features:
  • ECS Relationships: エンティティ間の複雑な関係（指揮、タスク、所持、格納）を効率的に管理。
  • Optimized Task System: 空間グリッドを活用した高速なタスク検索と割り当て。
  • Soul AI: 疲労、ストレス、やる気を持つ自律的な作業ユニット。
  • Familiar AI: Soulを指揮し、効率的な物流を構築するマネジメントユニット。

ディレクトリ構成

• crates/bevy_app/: App shell。アセット注入、root adapter、cross-crate scheduling、startup/save、plugin wiring
• crates/hw_core/: 共有基礎型、イベント、Relationship、定数、game state
• crates/hw_energy/: Soul Energyのmodel・定数・Relationship
• crates/hw_jobs/: task payload、建物/Designation、建設状態機械のpure rule
• crates/hw_world/: WorldMap、地形生成、経路探索、Room、ドア状態rule
• crates/hw_spatial/: typed spatial indexとindex-backed door proximity adapter
• crates/hw_logistics/: Inventory、資源/stockpile、TransportRequest、建設phaseのindex adapter
• crates/hw_familiar_ai/: Familiarの知覚・判断・委譲・使役処理
• crates/hw_soul_ai/: Soulのvitals、行動判断、task execution、移動
• crates/hw_ui/: widget、theme、ViewModel表示、UiIntent producer
• crates/hw_visual/: gameplay visual、speech、Dream presentation
• crates/visual_test/: 独立した4-pass RtTビジュアル検証アプリ
• docs/: 技術仕様書、要件ドキュメント
• docs/proposals/: 機能追加やリファクタリングの提案書
• assets/: スプライト、フォントなどのリソース
• scripts/: ユーティリティスクリプト（画像変換等）

開発の始め方

ビルドと実行

python3 scripts/dev.py doctor
python3 scripts/dev.py check
cargo run

デバッグ

• F12: デバッグ表示 / Gizmo のトグル
• Space: ポーズ / 再開（Virtual Time）

開発ルール（抜粋）

• Messages<T>/Events<T> は MessagesPlugin に追加して初期化する
• 型変更は 定義 -> 生成 -> 使用 の順で更新する
• 変換は From/Into を優先して as の多用を避ける

アセット共有

• アセット原本の共有は git ではなく Syncthing を推奨
• 原本はリポジトリ外の同期フォルダ、ゲーム実行用ファイルは assets/ に分離する
• 詳細手順は docs/assets_workflow.md を参照
• 外部 exports/ から assets/ へ反映する補助スクリプト: python scripts/sync_external_assets.py --source ~/Sync/hell-workers-assets/exports

関連ドキュメント

詳細は docs/README.md を参照してください。