Este e um resumo de alto nivel das principais funcionalidades do plugin. Para uma lista mais detalhada dos recursos disponiveis atualmente, voce pode conferir a lista estendida de recursos.

Resumo dos Recursos (Em Resumo)

Esta e uma visao geral de alto nivel das funcionalidades principais.

• Arquitetura e Analise Universal de Assets: Gere, modifique, refatore e obtenha explicacoes detalhadas para Blueprints, Materiais, Behavior Trees, Animation Blueprints e Widget Blueprints. Exporte qualquer resumo para o disco para documentacao.
• Gerenciamento de Projetos e Assets: Crie novos assets em tempo real, incluindo Structs, Enums, Blueprints e pastas, diretamente de um prompt.
• Direcao de Cena em Tempo Real: Spawne, selecione e manipule actors diretamente no viewport do nivel com comandos de conversa. (Experimental)
• Design de UI Conversacional: Projete e prototipe layouts UMG inteiros, crie widgets individuais e modifique suas propriedades usando linguagem natural. (Experimental)
• Inteligencia em Todo o Projeto: Escaneie todo o seu projeto (Blueprints, Materiais, etc.) para encontrar pontos criticos de performance e faca perguntas contextuais sobre sua base de codigo.
• Analise de C++ Externo: Leia e escreva em arquivos fonte C++ externos (.cpp/.h) para analisar ou modificar bases de codigo externas.

Depois de adquirir o plugin, voce simplesmente precisa abrir o Epic Games Launcher, acessar sua Biblioteca do Unreal Engine, procurar por este plugin e instala-lo na engine.

Abra o Unreal Engine e acesse a aba de Plugins.

Habilite o BP Generator e certifique-se de que esses outros plugins estejam habilitados e reinicie o editor.

Reinicie o Editor.

E isso, voce pode usar o plugin imediatamente, mas continue lendo os seguintes detalhes:

O plugin por padrao tem ~100k tokens de uso gratuito atraves de uma chave de API que adicionei. Quando esses ~100k tokens acabarem, voce tera que trazer sua propria chave de API. Voce pode usar praticamente qualquer provedor e tambem pode conectar o plugin a um LLM local se sua maquina for poderosa o suficiente.

O Gemini oferece uma chave de API gratuita. Mais detalhes sobre Chaves de API na secao CHAVES DE API.

A versao 0.3.5 lancada em 26 de Janeiro integra completamente o plugin dentro do Unreal Editor sem a necessidade de usar aplicativos de terceiros e conexoes como Claude Desktop, Cursor ou conectar o plugin com a extensao do navegador ao DeepSeek.

O plugin ainda pode ser usado como de costume atraves do Claude Desktop e outros aplicativos de desktop como Cursor, Github Copilot, Google Antigravity etc. E LLMs Locais (com a versao 0.3.5).

CONFIGURACAO DA CHAVE DE API DO GOOGLE GEMINI (gratuita e recomendada)

Video de Visao Geral

Acesse o site do Google Studio para criar uma nova chave de API.

Clique no botao Create API key.

Segunda opcao se voce nao tiver nenhum projeto criado no google cloud ainda.

Copie a chave gerada e volte ao seu projeto Unreal Engine.

Adicione a chave e Salve.

CONFIGURACAO DA CHAVE DE API OPEN AI (chatgpt)

Embora eu recomende o Gemini, o OpenAI tambem e uma opcao viavel.

Acesse https://platform.openai.com/usage.

Apos fazer login, clique no texto Edit Budget dentro da aba Usage.

Na nova janela que abriu, procure pela secao Billing.

Selecione Add to credit balance e voce pode escolher o credito minimo de 5$. Depois de adicionar saldo de credito, voce pode acessar a secao de chaves de API e criar uma nova chave.

Copie a chave gerada e va para o seu projeto Unreal Engine.

A chave de API do Claude, DeepSeek funciona da mesma forma que o OpenAi - voce precisa adicionar alguns creditos no site deles para a chave de API funcionar ou pode ter uma assinatura valida neles e deve conseguir obter uma chave.

Esta opcao e modular e funcionara com praticamente qualquer provedor de chave de API. Testei com Z.ai e Venice.ai.

Para a opcao de provedor personalizado, voce precisa preencher o endpoint da API, o nome do modelo e tambem a Chave de API. Voce encontrara esses detalhes no site do provedor.

O Ultimate Blueprint Generator suporta servidores locais compativeis com OpenAI como Ollama e LM Studio. Isso permite uso offline, privacidade aprimorada e sem custos de API.

IMPORTANTE: A URL do Endpoint

Seu endpoint DEVE terminar com /v1/chat/completions para o plugin funcionar corretamente.

NAO use caminhos como /chat, /generate, ou apenas a URL base. Esses nao funcionarao.

