Beginner

Learn what gengine is, the problem it solves, and how it connects AI models to the Unreal Editor via MCP.

What is gengine?

gengine is an Unreal Engine 5.7 plugin that lets AI models control your editor through the Model Context Protocol. Instead of manually clicking through menus, you describe what you want and the AI does it.

The problem gengine solves

AI coding assistants like Claude and GPT-4 are excellent at writing C++ and Blueprint logic, but they are completely blind to your actual editor state. They cannot see what actors are in your level, what assets exist in your Content Browser, or whether a Blueprint compiles. Every interaction is a one-way conversation where you paste output, copy errors, and repeat.

This creates a painful loop: ask AI to write code, paste it in, hit compile, copy the error, ask AI again. For tasks like spawning 50 light sources, batch-renaming assets, or wiring Blueprint nodes, that loop becomes the bottleneck — not the AI's capability.

gengine breaks that loop. It gives AI models a live, bidirectional connection to the Unreal Editor so they can read state, perform operations, and verify results — all without you leaving the chat.

How it works

gengine implements the Model Context Protocol (MCP), an open standard created by Anthropic that defines how AI models communicate with external tools. The flow looks like this:

AI Model (Claude / GPT-4 / Ollama)
    │  speaks MCP over stdio or HTTP
    ▼
MCP Bridge  (Node.js process, Resources/mcp-bridge/)
    │  translates MCP calls to REST requests
    ▼
gengine REST API  (runs inside Unreal, port 8080)
    │  routes to registered tool handlers
    ▼
Unreal Editor  (live editor state, no serialization)

The MCP Bridge is a thin Node.js process that runs alongside your editor session. It exposes the gengine tool set to any MCP-compatible AI client and forwards calls to the plugin's built-in HTTP server. The plugin then executes operations on the game thread where it has full access to the editor, content browser, asset registry, and Blueprint compiler.

Because operations run inside the editor process, results are immediate and accurate. When you ask "what actors are in this level?", gengine queries the actual UWorld — not a cached file on disk.

Note: gengine does not send your project files, source code, or asset data to any external server. All operations execute locally. Only the messages you type and the tool results the AI receives travel to your chosen AI provider.

What you can do with gengine

gengine exposes 97 operations across six domains. Here are common tasks that become conversational with gengine:

Level editing

  • Spawn actors, lights, cameras, and custom classes by name
  • Move, rotate, and scale actors with precise coordinates
  • Delete actors by type, tag, or name pattern
  • Capture viewport screenshots for visual verification
  • Run console commands and read the output log

Asset management

  • Search the Content Browser with query filters
  • Get asset info, dependency graphs, and referencer lists
  • Rename, move, duplicate, and delete assets in bulk
  • Create Blueprint classes, material instances, and data assets

Blueprint authoring

  • Inspect Blueprint variables, functions, and event graphs
  • Add nodes, connect pins, and set pin values programmatically
  • Validate Blueprints and read compile errors

Animation and characters

  • Create state machines and add states with transitions
  • Set movement parameters and character stats from data tables
  • Batch-update animation Blueprint configurations

Tip: The best results come from combining operations. Ask Claude to "search for all Static Mesh actors named 'Prop_Rock', move them 100 units up, then capture a screenshot" — gengine executes all three steps in sequence automatically.

Who gengine is for

gengine is designed for anyone who works in Unreal Engine and wants to move faster. You do not need to know C++ to use it — the chat interface and web panel work for all experience levels.

Indie developers

Solo and small-team developers can use gengine to handle repetitive editor tasks — batch renaming, scene dressing, Blueprint wiring — so they can focus on gameplay design rather than clicking.

Technical artists

Material creation, actor placement, and parameter tuning are natural fits for conversational iteration. Describe the look you want and refine it through dialogue instead of trial-and-error in the material editor.

Level designers

Populate levels, arrange actors, and test lighting setups through natural language. Screenshot capture lets you share visual context with the AI without leaving the editor.

Studios and pipelines

Enterprise teams can extend gengine with custom MCP tools that enforce naming conventions, run validation scripts, or integrate with external asset management systems.

Free, Pro, and Enterprise tiers

gengine is available in three tiers to suit different team sizes and needs.

Free

  • All 97 MCP operations with full editor access
  • Web Chat Panel with topic tabs and persistent memory
  • Command Center with Tools, Tasks, Activity, and Diagnostics tabs
  • Support for Claude CLI, OpenAI, Ollama, and LM Studio providers
  • Community support via Discord

Pro

  • Everything in Free
  • Autonomous task queue — queue multiple multi-step tasks
  • Shadow git integration for AI-safe project checkpoints
  • Usage analytics and cost tracking dashboard
  • Priority email support

Enterprise

  • Everything in Pro
  • Custom MCP tool SDK with full API access
  • SSO / SAML authentication for team deployments
  • Audit logs for all AI operations
  • On-premise deployment option (no external network required)
  • Dedicated Slack support channel and SLA

Note: All tiers run your chosen AI provider. gengine does not bundle any AI subscription — you bring your own API key or use a local model.