Getting Started

This guide builds a small Character.State.Stunned workflow. By the end, a GameObject can receive, report, and remove the tag at runtime.

1. Create the tag

Open the Gameplay Tags settings page, then:

1. Create the root tag Character.
2. Select Character and create the child State.
3. Select Character.State and create the child Stunned.
4. Give the final tag a concise project-specific description.

Character.State.Stunned

The hierarchy provides both a specific tag and broader query categories:

Tag	Intended scope
Character	Character-related classifications.
Character.State	Any character gameplay state.
Character.State.Stunned	The specific stunned state.

2. Add a GameplayTagComponent

1. Select a player, enemy, or test GameObject.
2. Add Game Creator > Gameplay Tags > Gameplay Tag Component.
3. Add Character.State.Stunned with the tag picker.

GameplayTagComponent makes the GameObject available to tag-aware Game Creator Actions, Conditions, Events, and runtime scripts.

3. Check the exact tag

1. Add a Game Creator Condition.
2. Choose Gameplay Tags > Game Object Has Gameplay Tag.
3. Select the GameObject to inspect.
4. Select Character.State.Stunned.
5. Choose Exact matching.

The Condition is true only when the object owns that complete tag path.

4. Query a parent category

Choose Include Children when a broad query should match a more specific owned tag:

Owned tag: Character.State.Stunned
Query: Character.State
Mode: Include Children
Result: true

Direction matters

An owned child tag can satisfy a parent query. Owning Character.State does not satisfy a query for Character.State.Stunned.

5. Add and remove the state at runtime

1. Run Add Gameplay Tag when the stun begins.
2. Check the same tag before movement, attack, or interaction logic.
3. Run Remove Gameplay Tag when the stun ends.

Next steps

• Learn the hierarchy and matching rules in Core Concepts.
• Organize the project repository with the Tag Manager.
• Review the available Actions and Conditions.