Dztfix ForgeAI for Unreal Engine

An AI co-pilot that lives inside the Unreal Editor. Talk to it in plain language and it builds, edits, inspects and automates your project for you — Blueprints, materials, levels, animation, VFX, UI and more.

270+ editor tools 3 AI agents CLI + API MCP server built in UE 5.6

Overview

ForgeAI adds an AI assistant panel to the Unreal Editor. Instead of clicking through menus, you describe what you want and the assistant performs the work directly in your open project, using safe, undoable editor actions.

ForgeAI works in two complementary ways:

Inside the editor — an embedded chat panel where you converse with an AI agent that can read and change your project.
From outside the editor — a built-in MCP server that lets external AI tools (Claude Code, Codex, Cursor, Antigravity, Windsurf) connect to your live editor and use the same capabilities.

Either way, every action runs against the project you currently have open, and every change it makes can be undone with Ctrl+Z.

What it does

A quick look at the things ForgeAI can do for you in Unreal.

🧩

Build & edit Blueprints

Create Blueprints, add variables, functions, components and nodes, and inspect existing graphs — all from a description.

🎨

Author materials

Create and modify materials and material instances and wire up parameters.

🗺️

Edit levels & actors

Spawn, move, configure and query actors in the open level, and read the level layout.

🏃

Animation & IK

Work with animation assets, blueprints and IK rigs to set up character motion.

🎬

Cinematics

Assemble Level Sequences and tracks for cutscenes and in-game cameras.

✨

Niagara VFX

Create and tweak particle systems and effects.

📊

Data & gameplay

Manage Data Tables, Gameplay Tags and Gameplay Ability System assets.

🖼️

UI (UMG)

Create and edit Widget Blueprints for menus and HUDs.

📥

Import & assets

Bring images and files into the project as assets — generated images import automatically.

🔎

Inspect & diagnose

Read the output log, query Blueprint contents and report editor state to answer questions.

Getting started

From a fresh install to your first request.

Enable the plugin. Open Edit ▸ Plugins, find Dztfix ForgeAI under the AI category, tick Enabled, and restart the editor if prompted.

Open the panel. The Dztfix ForgeAI tab opens with the editor. If it is closed, reopen it from the Tools (or Window) menu.

Pick how it answers. In Settings ▸ Integrations, choose an agent and whether it runs through its CLI or the API (see AI agents).

Ask for something. Type a request in the chat box and press Enter. ForgeAI plans the steps, performs them in your project, and shows the result.

Tip: start with a small, read-only request like "List the actors in the current level" to confirm everything is connected before making changes.

The interface

The panel has three areas.

Left sidebar

+ New Chat — start a fresh conversation (the current one is saved first).
Chat / Tool Manager / About — switch between pages.
Recent — your saved conversations; click to reopen, or the trash icon to delete one.
Status footer — shows whether the MCP server is running and how many tools are active.

Top bar

Model selector — one searchable dropdown that controls everything. Pick a CLI agent (e.g. Claude (CLI) — Opus) or an OpenRouter model (e.g. API · …) and ForgeAI switches to the right mode automatically. Type to filter.
Context meter — a rough estimate of how much of the model's context window the conversation is using.
Tools counter — opens the Tool Manager; shows enabled vs total tools.
Gear — opens Settings.

Conversation & input

Messages appear as bubbles (you on the right, ForgeAI on the left). Tool actions show as compact chips, generated images appear inline, and a "working…" indicator shows while the agent is busy. Type in the box at the bottom; Enter sends, Shift+Enter adds a new line, and the Stop button cancels a running request.

AI agents

ForgeAI can be powered by three agents, each runnable two ways. You choose per agent in Settings ▸ Integrations.

Agent	Powered by	Notes
Claude	Anthropic Claude Code	Strong general coding & editor automation.
Codex	OpenAI Codex CLI	OpenAI-based agent.
Antigravity	Google Gemini CLI	Google's agent engine.

CLI vs API CLI API

The easiest way to switch is the model selector at the top of the chat — it lists both in one place and sets the mode for you:

CLI entries (e.g. Claude (CLI) — Opus) — use the agent's own command-line tool, billed through your existing login. Best for deep, multi-step tasks.
API entries (e.g. API · Gemini 2.5 Flash) — answer through your OpenRouter key (Claude, GPT, Gemini and more). Best for fast replies.

The CLI / API switch on each Integrations card does the same thing; use whichever you prefer.

Detect, install & sign in

On the Integrations tab each agent card shows whether its CLI is detected and its version. Buttons help non-technical users get set up:

Install / Reinstall / Delete — manage the agent's command-line tool for you.
Sign in — opens a one-time login so the agent is authorised (just like signing into Claude or Codex the first time).
Active — marks which agent answers your chat.
Recheck — re-scans for installed tools (results are otherwise cached so the dialog opens instantly).

If an agent needs a one-time sign-in, ForgeAI can open the login window for you automatically when you send your first message.

Chatting & editing

How a request becomes changes in your project.

You describe a goal in plain language, e.g. "Create a health bar widget and add it to the player HUD."

ForgeAI plans and acts — it picks the right editor tools and runs them. Each tool it uses appears as a small chip so you can see what it is doing.

You review the result in the editor. Anything it changed is a normal editor edit, so you can Ctrl+Z to undo.

ForgeAI always works on the project you currently have open. Keep the level or asset you want changed loaded in the editor.

OpenRouter (API mode)

API mode answers through OpenRouter — one account gives you access to Claude, GPT, Gemini and hundreds of other models, including free ones.

How it works

When an agent is set to API, ForgeAI sends your messages (and any attached images) to OpenRouter together with its editor tools, and streams the reply back into the chat. It is the fastest way to chat, and it still lets the model use ForgeAI's tools.

