gameplay-tags

Create, query, and manage Unreal Engine Gameplay Tags with runtime registration.

648|142|Updated Sep 12, 2025
One-click install
npx skills add https://github.com/kevinpbuckley/VibeUE --skill gameplay-tags
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gameplay-tags
Source: https://github.com/kevinpbuckley/VibeUE/tree/main/Content/Skills/gameplay-tags
Command: npx skills add https://github.com/kevinpbuckley/VibeUE --skill gameplay-tags

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manually editing DefaultGameplayTags.ini does not register tags with UGameplayTagsManager, so new tags fail to appear in editor tag pickers. This Skill registers Gameplay Tags in INI config and at runtime simultaneously, making them immediately usable in StateTree events, ability systems, and tag queries without an editor restart.

Core Features & Use Cases

  • Bulk Tag Registration: Register multiple dot-hierarchy tags (e.g. Ability.Attack.Melee) in one call with comments and source tracking via GameplayTagService.add_tags.
  • Hierarchy Queries & Validation: Check tag existence with has_tag, inspect comments and redirects with get_tag_info, and walk subtrees with get_children.
  • Runtime Tag Values: Obtain FGameplayTag values via request_tag and request_tag_container for tag-typed APIs like gameplay events and tag-keyed maps, which Python cannot construct directly.
  • Use Case: Before wiring a StateTree transition with an OnEvent trigger, register the event tags Cube.StartChasing and Cube.StopChasing, then verify them in the editor tag picker immediately.

Quick Start

Ask the AI to register the gameplay tags Ability.Attack.Melee and State.Stunned with a comment and confirm they appear in the tag hierarchy.

Frequently Asked Questions about gameplay-tags

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create gameplay tags in Unreal Engine with Python?

Call unreal.GameplayTagService.add_tags with a list of dot-hierarchy names like Ability.Attack.Melee, plus an optional comment and source. Tags are written to DefaultGameplayTags.ini and registered at runtime, so they appear in the editor tag picker immediately.

How do I check if a gameplay tag exists in Unreal Engine?

Use unreal.GameplayTagService.has_tag with the full tag name, which returns a boolean. Note that after a rename, has_tag still returns True for the old name because a redirect is registered; check get_tag_info's redirected_to field to confirm.

Why don't my gameplay tags show up in the editor tag picker?

Writing tags via ProjectSettingsService.set_ini_value only updates GConfig memory and never registers them with UGameplayTagsManager. Use the engine GameplayTagsToolset for single tags or GameplayTagService.add_tags for bulk registration instead.

How do I get an FGameplayTag value from Python in Unreal Engine?

Python cannot construct FGameplayTag directly because TagName is read-only. Call GameplayTagService.request_tag or request_tag_container to obtain valid tag values for APIs like send_gameplay_event_to_actor, and check is_valid on the result.

What naming format do Unreal gameplay tags require?

Gameplay tags use dot-separated hierarchy such as Category.Subcategory.TagName, for example State.Stunned. Spaces and special characters are not allowed; each segment becomes a node in the tag tree queryable via get_children.