Your AI-powered development assistant — right inside the Unreal Editor.
Chat with an AI that can read, create, and modify Blueprints, materials, assets, actors, levels, lighting, procedural geometry, environment volumes, and splines. It sees your viewport, knows what you've selected, controls the editor (PIE, undo/redo, console commands), and executes multi-step tasks autonomously — all from a familiar dockable chat panel.
Version: 1.0 | Engine: Unreal Engine 5.5+ | Platforms: Windows 64-bit (Mac/Linux supported)
Setup tutorial video: Unreal AI Copilot Setup Tutorial
More info and guides at Unreal AI Copilot homepage
Why Unreal AI Copilot?
Building in Unreal Engine means juggling dozens of editor workflows — Blueprints, materials, actor placement, level setup, lighting, property tweaks. Every task requires navigating menus, panels, and details views.
Unreal AI Copilot lets you describe what you want in plain English and watches it happen. The AI understands your project structure, sees your viewport, and uses 23 specialized editor tools with ~177 sub-actions to carry out complex multi-step operations — from wiring Blueprint graphs to authoring materials to building procedural geometry to configuring environment volumes.
It's not a code generator that dumps text into your clipboard. It's an autonomous agent that operates directly inside the editor, plans its approach, executes step by step, and reports back.
Talk to Your Editor
Type natural language in the chat panel. The AI streams its response in real-time and takes action using built-in editor tools. No copy-pasting, no manual steps.
Plan → Execute Architecture
Complex requests are automatically broken into discrete tasks. The AI first discovers your project state with read-only tools, creates a plan, then executes each task sequentially — with full visibility into progress.
Requirements
Unreal Engine 5.5 or later
An API key for at least one LLM provider (or a running local model server)
Windows 64-bit (Mac and Linux are supported but less tested)
Quick Start:
1. Install the Plugin
Install from the Fab Marketplace. The plugin appears at Plugins/UnrealAICopilot/ and is enabled by default.
2. Set Your API Key
API keys are read from environment variables — they are never written to project config files.
Windows (recommended — persists across reboots):
setx OPENAI_API_KEY "sk-..."
Then restart the editor for the variable to take effect.
Windows (GUI method):
Press Win + R, type sysdm.cpl, press Enter.
Go to Advanced → Environment Variables…
Under User variables, click New…
Variable name: OPENAI_API_KEY — Variable value: sk-...
Click OK, restart the editor.
Linux / macOS:
# Add to ~/.bashrc, ~/.zshrc, or ~/.profile: export OPENAI_API_KEY="sk-..."
Restart your terminal and editor.
3. Open the Chat Panel
Menu: Tools → AI Copilot
Toolbar: Click the AI Copilot button in the main editor toolbar
4. Start Chatting
Type a message and press Enter. The AI responds in real-time.
Configuration
All settings are accessible via Project Settings → Plugins → AI Copilot.
API Key Security
API keys are never written to project config files. They are read at runtime from the environment variable specified in settings. This prevents accidental commits to source control.
Usage Guide
Basic Chat
Open the chat panel (Tools → AI Copilot, or the toolbar button).
Type a message and press Enter (Shift+Enter for newline).
The AI responds in real-time with streaming text.
Click Clear to reset the conversation.
Click Cancel to abort an in-flight request.
Pinned Assets
Right-click any asset in the Content Browser and select "Add to AI Context". Pinned assets appear as chips above the chat input, giving the AI persistent awareness of the assets you're working with.
Viewport Screenshots
If Auto Include Viewport is enabled, a screenshot is attached to every message automatically. Otherwise, the AI captures the viewport on demand when it needs visual context.
Requires a vision-capable model (e.g., GPT-4o, Claude Sonnet 4).
Conversation History
Click the history toggle button to open the side panel. Load or delete saved conversations. History is stored locally in Saved/AICopilot/Conversations/.