Set it up

Get a key at openrouter.ai (create an account ▸ Keys ▸ create key).

Paste it into Settings ▸ OpenRouter ▸ API Key and press Save.

Pick a model in the chat selector — choose any entry starting with API · (type to filter). That's it: ForgeAI switches to API mode automatically and you can chat.

Free models

Models marked (free) cost nothing to run, but an OpenRouter API key is still required (the key identifies you, it is not a charge). Free models are rate-limited and may be slower or busier than paid ones. Some free models require enabling a privacy option in your OpenRouter account before they respond.

Prefer no key at all? Use CLI mode instead — Claude/Codex bill through your existing subscription and Gemini through a one-time Google sign-in.

What the tools do

ForgeAI ships 270+ editor tools grouped by area. You never call them by hand — the agent chooses them — but here is what they cover.

Area	What ForgeAI can do
Blueprints	Create Blueprints; add/edit variables, functions, events, components and graph nodes; query a Blueprint's contents.
Materials	Create and edit materials and material instances and their parameters.
Levels & Actors	Spawn, move, configure, select and query actors; read the level's actor list and settings.
Animation & IK	Work with animation assets, animation Blueprints and IK rigs.
Cinematics	Build Level Sequences and tracks for cutscenes and cameras.
Niagara VFX	Create and adjust particle systems and effects.
Data & GAS	Manage Data Tables, Gameplay Tags and Gameplay Ability System assets.
UI (UMG)	Create and edit Widget Blueprints for menus and HUDs.
Files & assets	Create folders, manage and import assets into the Content Browser.
Scripting	Run editor Python, console commands and editor utility scripts (gated by safety settings).
Logs & context	Read the output log incrementally and report editor/project context to answer questions.
Tasks	Run longer jobs in the background and check their status.

You can see the exact live list any time by typing /tools in the chat, or by running the forge.tools.catalog tool.

Images & screenshots

Inline image display

When ForgeAI produces or references an image file, it shows the picture directly in the conversation instead of just a path.

Automatic import

Generated images are imported into your project automatically as Texture assets (under /Game/ForgeAI/Generated) — no manual import dialog. Find them in the Content Browser.

Viewport screenshots

Type /screenshot to capture the active editor viewport. The image is saved and shown in the chat, so you can share what you are seeing with the assistant.

Attach an image to a message

Use the attach button (or paste an image with Ctrl+V) to send a picture to a vision-capable model along with your request.

Chat history

Conversations are saved automatically.

Each chat is saved as soon as you send a message and appears under Recent.
Click a recent chat to reopen its full transcript (including any images).
Press the trash icon next to a chat to delete it.
+ New Chat saves the current conversation and starts a clean one.

Slash commands

Quick built-in commands you can type in the chat — they run instantly without the AI.

Command	What it does
`/status`	Show ForgeAI / editor status.
`/tools`	List every active tool and whether it is enabled.
`/screenshot`	Capture the active viewport and show it in chat.
`/call <tool> {json}`	Run a specific tool directly with optional JSON arguments.

MCP server (connect external tools)

ForgeAI runs a standard MCP server so AI tools outside the editor can drive your live Unreal project with the same 270+ tools.

The server listens at http://127.0.0.1:13377/mcp (the port is configurable in Settings ▸ MCP Server). The Integrations tab has one-click buttons that configure popular clients for you:

Install for Claude Code, Codex, Cursor, Antigravity — writes the connection into that client's config automatically.

After connecting, fully restart the client. The Unreal editor must stay open with the plugin enabled while the external tool works.

Optional security: set a Bearer token in Settings ▸ MCP Server and connecting clients must present it.

Tool Manager

Choose which capabilities ForgeAI is allowed to use.

Open it from the sidebar or the tools counter in the top bar. Each tool can be switched on or off; disabled tools are hidden from the agent and from external MCP clients. Use this to keep a project locked down to only the actions you want available.

Settings reference

Everything in the Settings dialog, tab by tab.

Tab	What you control
General	Default provider and generation parameters (temperature, top-p, max tokens, tool-iteration limit), parallel tool calls, debug mode, auto-save before edits, and auto-execute scripts.
Integrations	The AI agents (detect, install, sign in, CLI/API, Active), shell-execution blocking, auto-approve (YOLO), and one-click MCP setup for external clients.
MCP Server	Enable the server, set its port and an optional Bearer token, and copy the connection URL.
Voice	Voice-input settings (stored for an upcoming milestone).
OpenRouter	Your API key and the model used for API mode / chat. The model list is searchable.
About	Version, install path and copyright information.

Safety & permissions

↩️

Undoable

Every change ForgeAI makes is a standard editor edit — undo with Ctrl+Z.

✋

Confirmation prompts

Destructive actions ask for confirmation in the editor, unless you enable Auto-Approve.

🛡️

Block shell execution

Optionally reject any script that spawns processes or deletes files.

💾

Auto-save before edits

Optionally save your work before the assistant changes the project.

Auto-Approve ("YOLO mode") skips confirmation dialogs so the agent can work unattended. Turn it on only when you trust the task.

Requirements

Unreal Engine 5.6 (Editor).
The editor must be running with the plugin enabled.
For CLI agents: the matching command-line tool installed and signed in (ForgeAI can do both for you). Node.js is required to install CLI tools and for some MCP bridges.
For API mode: an OpenRouter API key (entered in the OpenRouter tab).

Legal

This product is not affiliated with or endorsed by Epic Games, Inc. Claude, Codex and Gemini are products of their respective owners; you are responsible for complying with their terms when you connect them.