Status Board Demo

実験的機能 - このデモはv2.2.0（未リリース）のTraitsとViewsを使用しています。APIは将来のバージョンで変更される可能性があります。本番環境での使用は自己責任で行ってください。

概要

TraitsとReactiveViewsを手を動かして体験するデモです。エンティティ行をクリックしてエディタウィンドウを開き、HPを動かしたりトレイトをトグルしたりしながら、右パネルがリアルタイムに変わるのを確認できます。

ViewTriggerの3モードすべてを使用しています。

  • DataOnly – データ変更のみに反応するビュー（HP閾値）
  • TraitsOnly – トレイト変更のみに反応するビュー（単一トレイトおよび複数トレイトのANDマスク）
  • All – データとトレイトの両方の変更に反応するビュー（HP + トレイトの複合条件）

使用している機能

機能 アセット / クラス 説明
Reactive Entity Set CitizenSet (CitizenStateSetSO) CitizenStateデータを持つすべての市民エンティティを格納
Traits CitizenTrait ([Flags] enum) エンティティごとのビットマスクフラグ: Cursed, Poisoned, Shielded
ReactiveView (DataOnly) Low HPビュー HP < 30%のエンティティにマッチ
ReactiveView (TraitsOnly) Poisonedビュー Poisonedトレイトを持つエンティティにマッチ
ReactiveView (TraitsOnly) Cursed & Poisonedビュー CursedとPoisonedの両方のトレイトを持つエンティティにマッチ
ReactiveView (All) Elite Guardビュー HP > 80%かつShieldedトレイトを持つエンティティにマッチ

詳細はTraitsとViewsのガイドを参照してください。

アーキテクチャ 

graph LR
    subgraph "UI Toolkit"
        CTRL[StatusBoardDemoController]
        WIN[WindowFrame<br/>Draggable Entity Editor]
        DRAG[WindowDragManipulator]
    end

    subgraph "Reactive Entity Set"
        SET[CitizenStateSetSO<br/>CitizenSet]
    end

    subgraph "ReactiveViews"
        V1["Low HP<br/>(DataOnly)"]
        V2["Poisoned<br/>(TraitsOnly)"]
        V3["Cursed & Poisoned<br/>(TraitsOnly)"]
        V4["Elite Guard<br/>(All)"]
    end

    CTRL -->|"Register / Unregister"| SET
    CTRL -->|"UpdateData / AddTraits / RemoveTraits"| SET
    CTRL -->|"CreateView()"| V1
    CTRL -->|"CreateView()"| V2
    CTRL -->|"CreateView()"| V3
    CTRL -->|"CreateView()"| V4
    SET -->|"notifies"| V1
    SET -->|"notifies"| V2
    SET -->|"notifies"| V3
    SET -->|"notifies"| V4
    V1 -->|"OnEnter / OnExit"| CTRL
    V2 -->|"OnEnter / OnExit"| CTRL
    V3 -->|"OnEnter / OnExit"| CTRL
    V4 -->|"OnEnter / OnExit"| CTRL
    CTRL -->|"creates"| WIN
    WIN -->|"uses"| DRAG

重要なポイント: ScriptableObjectのイベントチャンネルは不要です。コントローラーはエンティティセットから直接ReactiveViewインスタンスを作成し、OnEnter / OnExitイベントを購読します。エンティティのデータやトレイトが変更されると、ビューは自動的に述語を再評価し、UIが更新されます。

主要ファイル

ファイル 説明
Scripts/Data/CitizenState.cs エンティティデータ構造体: Hp, MaxHp
Scripts/Data/CitizenTrait.cs [Flags] enum: Cursed, Poisoned, Shielded
Scripts/Sets/CitizenStateSetSO.cs ReactiveEntitySetSO<CitizenState>アセットタイプ
Scripts/UI/StatusBoardDemoController.cs メインコントローラー – エンティティ、ビュー、UIを管理
Scripts/UI/Elements/WindowFrame.cs タイトルバーと閉じるボタンを持つドラッグ可能なウィンドウVisualElement
Scripts/UI/Elements/WindowDragManipulator.cs タイトルバードラッグ用のPointerManipulator
UI/StatusBoardDemo.uxml 3カラムレイアウト（左サイドバー、中央ワークスペース、右サイドバー）
UI/USS/StatusBoardDemo.uss ダークテーマのスタイリング
ScriptableObjects/CitizenSet.asset CitizenStateSetSOインスタンス

使い方

  1. StatusBoardDemo シーンを開く
  2. Play Modeに入る – ランダムなHPとトレイトを持つ12体のエンティティが生成される
  3. 左サイドバーの Add / Remove ボタンで5体ずつエンティティを追加・削除
  4. 左サイドバーのエンティティ行をクリックして、中央ワークスペースにドラッグ可能なエディタウィンドウを開く
  5. HPスライダーをドラッグしてエンティティの体力を変更 – Low HPビューとElite Guardビューの更新を確認
  6. Cursed、Poisoned、Shielded のトレイトボタンをトグル – トレイトベースのビューの更新を確認
  7. 右サイドバーのパネルを見て、各ReactiveViewにエンティティがリアルタイムで出入りする様子を観察

ユースケース

エンティティが状態に応じてグループに出入りする仕組みが必要な場面で、このパターンをそのまま使えます。

ユースケース 具体例
ステータスエフェクト 視覚フィードバックやティックダメージのために、毒状態やスタン状態のユニットを追跡
アラートシステム HUDで低HPの味方や高脅威の敵をハイライト
部隊編成 ステータスとトレイトの複合条件でユニットを自動グルーピング（例: 回復可能なヒーラー）
フィルタダッシュボード ゲームステートのライブフィルタリングビューを表示するデバッグ/管理パネルの構築
This site uses Just the Docs, a documentation theme for Jekyll.