このプロジェクトについて

UnrealAgentPlayerは、AIコーディングエージェント(Claude Code、Cursor、Claude Desktopなど)がUnreal Editorと自律的に対話できるように設計されたツールセットです。これはC++エディタプラグインとPython MCP (Model Context Protocol) サーバーで構成されており、エージェントが人間の介入なしに、編集、コンパイル、プレイ、および変更の検証というフルサイクルを実行することを可能にします。 主な機能は以下の通りです: - PIEコントロール:Play-In-Editorセッションの開始、停止、一時停止、および再開。 - 入力インジェクション:ウィンドウのフォーカスに関係なく、キーボード、マウス、ゲームパッド、VRコントローラーの入力をゲームビューポートに直接注入。 - 観察:フィルタリング付きのログキャプチャ、画面上のUMG UIテキストの読み取り、およびビューポートのスクリーンショット撮影。 - 内省:アクターの検索、プロパティの取得/設定、および任意のPythonエディタスクリプトやコンソールコマンドの実行。 - パフォーマンス追跡:リアルタイムのドロー/GPUタイミングの読み取り、およびパフォーマンスベースラインの保存/比較によるリグレッションの検出。 - テストフレームワーク:プロジェクト固有のBlueprint/C++テストヘルパーの自動検出と、詳細なHTML実行レポートの生成。 - エディタ自動化:Windows UIAutomationを介したネイティブエディタメニューの操作。 本システムは、Windows上のUnreal Engine 5.6、5.7、および5.8(Meta 5.7フォークを含む)をサポートしています。MCPサーバーとエディタ間の通信には、Remote Control HTTPおよびPython Remote Executionを利用しています。