Docs · Extensions · Unreal Engine

AI ControlRig

Author Control Rigs without C++ — look-at / aim, two-bone IK, springs, traces or any rig unit with its settings and links — and wire them into Anim Blueprints; query rigs, their graphs, variables and hierarchy.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
4 capabilities
Version
0.3.0
Package id
com.ivanmurzak.unreal-ai-control-rig
Engine
Unreal Engine · Unreal Engine 5.7+
Wraps
ControlRig
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with the controlRigs, controlRigUnits, controlRig sources and adapters for ControlRigBlueprint, AnimBlueprint, ControlRigComponent. That powers 4 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Author rigs

    Create Control Rigs (optionally from a character’s skeletal mesh, importing its bones and curves), add rig variables, bones and controls, and add look-at / aim and two-bone IK setups.

    controlRig | call CreateRig("/Game/Rigs/CR_LookAt", "/Game/Characters/Mannequins/Meshes/SKM_Manny_Simple")
  • Rig units & links

    Add any rig unit by name with its settings (springs, traces, Full Body IK …), set pins, link pins and variables, store pins in variables, and remove nodes.

    controlRig | call AddUnit("/Game/Rigs/CR_LookAt", "SpringInterpVectorV2", "Target=@LookAtTarget, Strength=8", "", "Smooth")
  • Wire into Anim Blueprints

    Splice a Control Rig node into an Anim Blueprint before Output Pose, bind its inputs to Anim Blueprint variables, and add logic that tracks the nearest actor of a class.

    controlRig | call AddToAnimBlueprint("/Game/Characters/Mannequins/Anims/Unarmed/ABP_Unarmed", "/Game/Rigs/CR_LookAt")
  • Inspect rigs

    List rig assets and available rig units; read a rig’s graph, variables, hierarchy, controls and bones, an Anim Blueprint’s Control Rig nodes, a component’s bound rig, and a running rig’s values in Play In Editor.

    unreal.asset("/Game/Rigs/CR_LookAt") | select Variables Nodes

See it in the Unreal Engine catalog →

Install

Requires the base plugin UnrealMCP 0.28.0 or later. The extension ships as C++ source: rebuild the project (or pass --build) before opening the editor; then the RQL module loads with the package — the agent sees it in rql-schema.

unreal-mcp-cliunreal-mcp-cli install-extension com.ivanmurzak.unreal-ai-control-rig <UEProject>

When to ask the AI for it

Ask for procedural animation on a character — a head that turns toward a target, IK, or a rig unit spliced into an Anim Blueprint before Output Pose.

Not sure if it's installed? Ask the agent to run rql-schema — the controlRigs source only exists when the package is present.

Example prompts

Copy-pasteable first requests. Start with one, verify it in the editor, then build up.

  1. Create a Control Rig CR_LookAt from the mannequin mesh that aims the head at a LookAtTarget variable, and add it to ABP_Unarmed.
  2. Make the head track the nearest BP_Orb within 6 m, then compile ABP_Unarmed.
  3. List the Simulation rig units I can add, with their pins.

Keep going