Kit gas

38 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Guía

Use gas.* for GAS-specific Blueprint classes and an existing actor's Ability System Component. Use bp.* to define project Gameplay Tags or author event graphs inside the classes created here. The kit never chooses your player/character ASC architecture.

Start with gas.get_info. In a temporary folder, call gas.create_test_setup to create one Gameplay Ability, Gameplay Effect, AttributeSet, and static Gameplay Cue class. Inspect each with gas.get_ability, gas.get_effect, gas.list_attributes, or gas.get_cue.

For ability classification, define tags with bp.add_gameplay_tag, create an ability with gas.create_ability, assign durable asset tags with gas.set_ability_tags, then use bp.* graph tools to author activation behavior. AbilityTags identifies the asset; activation requirements and owned tags remain visible in gas.get_ability.

For effects, create an effect, choose instant, infinite, or duration with gas.set_effect_duration, then assign effect/target tags with gas.set_effect_tags and gas.set_effect_granted_tags. gas.set_effect_modifiers replaces the complete ordered modifier list with direct numeric scalable magnitudes. Each entry explicitly names its AttributeSet class, attribute property (GameplayAttributeData or a legacy float attribute), operation, and magnitude; executions, attribute-based calculations, granted abilities, and cue dispatch remain game-specific work.

For attributes, create an AttributeSet class and use gas.list_attributes to audit its real GameplayAttributeData properties. During PIE, gas.get_attribute_value reads one selected property from an existing actor's ASC and reports its base and current values. Fields, clamps, and gameplay callbacks belong in the game's native/Blueprint design.

For cues, use gas.create_cue_static and gas.list_cues. Register/manage the cue tag with bp.*, then author notify behavior in the Blueprint graph.

During PIE, target an actor label or object name that already owns an AbilitySystemComponent. gas.get_asc_state combines current tags, granted abilities, and active effects. gas.activate_ability and gas.apply_effect_self keep normal authority, required-tag, cost, and cooldown checks intact. gas.add_loose_tag and gas.remove_loose_tag affect only transient ASC state and never write the project tag table.

Names for new assets cannot contain spaces, slashes, or dots. Content paths must stay under /Game. Runtime tools require a live PIE actor that owns an ASC.

Trying GAS in PIE without a project pawn

1. Start PIE, then call gas.spawn_test_pawn {"label":"GasTest"}. It spawns the engine's AbilitySystemTestPawn (ASC + AbilitySystemTestAttributeSet) or reuses an actor with that label; pawnClass accepts any pawn class that owns an ASC. On UE 4.27 it also initialises the GAS globals when the project has not.
2. gas.ability_grant_class {"actor":"GasTest","class":"/Script/GameplayAbilities.GameplayAbility"} returns the new spec handle in message; gas.activate_ability uses the same class.
3. gas.apply_effect_self applies a GameplayEffect class. Pass durationPolicy (instant, infinite, duration + durationSeconds) to apply a transient copy with that policy without editing the asset, e.g. to get an active effect from the base /Script/GameplayAbilities.GameplayEffect.
4. Handle tools (gas.ability_get_by_handle, gas.ability_clear_handle, gas.active_effect_get_by_handle, gas.active_effect_remove_by_handle) accept a handle string or last (most recently granted ability / last listed active effect).
5. GameplayCue is a natively registered tag on every engine with GAS, handy for gas.add_loose_tag and the cue tools when the project has no tags yet.
6. gas.get_attribute_value {"actor":"GasTest","attributeSetClass":"/Script/GameplayAbilities.AbilitySystemTestAttributeSet","property":"Mana"} reads a test attribute.

Herramientas

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

