【ITニュース解説】Phoenix Panels and the Swarm: Building a Living NPC Simulator

このニュース記事は、Phoenixという新しいプラットフォーム上で開発された、「生きている」NPCシミュレーターの技術的な仕組みと、そこから得られた学びについて解説している。従来の一般的なユーザーインターフェース（GUI）は、一度画面の状態を表示すると、ユーザーが手動で更新しない限り情報は古いままになることが多かった。しかし、Phoenixで構築された「パーペチュアルパネル」は、常に最新の情報を表示し続ける動的なウィンドウとして機能する。これは、自動で情報が更新され、常に最新の状態を映し出す機能を持つ。

このNPCシミュレーターパネルは、自律的に動く群れ（スワーム）のエージェントと連動した、コックピットのような操作盤として実現された。このパネルを使うことで、NPCのリアルタイムな状態がストリーム配信され、ユーザーからの制御コマンドを受け付け、その結果がすぐに視覚的にフィードバックされる。

Phoenixのパーペチュアルパネルは、いくつかの重要な特徴を持っている。まず「セッション認識（Session-aware）」である点だ。これは、各パネルがそれぞれ独自のセッションIDを持ち、そのセッション内でのみ情報の送受信が行われることを意味する。これにより、複数のユーザーが同時にシミュレーションを操作しても、お互いの情報が混ざり合うことなく、独立した体験が保証される。次に「イベント駆動（Event-driven）」である。これは、パネルが特定の「イベント」（例えば、新しいデータが到着したこと）を検知すると、それに応じて動作するという仕組みだ。さらに「自己更新（Self-refreshing）」機能により、新しいデータが届くたびに自動的に画面が再描画されるため、常に最新の状態が保たれる。そして「FIFOフレームバッファリング」という仕組みが、画面更新の安全性を確保する。これは、更新データを一時的に順番に保持し、処理を待つ場所（キュー）に入れ、Qtのメインループという画面描画の中心的な処理で、安全かつ効率的に処理することで、システムがクラッシュするのを防ぐ。このNPCゲームボードは、単なる静止画のグリッドではなく、まさにライブのシミュレーションストリームを映し出す、常に更新され続ける窓なのだ。

このシミュレーターの中心にあるのは「npc_simulatorエージェント」と呼ばれる、PhoenixのBootAgentを基盤とした群れを認識するプログラムだ。このエージェントは、群れのNPCたちに「スカウト」「ハンター」「フォロワー」という3つの主要な役割を与える。スカウトはランダムに動き回り、プレイヤーを発見するとその位置を周囲に知らせる。ハンターはプレイヤーが最後に目撃された場所に集結し、フォロワーはハンターの後ろに集まって行動する。

シミュレーションの重要なメカニズムは、まず「ストリーム」の概念にある。各シミュレーションセッションが開始されると、専用の処理スレッドが起動する。このスレッドは、npc_simulatorエージェント内部で「_stream_loop」という核となる処理を常に実行し、NPCたちの状態を更新し続け、その最新の状態を「フレーム」という形で定期的にブロードキャスト（一斉送信）する。このストリームは「セッションID」によって管理され、もしセッションの有効期限が切れた場合は、自動的にクリーンアップされる。ブロードキャストされるフレームには、セッションID、プレイヤーの位置、NPCのリスト、プレイヤーが最後に目撃された位置、そしてタイムスタンプといった情報が暗号化され、署名された形で含まれている。ユーザーは「cmd_control_npcs」というコマンドを通じて、NPCの行動をライブで変更できる。例えば「ハント（狩る）」「スキャッター（散開）」「ピング（索敵）」「シールド（防御）」「ロック（固定）」といったアクションにより、一時的に群れの振る舞いを変化させることが可能だ。

