Docs · Extensions · Unreal Engine

AI GAS

Gameplay Ability System authoring without project C++ — effects (cost, cooldown, damage, regeneration, stacking), ability Blueprints, ability system components with a ready-made Health / Mana / Stamina set and input bindings — plus testing in Play In Editor.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
5 capabilities
Version
0.3.0
Package id
com.ivanmurzak.unreal-ai-gas
Engine
Unreal Engine · Unreal Engine 5.7+
Wraps
GameplayAbilities
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with the gasAbilities, gasEffects, gasAttributeSets, gasComponents, gas sources and adapters for AbilitySystemComponent, GameplayEffect, GameplayAbility. That powers 5 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Gameplay Effects

    Create Gameplay Effects and set their duration or period, attribute modifiers (including SetByCaller damage), tags and stacking.

    gas | call AddModifier("/Game/GAS/GE_Damage", "Damage", "Add", "SetByCaller")
  • Gameplay Abilities

    Create ability Blueprints and set their cost, cooldown, tags, projectile and class defaults, with no project C++.

    gas | call SetCost("/Game/GAS/GA_Fireball", "Mana", 20)
  • Ability systems on actors

    Give Blueprint actors an ability system component with attributes (a ready-made Health / Mana / Stamina set), starting abilities and effects, Enhanced Input bindings and attribute displays; grant abilities.

    gas | call AddAbilitySystem("/Game/ThirdPerson/Blueprints/BP_ThirdPersonCharacter", "Health=100, MaxHealth=100, Mana=100, MaxMana=100")
  • Test in Play In Editor

    In Play In Editor, activate abilities, apply effects and set attributes, then read the result.

    gas | call ActivateAbility("/Game/GAS/GA_Fireball")
  • Inspect GAS

    List abilities, effects and attribute sets, and the live ability system components with their attributes, owned tags, granted abilities and active effects.

    gasComponents | select Owner.Label Attributes OwnedTags ActiveEffects

See it in the Unreal Engine catalog →

Install

Requires the base plugin UnrealMCP 0.26.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-gas <UEProject>

When to ask the AI for it

Ask when you want abilities, damage and attributes in a Blueprint project — a fireball with a mana cost and cooldown, mana regeneration, or a health bar on an actor.

Not sure if it's installed? Ask the agent to run rql-schema — the gasAbilities 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 GA_Fireball with a 20 Mana cost and a 3-second cooldown that fires a projectile applying 25 damage through GE_Damage.
  2. Give BP_ThirdPersonCharacter 100 Health and Mana, a GE_ManaRegen starting effect, and bind GA_Fireball to key One.
  3. Start Play In Editor, activate GA_Fireball, and show every ability system component’s attributes.

Keep going