gas.ability_clear_handle (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Removes one granted ability by handle from an authoritative PIE ASC.

Argumento	Tipo	Descripción
handle	string	obligatorio. Handle string returned by gas.ability_grant_class / gas.list_active_effects, or 'last' for the most recently granted ability / last listed active effect.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.ability_get_by_handle (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Returns the ability class for one granted ability handle.

Argumento	Tipo	Descripción
handle	string	obligatorio. Handle string returned by gas.ability_grant_class / gas.list_active_effects, or 'last' for the most recently granted ability / last listed active effect.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.ability_grant_class (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Grants an ability class on an authoritative PIE ASC; message carries the new handle.

Argumento	Tipo	Descripción
class	string	obligatorio. GameplayAbility or GameplayEffect Blueprint/class path.
level	integer	Ability/effect level; must be positive. Valor predeterminado 1.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.activate_ability (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Requests activation by ability class on a PIE actor ASC.

Argumento	Tipo	Descripción
class	string	obligatorio. GameplayAbility or GameplayEffect Blueprint/class path.
level	integer	Ability/effect level; must be positive. Valor predeterminado 1.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.active_effect_get_by_handle (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Returns one active effect and its remaining time.

Argumento	Tipo	Descripción
handle	string	obligatorio. Handle string returned by gas.ability_grant_class / gas.list_active_effects, or 'last' for the most recently granted ability / last listed active effect.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.active_effect_remove_by_handle (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Removes one active effect by handle.

Argumento	Tipo	Descripción
handle	string	obligatorio. Handle string returned by gas.ability_grant_class / gas.list_active_effects, or 'last' for the most recently granted ability / last listed active effect.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.add_loose_tag (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Adds one registered loose tag to this PIE actor ASC without editing project tag definitions.

Argumento	Tipo	Descripción
tag	string	obligatorio. Registered gameplay tag to add or remove from this ASC only.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.apply_effect_self (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Applies a GameplayEffect class to the same PIE actor ASC at the requested level.

Argumento	Tipo	Descripción
durationPolicy	string	Optional duration override applied to a transient copy of the effect: '' keeps the class policy, or instant, infinite, duration.
durationSeconds	number	Seconds used when durationPolicy is 'duration'; must be positive. Valor predeterminado 5.f.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.attribute_sets_list (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Lists AttributeSet classes spawned on a PIE ASC.

Argumento	Tipo	Descripción
actor	string	obligatorio. PIE actor label or object name that owns an AbilitySystemComponent.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.create_ability (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Creates a GameplayAbility-derived Blueprint class.

Argumento	Tipo	Descripción
folder	string	obligatorio. Destination Content Browser folder under /Game.
name	string	obligatorio. Asset name without spaces, slashes, or extension.

Devuelve: item, message.

gas.create_attribute_set (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Creates an AttributeSet-derived Blueprint class.

Argumento	Tipo	Descripción
folder	string	obligatorio. Destination Content Browser folder under /Game.
name	string	obligatorio. Asset name without spaces, slashes, or extension.

Devuelve: item, message.

gas.create_cue_static (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Creates a static Gameplay Cue notify Blueprint; tag table changes stay in bp.*.

Argumento	Tipo	Descripción
folder	string	obligatorio. Destination Content Browser folder under /Game.
name	string	obligatorio. Asset name without spaces, slashes, or extension.

Devuelve: item, message.

gas.create_effect (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Creates a GameplayEffect-derived Blueprint class.

Argumento	Tipo	Descripción
folder	string	obligatorio. Destination Content Browser folder under /Game.
name	string	obligatorio. Asset name without spaces, slashes, or extension.

Devuelve: item, message.

gas.create_test_setup (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Creates reusable Ability, Effect, AttributeSet, and Cue Blueprint fixtures.

Argumento	Tipo	Descripción
folder	string	obligatorio. Destination Content Browser folder under /Game for all smoke fixtures.

Devuelve: items, count, message.

gas.gameplay_cue_add (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Adds a persistent gameplay cue on an authoritative PIE ASC.

Argumento	Tipo	Descripción
tag	string	obligatorio. Registered gameplay tag to add or remove from this ASC only.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.gameplay_cue_execute (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Executes a one-shot gameplay cue on a PIE ASC.

Argumento	Tipo	Descripción
tag	string	obligatorio. Registered gameplay tag to add or remove from this ASC only.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.gameplay_cue_remove (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Removes a persistent gameplay cue from an authoritative PIE ASC.

Argumento	Tipo	Descripción
tag	string	obligatorio. Registered gameplay tag to add or remove from this ASC only.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.get_ability (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Returns ability tag and parent-class defaults.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.

Devuelve: abilityTags, activationOwnedTags, activationRequiredTags, activationBlockedTags.

gas.get_asc_state (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Returns owned tags, granted abilities, and active-effect handles from a PIE actor ASC.

Argumento	Tipo	Descripción
actor	string	obligatorio. PIE actor label or object name that owns an AbilitySystemComponent.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.get_attribute_value (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Reads one explicitly selected GAS attribute (GameplayAttributeData or legacy float property) from a PIE AbilitySystemComponent.

Argumento	Tipo	Descripción
actor	string	obligatorio. PIE actor label or object name that owns an AbilitySystemComponent.
attributeSetClass	string	obligatorio. AttributeSet Blueprint/class path that declares the selected property.
property	string	obligatorio. GameplayAttributeData property name declared by attributeSetClass.

Devuelve: actor, attributeSetClass, attribute, baseValue, currentValue.

gas.get_cue (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Returns a cue Blueprint's parent and notify kind.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.

Devuelve: cueKind.

gas.get_effect (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Returns GameplayEffect duration, modifier count, and tag defaults.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.

Devuelve: durationPolicy, modifierCount, effectTags, grantedTags, modifiers, warnings.

gas.get_info (riesgo 0, smoke)

Reports runtime/plugin capability and the deliberate Blueprint and Gameplay Tag boundaries.

Argumento	Tipo	Descripción
folder	string	Folder under /Game; empty searches all project content.
nameContains	string	Optional case-insensitive substring for asset names.
limit	integer	Maximum assets returned; zero means no explicit limit. Valor predeterminado 0.

Devuelve: gameplayAbilitiesAvailable, categories, notes.

gas.list_abilities (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Lists GameplayAbility-derived Blueprint classes.

Argumento	Tipo	Descripción
folder	string	Folder under /Game; empty searches all project content.
nameContains	string	Optional case-insensitive substring for asset names.
limit	integer	Maximum assets returned; zero means no explicit limit. Valor predeterminado 0.

Devuelve: items, count, message.

gas.list_active_effects (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Lists active effects and remaining duration from a PIE actor ASC.

Argumento	Tipo	Descripción
actor	string	obligatorio. PIE actor label or object name that owns an AbilitySystemComponent.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.list_assets (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Lists every GAS Blueprint asset category below a folder.

Argumento	Tipo	Descripción
folder	string	Folder under /Game; empty searches all project content.
nameContains	string	Optional case-insensitive substring for asset names.
limit	integer	Maximum assets returned; zero means no explicit limit. Valor predeterminado 0.

Devuelve: items, count, message.

gas.list_attribute_sets (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Lists AttributeSet-derived Blueprint classes.

Argumento	Tipo	Descripción
folder	string	Folder under /Game; empty searches all project content.
nameContains	string	Optional case-insensitive substring for asset names.
limit	integer	Maximum assets returned; zero means no explicit limit. Valor predeterminado 0.

Devuelve: items, count, message.

gas.list_attributes (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Lists GameplayAttributeData properties exposed by an AttributeSet class.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.

Devuelve: attributes, count.

gas.list_cues (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Lists static or actor Gameplay Cue notify Blueprint classes.

Argumento	Tipo	Descripción
folder	string	Folder under /Game; empty searches all project content.
nameContains	string	Optional case-insensitive substring for asset names.
limit	integer	Maximum assets returned; zero means no explicit limit. Valor predeterminado 0.

Devuelve: items, count, message.

gas.list_effects (riesgo 0, requiere el plugin GameplayAbilities, smoke)

Lists GameplayEffect-derived Blueprint classes.

Argumento	Tipo	Descripción
folder	string	Folder under /Game; empty searches all project content.
nameContains	string	Optional case-insensitive substring for asset names.
limit	integer	Maximum assets returned; zero means no explicit limit. Valor predeterminado 0.

Devuelve: items, count, message.

gas.list_granted_abilities (riesgo 0, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Lists abilities currently granted to a PIE actor ASC.

Argumento	Tipo	Descripción
actor	string	obligatorio. PIE actor label or object name that owns an AbilitySystemComponent.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.remove_loose_tag (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Removes one registered loose tag from this PIE actor ASC.

Argumento	Tipo	Descripción
tag	string	obligatorio. Registered gameplay tag to add or remove from this ASC only.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.

gas.set_ability_tags (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Replaces AbilityTags, which classify the ability asset.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.
tags	array of string	obligatorio. Registered Gameplay Tags to assign.

Devuelve: abilityTags, activationOwnedTags, activationRequiredTags, activationBlockedTags.

gas.set_effect_duration (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Sets the durable duration policy without inventing modifier semantics.

Argumento	Tipo	Descripción
asset	string	obligatorio. GameplayEffect Blueprint asset path or generated class path.
policy	string	obligatorio. Duration policy: instant, infinite, or duration.

Devuelve: durationPolicy, modifierCount, effectTags, grantedTags, modifiers, warnings.

gas.set_effect_granted_tags (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Replaces the tags an active effect grants to its target.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.
tags	array of string	obligatorio. Registered Gameplay Tags to assign.

Devuelve: durationPolicy, modifierCount, effectTags, grantedTags, modifiers, warnings.

gas.set_effect_modifiers (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Replaces an effect's direct numeric AttributeSet modifiers (GameplayAttributeData or legacy float attributes) in the supplied order.

Argumento	Tipo	Descripción
asset	string	obligatorio. GameplayEffect Blueprint asset path or generated class path.
modifiers	array of UeaGasEffectModifierInput	obligatorio. Ordered direct numeric modifiers that replace the effect's complete modifier list.

Devuelve: durationPolicy, modifierCount, effectTags, grantedTags, modifiers, warnings.

gas.set_effect_tags (riesgo 2, modifica, requiere el plugin GameplayAbilities, smoke)

Replaces the effect asset tags, not the project's gameplay tag table.

Argumento	Tipo	Descripción
asset	string	obligatorio. Blueprint asset path or generated class path.
tags	array of string	obligatorio. Registered Gameplay Tags to assign.

Devuelve: durationPolicy, modifierCount, effectTags, grantedTags, modifiers, warnings.

gas.spawn_test_pawn (riesgo 1, modifica, requiere el plugin GameplayAbilities, requiere PIE, smoke)

Spawns (or reuses by label) a PIE pawn that owns an AbilitySystemComponent; default is the engine AbilitySystemTestPawn with AbilitySystemTestAttributeSet.

Argumento	Tipo	Descripción
label	string	obligatorio. Actor label for the spawned pawn; an existing PIE actor with this label is reused.
pawnClass	string	Pawn class that owns an AbilitySystemComponent; default is the engine's AbilitySystemTestPawn (ASC + AbilitySystemTestAttributeSet).
location	{x,y,z}	World location in centimeters.

Devuelve: actor, ownedTags, grantedAbilities, activeEffects, remainingSeconds, count, message.