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.
At a glance
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
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-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.
Example prompts
Copy-pasteable first requests. Start with one, verify it in the editor, then build up.
Create a Control Rig CR_LookAt from the mannequin mesh that aims the head at a LookAtTarget variable, and add it to ABP_Unarmed.Make the head track the nearest BP_Orb within 6 m, then compile ABP_Unarmed.List the Simulation rig units I can add, with their pins.