Configuracao do Ollama

Passo 1: Instalar e Executar o Ollama

1. Baixe de ollama.ai e instale
2. Baixe um modelo: ollama pull llama3.2
3. Execute o modelo: ollama run llama3.2
4. O Ollama inicia automaticamente seu servidor de API em segundo plano

Passo 2: Configurar no Plugin

Nas configuracoes de API do plugin:

• Provedor: Selecione Custom API Provider
• URL do Endpoint da API: http://localhost:11434/v1/chat/completions
• Nome do Modelo: Na visualizacao principal do Blueprint Generator, insira seu modelo (ex: llama3.2)

Configuracao do LM Studio

Passo 1: Iniciar o Servidor

1. Abra o LM Studio e va para a aba Local Server (icone </>)
2. Selecione um modelo no menu suspenso para carrega-lo
3. Clique no botao Start Server

Passo 2: Configurar no Plugin

Nas configuracoes de API do plugin:

• Provedor: Selecione Custom API Provider
• URL do Endpoint da API: http://localhost:1234/v1/chat/completions
• Nome do Modelo: Na visualizacao principal, insira o nome exato do modelo mostrado no menu suspenso do LM Studio

Solucao de Problemas

Problemas de conexao?

• Certifique-se de que seu servidor local esta realmente em execucao antes de enviar requisicoes
• Verifique se a URL termina com /v1/chat/completions (NAO /chat ou /generate)
• Verifique se a porta corresponde (Ollama: 11434, LM Studio: 1234 por padrao)
• Para maquinas em rede, substitua localhost pelo IP (ex: http://192.168.1.50:11434/v1/chat/completions)
• Verifique se seu firewall nao esta bloqueando a conexao

Por que /v1/chat/completions?

O plugin usa o formato de API OpenAI, que e o padrao para servidores LLM locais. O endpoint /v1/chat/completions fornece respostas JSON estruturadas que o plugin pode analisar corretamente. Outros endpoints como /chat ou /generate usam formatos diferentes e nao funcionarao.

Modelos Locais Testados

• Ollama minimax m2

Baixe e instale do site deles: https://claude.ai/download

Uma vez instalado, execute-o e procure por Configuracoes:

Nas configuracoes, va para Extensoes -> Configuracoes Avancadas

Instalar Extensao:

E va para onde a nova versao do plugin esta instalada em seu computador. (exemplo: C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/Extensions). E adicione-os um por um:

Uma vez instalados ambos, voce deve ve-los em execucao na aba Developer.

Prepare o Claude dizendo “how to use the connected tools?”

Este e o arquivo de configuracao MCP padrao, mas voce precisa alterar o caminho para apontar para onde o Epic instalou o plugin:

{
  "mcpServers": {
    "unreal-handshake": {
      "command": "python",
      "args": [
        "C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/mcp_main_server.py",
        "--server-name",
        "unreal-handshake"
      ],
      "env": {
        "UNREAL_HOST": "localhost",
        "UNREAL_PORT": "9877"
      }
    },
    "filesystem-access": {
      "command": "python",
      "args": [
        "C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/mcp_main_server.py",
        "--server-name",
        "filesystem-access"
      ]
    }
  }
}

!! O caminho que voce vai copiar tem barras \ em vez de barras /. Certifique-se de substituir \ por / !!

Se voce encontrar dificuldades, consulte uma IA e ela podera orienta-lo mais a configurar seu aplicativo de escolha.

Voce pode personalizar o comportamento da IA adicionando instrucoes personalizadas que serao enviadas com cada requisicao.

Acessando Instrucoes Personalizadas

Clique no botao “Instructions” dentro da interface do Plugin no Unreal Editor.

Adicionando Suas Instrucoes

Na aba recem-aberta, voce podera anexar suas instrucoes personalizadas. Essas instrucoes sao enviadas com cada requisicao para a IA, permitindo que voce modifique o comportamento da IA para atender as suas necessidades especificas.

Muito mais opcoes de personalizacao serao adicionadas em atualizacoes futuras.

Se voce estiver usando a chave de API gratuita do Gemini, pode encontrar certos codigos de erro devido a limitacao de taxa.

Codigos de Erro Comuns

Voce pode verificar a documentacao oficial de codigos de erro aqui: Solucao de Problemas da API Gemini

Lidando com Limites de Taxa (Erro 429)

Se voce encontrar um erro 429 (Rate Limit):

• Crie multiplas chaves de API gratuitas usando contas Google diferentes
• Em uma atualizacao futura, uma forma facil de alternar entre chaves de API sera adicionada
• Combine o nivel gratuito do Gemini com o nivel gratuito do Claude Desktop para minimizar limitacoes
• Considere usar um LLM Local para uso offline sem custos de API

Para mais detalhes ou ajuda, entre no Servidor Discord.