群れの行動パターンは、単にNPCを動かすだけでなく、より複雑な振る舞いを実現している。「ハント」モードではハンターがプレイヤーの位置へ積極的に集まる。「スキャッター」モードでは群れがカオスに震え、隊列を崩す。「ピング」モードではスカウトの索敵範囲が一時的に広がる。「シールド」モードではハンターがプレイヤーから反発し、防御的な泡のような陣形を形成する。「ロック」モードでは群れ全体が一時的に完全に停止する。これらの特殊な行動は、それぞれ「散開残り時間」「索敵残り時間」といった単純な「ティックカウンター」と呼ばれる残り時間を示す数値で管理されており、メインループでこの数値が減少していくことで、一時的で戦術的な、そして視覚的にも明確な行動が実現されている。

「ゲームボードパネル」は、PyQtというツールキットを使って作成されており、20x20のグリッドで群れの様子を表示する。プレイヤーは緑色の「@」で、ハンターは赤色の「o」、スカウトは黄色の「o」、フォロワーは水色の「o」でそれぞれ表現される。プレイヤーが最後に目撃された位置は赤色の「X」で示され、複数のNPCが同じマスに重なった場合は、「2」「3」といった数字でその数が表示される。

このシステムにはいくつかの重要な技術革新がある。例えば、安全なストリーミング更新のために、受信したフレームは「deque（デック）」と呼ばれる、両端から要素を追加・削除できるデータ構造のキューに入れられ、画面には常に最新のフレームのみが描画される。また、画面の更新は「QMetaObject.invokeMethod」という機能を使って、常にQtのメインスレッドで実行されるようにスケジュールされるため、異なる処理スレッドからの更新によるUIのフリーズやクラッシュを防ぐ「スレッドセーフなUI」が実現されている。さらに、パネルのリサイズ中は更新をスキップすることで、リサイズ時のクラッシュを防止している。パネルは、最後に表示されたプレイヤーの位置、最後に目撃されたプレイヤーの位置、そしてNPCのリストといった「永続的な状態」を記憶しており、再描画の際にもこれらの情報が失われることはない。パネルには「ストリーム開始/停止」「ハント/散開」「ピング/シールド/ロック」といったボタンが配置された制御バーがあり、これらを使ってシミュレーションを操作できる。

開発中にはいくつかの困難な問題に直面したが、これらは解決されている。Qtのクラッシュは、FIFOバッファリングとリサイズ中の更新停止によって回避された。NPCが重なった際の情報の乱雑さは、重なったNPCの数を数字で表示することで解決された。GUI以外のスレッドからの更新による問題は、すべての更新処理をGUIスレッドで順番に実行する「キューに入れられたスロット」という仕組みを通して解決された。また、存在しないデータ（NoneType）を参照しようとして発生するエラーは、プレイヤーが最後に目撃された位置のデータ処理時に安全なチェックを設けることで防がれた。これらの修正により、システムはクラッシュすることなく indefinitely に動作する、堅牢なコックピットへと進化した。

このプロジェクトから得られた教訓は多い。Phoenixのパーペチュアルパネルは、長期間稼働するストリーム駆動型の表示を可能にする。群れのエージェントは、シンプルなティックカウンターと共有状態によって、予期せぬ、しかし理にかなった行動をシミュレートできる。セッションスコープを持つイベントバスは、複数のシミュレーションを互いに隔離し、清潔に保つ。視覚的なフィードバックだけでなく、ログや音響も加わることで、操作がより意味深く感じられるようになる。時には「より効果的な演出」を加えることが、ユーザー体験を向上させる解決策となることもある。

「NPCをグリッドに表示できるか？」というシンプルな技術検証から始まったこのプロジェクトは、最終的に完全にインタラクティブな群れ制御コックピットへと発展した。Phoenixパネルは、永続的に稼働し、フレームをストリーミングし、コマンドを受け付ける。npc_simulatorエージェントは、シンプルながらも複雑な行動を示す群れの役割を管理する。そして、このシステムは安定しており、将来的にはより多くのパネル、より多くのエージェント、そしてより豊かな行動へと拡張可能なアーキテクチャを備えている。このNPCパネルは単なるデモではなく、Phoenixパネルがセキュリティ、セッション分離、そして創造性を兼ね備え、群れへの「生きた窓」として機能できることを証明している。