uebox

Unreal Box (UE Box) é um aplicativo desktop de código aberto, posicionado como um agente de IA que opera diretamente o editor Unreal. Após o usuário configurar um provedor de modelos, ele se conecta ao editor Unreal em execução por meio do plugin UnrealAgentLink e, com mais de cem ferramentas de engine e 25 habilidades integradas, executa tarefas: posicionar Actors, modificar Blueprints, conectar materiais, compilar C++ etc. Operações comuns são executadas diretamente; operações de risco são pausadas e aguardam confirmação do usuário. Após concluir a tarefa, o agente usa ferramentas somente leitura para verificar as alterações no engine e responde item por item aos problemas encontrados. A cobertura inclui, além de levels, Blueprints, materiais, assets e C++, também retargeting de animação, UMG, câmeras do Sequencer, validação em PIE, edição de geometria e inspeção do projeto. O produto é centrado no agente; bibliotecas de projetos, assets, Blueprints e materiais, além de notas e base de conhecimento, possuem interfaces independentes e podem ser usadas separadamente, mas na estrutura do produto servem ao agente: registram alvos de ação, fornecem materiais e recebem resultados. Este repositório é a edição comunitária principal: não exige conta, não depende de servidores oficiais e pode ser totalmente compilado por conta própria. Fluxo inicial: baixe e instale a partir do GitHub Releases ou do site oficial (Windows), adicione um provedor de modelos nas configurações e insira sua própria API Key, apontando o modelo de conversa padrão para ele; o modelo precisa suportar chamada de ferramentas. Há suporte a inferência local (Ollama, LM Studio, llama.cpp) e gateways próprios (LiteLLM, One API). Em seguida, importe o .uproject na biblioteca de projetos; o plugin de conexão será instalado automaticamente no diretório Plugins/UnrealAgentLink/ do projeto e pode ser fechado ou removido. Após abrir o projeto, o plugin conecta automaticamente; na barra lateral da sessão de IA, você pode primeiro usar perguntas somente leitura (como a quantidade de luzes do level) para confirmar a conexão. Usuários que já utilizam Codex, Claude Code ou Cursor podem ativar o MCP e integrar o Unreal Box como serviço de ferramentas, obtendo assim mais de cem ferramentas de UE; o MCP só pode ser acessado localmente, exige token e, por padrão, permite escrita. Rede e dados: não há conta; as chaves são armazenadas criptografadas localmente; as requisições vão diretamente ao provedor configurado pelo usuário, sem passar por servidores do projeto. Por padrão, apenas verifica atualizações e não baixa nada; builds empacotados por conta própria sem fonte de atualização configurada não fazem requisições de rede. IA, busca online, geração de imagens e armazenamento em nuvem conectam-se conforme necessário; ao usar modelos locais, os dados de IA não saem da máquina. Suporte de plataforma: Windows oferece instalador, suporta descoberta de engines e o plugin UnrealAgentLink pré-compilado, sendo a plataforma principal; macOS exige build a partir do código-fonte, pode escanear engines em diretórios comuns de instalação compartilhada, adicionar manualmente o diretório da engine ou o .app do editor, detectar editores UE4/UE5 em execução e seus caminhos de projeto; a compilação e a validação de lançamento do plugin pré-compilado ainda não foram concluídas; Linux exige build a partir do código-fonte e a descoberta de engines ainda não foi adaptada. A stack técnica é Electron + Vue 3 + TypeScript, com suporte ao Unreal Engine 5.0 a 5.8. Para executar a partir do código-fonte, use pnpm install e pnpm dev; antes de enviar commits, execute pnpm verify, um único comando que realiza varredura de segredos, lint, lint das linhas alteradas, verificação de tipos e testes unitários, podendo ser executado com o aplicativo em execução. O repositório fornece a especificação AGENTS.md e portões de aceitação voltados a assistentes de codificação de IA; o usuário pode descrever requisitos em linguagem natural e deixar o assistente de IA ler a arquitetura, alterar o código, complementar testes e concluir a validação. Licença: o aplicativo adota a Apache License 2.0; o código-fonte do plugin UnrealAgentLink está em plugin/UnrealAgentLink e adota a licença MIT independente. Unreal Engine é marca registrada da Epic Games, Inc.; este projeto não possui vínculo com a Epic Games.