unreal-instructions

Routes Unreal Engine tasks across dual MCP servers for Blueprint, C++, and editor automation.

Updated May 29, 2026
One-click install
npx skills add https://github.com/JanVogelsang/UE-AgentFramework --skill unreal-instructions-janvogelsang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unreal-instructions
Source: https://github.com/JanVogelsang/UE-AgentFramework/tree/main/UnrealEngine/skills/unreal-instructions
Command: npx skills add https://github.com/JanVogelsang/UE-AgentFramework --skill unreal-instructions-janvogelsang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working on Unreal Engine projects with an AI agent requires knowing which tools to call, how to avoid editor crashes, and how to handle engine-specific quirks like .uasset path rules, TMap INI serialization, and null pointer crashes. This Skill provides the mandatory entry-point instructions that route every Unreal Engine task to the correct MCP server and enforce coding guardrails. ## Core Features & Use Cases - Dual-MCP Tool Routing: Directs Blueprint/UMG/level edits to the in-editor unrealengine server (port 18777) and C++ semantic queries to the cpp-ast-rag AST server, with fallback to documentation search for built-in engine classes. - Editor Lifecycle Workflows: Provides commands for building the project with Unreal Build Tool, launching the editor safely (including multiplayer/EOS login configurations), and triggering compilation without manual terminal builds. - Crash Prevention Guardrails: Enforces pointer validation for Data Assets, safe UI event handling, correct TMap config formatting, and Python script execution via scratch files to avoid PowerShell escaping failures. - Use Case: When asked to add a health component to a character Blueprint, the agent consults this Skill first to learn it must use Unreal paths like /Game/..., call the in-editor MCP tools rather than shell commands, and read the blueprint-authoring sub-skill before modifying nodes. ## Quick Start Ask the agent to modify a Blueprint or C++ class in your Unreal project and it will load these instructions to route the task correctly.

Frequently Asked Questions about unreal-instructions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit Unreal Engine Blueprints with an AI agent?▼

Use the in-editor unrealengine MCP server on port 18777 with tools like inject_blueprint_nodes_t3d. Always reference assets with Unreal paths like /Game/... and never modify .uasset files with shell commands.

How do I query Unreal Engine C++ classes semantically?▼

Use the cpp-ast-rag server's query_cpp_ast tool for project C++ code. For built-in engine classes not in the local index, fall back to search_vector_db to query Unreal documentation.

Can I compile Unreal C++ while the editor is open?▼

No, never run manual UBT or MSBuild terminal builds with an open editor. Use the trigger_compile tool instead, which compiles through the running editor safely.

Why does the editor crash when accessing Data Asset pointers?▼

Crashes occur when dereferencing unvalidated Data Asset pointers that are null or unassigned in .uasset files. Always call IsValid() or check nullptr before accessing properties, especially in UI event handlers and Mass ECS subsystems.

How do I run Python scripts in Unreal Engine without errors?▼

Write multi-line scripts to a temporary .py scratch file first, then execute it via the python or execute_python_script tools. Inline python -c strings fail due to Windows PowerShell escaping issues.