Sobre o projeto

O UnrealAgentPlayer é um conjunto de ferramentas projetado para permitir que agentes de codificação de IA (como Claude Code, Cursor ou Claude Desktop) interajam com o Unreal Editor de forma autônoma. Ele consiste em um plugin de editor C++ e um servidor MCP (Model Context Protocol) em Python, permitindo que os agentes executem um ciclo completo de edição, compilação, execução e verificação de alterações sem intervenção humana. As principais capacidades incluem: - Controle de PIE: Iniciar, parar, pausar e retomar sessões de Play-In-Editor. - Injeção de Entrada: Injetar entradas de teclado, mouse, gamepad e controladores de VR diretamente na viewport do jogo, independentemente do foco da janela. - Observação: Capturar logs com filtragem, ler texto de UI UMG na tela e tirar capturas de tela da viewport. - Introspecção: Encontrar atores, obter/definir propriedades e executar scripts de editor Python ou comandos de console arbitrários. - Rastreamento de Desempenho: Ler tempos de draw/GPU em tempo real e salvar/comparar baselines de desempenho para detectar regressões. - Framework de Testes: Autodescoberta de helpers de teste em Blueprint/C++ específicos do projeto e geração de relatórios de execução detalhados em HTML. - Automação do Editor: Controlar menus nativos do editor via Windows UIAutomation. O sistema suporta Unreal Engine 5.6, 5.7 e 5.8 (incluindo o fork Meta 5.7) no Windows. Ele utiliza Remote Control HTTP e Python Remote Execution para a comunicação entre o servidor MCP e o editor.