An AI teammate that acts on your projectUm colega de IA que age no seu projeto
NexusForge AI is a dockable chat panel that lives inside the Unreal Editor. You describe what you want; it understands text and images, plans the work, and then actually does it through real editor tools — creating assets, writing code, building levels, fixing compile errors — while a safety layer keeps you in control of every change. O NexusForge AI é um painel de chat acoplável que vive dentro do Editor da Unreal. Você descreve o que quer; ele entende texto e imagens, planeja o trabalho e então realmente o executa por meio de ferramentas reais do editor — criando assets, escrevendo código, montando níveis, corrigindo erros de compilação — enquanto uma camada de segurança mantém você no controle de cada mudança.
Just talk to itÉ só conversar
Plain language, no nodes or scripting required. Drag in concept art or screenshots and it understands them.Linguagem natural, sem precisar de nós ou scripts. Arraste concept art ou prints e ele entende.
It does the workEle faz o trabalho
Blueprints, C++, materials, terrain, foliage, actors, 3D models — created right in your project.Blueprints, C++, materiais, terreno, folhagem, atores, modelos 3D — criados direto no seu projeto.
You stay in controlVocê no controle
Every change that touches your project asks for approval first, and can be rolled back.Toda mudança que mexe no projeto pede aprovação antes, e pode ser desfeita.
What you needO que você precisa
- Unreal Engine 5.7 (the plugin is packaged for 5.7).Unreal Engine 5.7 (o plugin é empacotado para a 5.7).
- A C++ project is recommended (so the agent can create & compile C++). Blueprint-only projects still work for most features.Um projeto C++ é recomendado (para o agente criar e compilar C++). Projetos só de Blueprint funcionam para a maioria dos recursos.
- On Windows, Visual Studio 2022 if you want C++ compiling / Live Coding.No Windows, Visual Studio 2022 se quiser compilar C++ / Live Coding.
- An API key from at least one provider (Claude recommended) — or a local Ollama install for 100% free/offline use.Uma chave de API de pelo menos um provedor (Claude recomendado) — ou o Ollama instalado localmente para uso 100% grátis/offline.
The plugin auto-enables the helper plugins it needs: Python Editor Script Plugin, SQLite, Editor Scripting Utilities and Landscape. You don't have to turn these on manually.O plugin habilita sozinho os plugins de apoio que precisa: Python Editor Script Plugin, SQLite, Editor Scripting Utilities e Landscape. Você não precisa ativar isso na mão.
Install from FabInstalar pela Fab
After buying / getting NexusForge AI on Fab, you add it to a project in a few clicks.Depois de comprar / obter o NexusForge AI na Fab, você o adiciona a um projeto em poucos cliques.
Open fab.com, find NexusForge AI in your purchases and click Add to Library.Abra fab.com, encontre o NexusForge AI nas suas compras e clique em Adicionar à Biblioteca.
In the Epic Games Launcher → Unreal Engine → Library, find it under Fab Library and click Install to Engine, choosing your 5.7 install.No Epic Games Launcher → Unreal Engine → Biblioteca, encontre-o em Biblioteca da Fab e clique em Instalar na Engine, escolhendo sua instalação 5.7.
Open your project, then Edit → Plugins, search NexusForge, tick the checkbox and restart the editor when asked.Abra seu projeto, vá em Edit → Plugins, procure NexusForge, marque a caixinha e reinicie o editor quando pedir.
NexusForge appears in the Tools menu and on the toolbar. Continue to Open the workspace.O NexusForge aparece no menu Tools e na barra de ferramentas. Siga para Abrir o workspace.
Tip: always use version control (Git / Perforce) and commit before big AI runs. Snapshots are a safety net, not a replacement for source control.Dica: sempre use controle de versão (Git / Perforce) e faça commit antes de grandes execuções da IA. Snapshots são uma rede de segurança, não substituem o controle de versão.
Open the workspaceAbrir o workspace
There are three ways to open the NexusForge panel:Há três formas de abrir o painel do NexusForge:
- Menu Tools → NexusForge AIMenu Tools → NexusForge AI
- The toolbar button (hammer icon)O botão da barra de ferramentas (ícone do martelo)
- Keyboard shortcut Ctrl + Alt + NAtalho de teclado Ctrl + Alt + N
The panel is fully dockable — drag its tab to dock it beside the Level, Blueprint, Material or Animation editors, or float it on a second monitor.O painel é totalmente acoplável — arraste a aba para encaixá-lo ao lado dos editores de Nível, Blueprint, Material ou Animação, ou solte-o flutuando em um segundo monitor.
Interface tourTour da interface
Chat & streamingChat e streaming
Answers stream live, with rich text and copyable code blocks. A live status shows what it's doing (Reading Project → Building Context → Generating Code → Updating Assets → Reviewing).As respostas aparecem ao vivo, com texto formatado e blocos de código copiáveis. Um status ao vivo mostra o que ele está fazendo (Lendo Projeto → Montando Contexto → Gerando Código → Atualizando Assets → Revisando).
Agent selectorSeletor de agente
Leave it on Auto to let it pick the right specialist, or force one (World Builder, Gameplay, Terrain…).Deixe em Auto para ele escolher o especialista certo, ou force um (World Builder, Gameplay, Terrain…).
Tool timelineLinha do tempo de ferramentas
Each action shows as a chip: running, done, failed or awaiting approval — so you always see what it touched.Cada ação vira um chip: executando, concluído, falhou ou aguardando aprovação — você sempre vê o que ele mexeu.
History sidebarBarra de histórico
A collapsible left rail groups your conversations by date (Today / Yesterday / Previous 7 days / Older), with search.Uma barra lateral retrátil agrupa suas conversas por data (Hoje / Ontem / Últimos 7 dias / Mais antigas), com busca.
Attach & captureAnexar e capturar
📎 attach image files, 🖼 capture the viewport, or drag assets/files straight onto the window.📎 anexe imagens, 🖼 capture a viewport, ou arraste assets/arquivos direto para a janela.
Project Context cardCartão de Contexto do Projeto
A live card shows the current project, open assets and context size, so the AI's awareness is transparent.Um cartão ao vivo mostra o projeto atual, assets abertos e tamanho do contexto, deixando claro o que a IA "enxerga".
Settings & your API keyConfigurações e sua chave de API
Everything is configured in Project Settings → Plugins → NexusForge AI.Tudo é configurado em Project Settings → Plugins → NexusForge AI.
Add an API keyAdicionar uma chave de API
Under Providers, enable the one you want — Claude, OpenAI, Gemini, DeepSeek, a custom endpoint, or free local Ollama (no key needed).Em Providers, ative o que você quer — Claude, OpenAI, Gemini, DeepSeek, um endpoint personalizado, ou o Ollama local grátis (sem chave).
Paste it into the API Key field and save.Cole no campo API Key e salve.
On save the key is AES-256 encrypted to Saved/NexusForge/credentials.bin, the field is cleared, and Key Configured turns true. The plaintext is never written to .ini, logged, or shown again.Ao salvar, a chave é criptografada com AES-256 em Saved/NexusForge/credentials.bin, o campo é limpo e Key Configured fica verdadeiro. O texto puro nunca vai para .ini, nunca é logado nem mostrado de novo.
No environment variables, no config files to edit by hand. Ollama needs no key at all.Sem variáveis de ambiente, sem arquivos de config para editar na mão. O Ollama não precisa de chave nenhuma.
Settings referenceReferência de configurações
| SettingConfiguração | What it doesO que faz |
|---|---|
| Providers | Enable backends, set default model & base URL, paste the encrypted API key.Ativa os backends, define modelo padrão e URL base, cola a chave criptografada. |
| Routing | Map each task class (Reasoning / Coding / Vision / Fast / Embedding) to a provider+model, with ordered fallbacks.Mapeia cada tipo de tarefa (Raciocínio / Código / Visão / Rápido / Embedding) para um provedor+modelo, com fallbacks em ordem. |
| Offline Mode | Force everything onto local Ollama.Força tudo para o Ollama local. |
| Require Approval For Mutations | Ask before every change to your project (recommended ON).Pergunta antes de cada mudança no projeto (recomendado LIGADO). |
| Auto Snapshot Before Batch | Snapshot before each risky batch so it can be rolled back.Faz snapshot antes de cada lote arriscado para poder reverter. |
| Hard Blocked Tool Patterns | Wildcards that are never allowed, even if approved (e.g. *DeleteProject*).Padrões curinga nunca permitidos, mesmo se aprovados (ex.: *DeleteProject*). |
| Max Autonomous Iterations | How many steps it may take before pausing for you.Quantos passos ele pode dar antes de pausar e te chamar. |
| Memory | Turn long-term memory on/off and set retrieval Top-K.Liga/desliga a memória de longo prazo e define o Top-K de recuperação. |
| 3D Generators | Configure Meshy / Tripo / Local mesh generation (separate encrypted keys).Configura geração de malhas Meshy / Tripo / Local (chaves criptografadas próprias). |
Providers, models & offlineProvedores, modelos e offline
NexusForge is not tied to any single AI. It talks to several backends and routes each kind of task to the best one, falling back automatically if one is down — so you're never locked in.O NexusForge não depende de uma única IA. Ele fala com vários backends e direciona cada tipo de tarefa para o melhor, caindo para outro automaticamente se um falhar — você nunca fica preso a um só.
Use your own AI for free. With local Ollama models there are no API fees and no usage limits — everything runs on your own machine, fully offline and private. Cloud providers are optional: you only pay for what you use, with your own key.Use sua própria IA de graça. Com modelos locais do Ollama não há nenhuma taxa de API nem limite de uso — tudo roda na sua própria máquina, 100% offline e privado. Provedores em nuvem são opcionais: você só paga pelo que usar, com a sua própria chave.
Claude
Anthropic Opus / Sonnet / Haiku — great for reasoning, coding & vision.Anthropic Opus / Sonnet / Haiku — ótimo para raciocínio, código e visão.
OpenAI · Gemini · DeepSeek
Drop-in alternatives; set the model in settings.Alternativas diretas; defina o modelo nas configurações.
Custom (OpenAI-compatible)Personalizado
Point it at any OpenAI-style endpoint (e.g. Qwen). Just set Base URL + model.Aponte para qualquer endpoint estilo OpenAI (ex.: Qwen). Defina Base URL + modelo.
Which AIs can I use?Quais IAs posso usar?
- Anthropic Claude — Opus, Sonnet, Haiku
- OpenAI — GPT / Codex modelsmodelos GPT / Codex
- Google Gemini
- DeepSeek
- Any OpenAI-compatible endpoint via “Custom” — e.g. Qwen, Mistral or your own gatewayQualquer endpoint compatível com OpenAI via “Custom” — ex.: Qwen, Mistral ou seu próprio gateway
- Local Ollama — free & offline — DeepSeek-Coder, Qwen-Coder, Llama, Gemma, Mistral, LLaVA (vision)Ollama local — grátis & offline — DeepSeek-Coder, Qwen-Coder, Llama, Gemma, Mistral, LLaVA (visão)
💸 100% free, local & offline (Ollama)💸 100% grátis, local e offline (Ollama)
Zero cost, full privacy. Run models on your own machine with Ollama, then enable the Ollama provider (or turn on Offline Mode). It's keyless, has no usage limits and uses your GPU automatically.Custo zero, privacidade total. Rode modelos na sua própria máquina com Ollama, depois ative o provedor Ollama (ou ligue o Offline Mode). Não precisa de chave, não tem limite de uso e usa sua GPU automaticamente.
# start the local serverinicie o servidor local ollama serve # pull a few modelsbaixe alguns modelos ollama pull deepseek-coder-v2 ollama pull qwen2.5-coder:7b ollama pull nomic-embed-text # memory embeddingsembeddings da memória ollama pull llava # visionvisão
Your first conversationSua primeira conversa
e.g. "Create a C++ HealthComponent with replicated health and a death event, then compile." Press Ctrl+Enter or click Send.ex.: "Crie um HealthComponent em C++ com vida replicada e um evento de morte, depois compile." Aperte Ctrl+Enter ou clique em Enviar.
It streams its reasoning, then runs tools. Read-only steps run freely; anything that changes your project pauses for approval.Ele transmite o raciocínio e então executa ferramentas. Passos só de leitura rodam livres; qualquer coisa que mude o projeto pausa para aprovação.
Approve the change, or hit Stop anytime. Start fresh with New.Aprove a mudança, ou clique em Stop a qualquer momento. Recomece com New.
The 14 expert agentsOs 14 agentes especialistas
Each agent has its own expertise and tools. Leave the selector on Auto and the Architect routes your request to the right specialist — or pick one yourself.Cada agente tem sua própria especialidade e ferramentas. Deixe o seletor em Auto e o Architect encaminha seu pedido ao especialista certo — ou escolha um você mesmo.
What it can do — the toolsO que ele faz — as ferramentas
Tools are the only way the AI changes your project — there's no hidden code-exec path. Every tool has a risk level that decides whether it needs your approval:As ferramentas são o único jeito de a IA mudar seu projeto — não há caminho oculto de execução. Cada ferramenta tem um nível de risco que decide se precisa da sua aprovação:
Just reads/looks. Never needs approval.Só lê/observa. Nunca pede aprovação.
Changes your project. Gated by your approval policy.Muda seu projeto. Controlado pela sua política de aprovação.
Delete/overwrite. Always asks.Apagar/sobrescrever. Sempre pergunta.
Runs code (Python / generators). Always asks.Executa código (Python / geradores). Sempre pergunta.
📁 Project, files & configuration📁 Projeto, arquivos e configuração
Beyond the typed tools below, the agent can create folders and files, edit existing files, configure the project and edit Blueprint graphs in depth. These deeper operations run through the RunPython automation tool, which always asks for approval and shows you exactly what it will run.Além das ferramentas tipadas abaixo, o agente pode criar pastas e arquivos, editar arquivos existentes, configurar o projeto e editar grafos de Blueprint a fundo. Essas operações mais profundas passam pela ferramenta de automação RunPython, que sempre pede aprovação e mostra exatamente o que vai rodar.
🧩 Blueprints🧩 Blueprints
Creates a new Blueprint deriving from a parent class (Actor, Pawn, Character, ActorComponent…) in the folder you want.Cria um novo Blueprint derivando de uma classe-pai (Actor, Pawn, Character, ActorComponent…) na pasta que você quiser.
Deep Blueprint editing — adding variables, components, functions and wiring graph nodes — is done through the Python automation tool. Always approval-gated.A edição profunda de Blueprint — adicionar variáveis, componentes, funções e ligar nós do grafo — é feita pela ferramenta de automação Python. Sempre com aprovação.
⌨️ C++ & building⌨️ C++ e build
Generates a new C++ class — header and source — wired into your project's game module.Gera uma nova classe C++ — header e source — integrada ao módulo de jogo do seu projeto.
Triggers a compile of your C++ modules and reports the real result (so the Debug agent can fix errors and recompile).Dispara a compilação dos seus módulos C++ e reporta o resultado real (para o agente Debug corrigir erros e recompilar).
🧪 Materials🧪 Materiais
Creates a new Material (base color, optional metallic/roughness) and parameterized instances.Cria um novo Material (cor base, metallic/roughness opcionais) e instâncias parametrizadas.
🌍 World building🌍 Construção de mundo
Spawns one or more actors (meshes, lights, props) into the current level at the transforms you describe.Coloca um ou mais atores (malhas, luzes, props) no nível atual nas transformações que você descrever.
Creates a Landscape actor and sculpts it from procedural noise or an imported heightmap.Cria um ator Landscape e o esculpe a partir de ruído procedural ou de um heightmap importado.
Scatters static-mesh instances across an area to build ecosystems.Espalha instâncias de static mesh por uma área para montar ecossistemas.
🧊 3D model generation🧊 Geração de modelos 3D
Generates a 3D model from a text prompt (or image) using Meshy, Tripo or a local generator, then imports the mesh straight into your project.Gera um modelo 3D a partir de um prompt de texto (ou imagem) usando Meshy, Tripo ou um gerador local, e importa a malha direto no seu projeto.
🔎 Read & understand the project🔎 Ler e entender o projeto
Reads the editor log to diagnose errors & crashes.Lê o log do editor para diagnosticar erros e crashes.
Lists assets in your project so it knows what exists.Lista os assets do projeto para saber o que existe.
Recalls earlier facts, decisions & style rules.Relembra fatos, decisões e regras de estilo anteriores.
⚙️ The power tool⚙️ A ferramenta-curinga
Runs Python inside the editor for tasks without a dedicated tool — file/folder operations, project config, deep Blueprint work, sequencer, Niagara, World Partition, bulk edits. Always shows the snippet and asks before running.Roda Python dentro do editor para tarefas sem ferramenta dedicada — operações de arquivo/pasta, config do projeto, Blueprint a fundo, sequencer, Niagara, World Partition, edições em massa. Sempre mostra o trecho e pergunta antes de rodar.
Example promptsExemplos de prompts
Copy, tweak, send. Be specific about names, folders and parent classes for best results.Copie, ajuste, envie. Seja específico com nomes, pastas e classes-pai para melhores resultados.
World Builder
Terrain
Gameplay
Debug
Material
NPC / AI
Safety & approvalsSegurança e aprovações
Every change funnels through one safety checkpoint. The AI never deletes your project, overwrites critical files without approval, or modifies engine files.Toda mudança passa por um único ponto de checagem de segurança. A IA nunca apaga seu projeto, sobrescreve arquivos críticos sem aprovação, nem modifica arquivos da engine.
Approval dialogDiálogo de aprovação
Mutating actions pop up a dialog showing the exact tool name and arguments before anything happens.Ações que mudam o projeto abrem um diálogo mostrando o nome exato da ferramenta e os argumentos antes de algo acontecer.
Pre-batch snapshotsSnapshots antes do lote
It can snapshot your source before risky batches so changes can be undone.Ele pode fazer snapshot do seu código antes de lotes arriscados para poder desfazer.
RollbackReversão
Reversible operations are logged and can be rolled back.Operações reversíveis são registradas e podem ser desfeitas.
Safe modeModo seguro
Forces approval for everything that mutates.Força aprovação para tudo que muda algo.
Hard-block patternsBloqueio definitivo
Patterns that can never run, even if approved.Padrões que nunca podem rodar, mesmo se aprovados.
Headless denyNegação sem UI
With no UI to approve (CI/headless), mutating ops are denied by default.Sem UI para aprovar (CI/headless), operações de mudança são negadas por padrão.
It remembers your projectEle lembra do seu projeto
NexusForge keeps long-term memory of project facts, decisions, your coding/art style and past conversations. Each turn it retrieves the most relevant memories and uses them — so it stays consistent over days and weeks. Each agent has its own memory namespace.O NexusForge mantém uma memória de longo prazo de fatos do projeto, decisões, seu estilo de código/arte e conversas passadas. A cada turno ele recupera as memórias mais relevantes e as usa — assim ele fica consistente ao longo de dias e semanas. Cada agente tem seu próprio espaço de memória.
Memory is stored locally in your project (Saved/NexusForge/). Run embeddings on local Ollama (nomic-embed-text) to keep it private and free.A memória fica salva localmente no seu projeto (Saved/NexusForge/). Rode os embeddings no Ollama local (nomic-embed-text) para mantê-la privada e gratuita.
Tips for great resultsDicas para bons resultados
- Use version control and commit before big autonomous runs — snapshots are a net, not a replacement.Use controle de versão e faça commit antes de grandes execuções autônomas — snapshots são uma rede, não substituto.
- Keep approvals ON for shared/team projects; reserve Python & destructive tools for trusted users.Mantenha as aprovações LIGADAS em projetos de equipe; reserve Python e ferramentas destrutivas para usuários de confiança.
- Be specific: name your assets, target folders and parent classes.Seja específico: nomeie seus assets, pastas de destino e classes-pai.
- Route smart: a strong model for coding/reasoning, a cheap or local model for bulk/utility tasks.Roteie com cabeça: um modelo forte para código/raciocínio, um barato ou local para tarefas em massa/utilitárias.
- Cap autonomy and watch the timeline during big world-gen tasks.Limite a autonomia e acompanhe a linha do tempo em grandes tarefas de geração de mundo.
- Attach references — concept art and screenshots dramatically improve the output.Anexe referências — concept art e prints melhoram muito o resultado.
Video tutorialsVídeo tutoriais
Watch NexusForge in action. (To add your own videos, see videos/LEIA-ME_READ-ME.txt — paste a YouTube embed or drop a local .mp4.)Veja o NexusForge em ação. (Para colocar seus vídeos, veja videos/LEIA-ME_READ-ME.txt — cole um embed do YouTube ou solte um .mp4 local.)
FAQ & troubleshootingFAQ e solução de problemas
Do I need to pay for an API?Preciso pagar por uma API?
Cloud providers (Claude, OpenAI…) charge for usage with your own key. Or run everything free and offline with local Ollama models — no key, no cost.Provedores em nuvem (Claude, OpenAI…) cobram pelo uso com a sua chave. Ou rode tudo grátis e offline com modelos locais do Ollama — sem chave, sem custo.
Can it break or delete my project?Ele pode quebrar ou apagar meu projeto?
No. Every change is approval-gated, destructive actions always ask, hard-blocked patterns can never run, and engine files are off-limits. Still, always use version control.Não. Toda mudança passa por aprovação, ações destrutivas sempre perguntam, padrões bloqueados nunca rodam e arquivos da engine são intocáveis. Mesmo assim, sempre use controle de versão.
Where is my API key stored?Onde minha chave de API fica guardada?
AES-256 encrypted in Saved/NexusForge/credentials.bin. Never written to .ini, never logged, never shown again.Criptografada com AES-256 em Saved/NexusForge/credentials.bin. Nunca vai para .ini, nunca é logada, nunca é mostrada de novo.
I added a key but it says "no provider".Adicionei a chave mas diz "no provider".
Make sure the provider is enabled and the key saved (the field clears and Key Configured turns true). Keys are picked up live; if it still fails, restart the editor.Confirme que o provedor está ativado e a chave salva (o campo limpa e Key Configured fica verdadeiro). As chaves são lidas na hora; se ainda falhar, reinicie o editor.
The panel won't open.O painel não abre.
Confirm the plugin is enabled in Edit → Plugins and the editor was restarted. Then use Tools → NexusForge AI or Ctrl+Alt+N.Confirme que o plugin está ativado em Edit → Plugins e que o editor foi reiniciado. Depois use Tools → NexusForge AI ou Ctrl+Alt+N.
Which Unreal version?Qual versão da Unreal?
It's packaged for Unreal Engine 5.7. Use a matching engine install.É empacotado para a Unreal Engine 5.7. Use uma instalação da engine compatível.
It hit a rate limit / 429.Deu rate limit / 429.
That's a per-minute limit from the provider (it resets each minute), not your credits. NexusForge retries automatically with backoff — just wait a moment.Esse é um limite por minuto do provedor (reseta a cada minuto), não seus créditos. O NexusForge tenta de novo automaticamente com espera — é só aguardar um pouco.