#Getting Started

This guide walks through the core workflow: create a tag, assign it to a GameObject, and check it from Game Creator 2.

By the end, you will have a simple Character.State.Stunned tag that can be added, removed, and checked at runtime.

#Requirements

#Installation

1. Import Gameplay Tags for Game Creator 2 into your Unity project.
2. Confirm Game Creator 2 Core is installed and compiling.
3. Wait for Unity to finish importing and compiling scripts.
4. Open Game Creator settings and select Gameplay Tags.

ScreenshotOpen full size ↗

Note
The plugin stores project tags in a central Gameplay Tags repository. Inspectors, Game Creator fields, tag pickers, Actions, Conditions, Events, and runtime code all read from this database.

#Create Your First Tag

Start with a practical state tag:

Character.State.Stunned

In the Gameplay Tags settings page:

1. Click Add Root Tag and create Character.
2. Select Character and create a child tag named State.
3. Select Character.State and create a child tag named Stunned.
4. Select the final tag and add a short description:

Applied while a character cannot move, attack, or interact.

ScreenshotOpen full size ↗

This structure gives you both a specific tag and a useful parent category:

#Add Tags to a GameObject

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

ScreenshotOpen full size ↗

The GameplayTagComponent makes a GameObject visible to Gameplay Tag Actions, Conditions, Events, and runtime scripts.

Tip
Put GameplayTagComponent on prefabs that represent gameplay objects: characters, enemies, interactables, pickups, doors, traps, or quest objects.

#Check the Tag in a Condition

Use Game Object Has Gameplay Tag when you want to check a tagged GameObject directly.

1. Add a Game Creator Condition.
2. Choose Gameplay Tags > Game Object Has Gameplay Tag.
3. Set Game Object to the object you want to check.
4. Set Tag to Character.State.Stunned.
5. Set Mode to Exact.

The Condition returns true only when the object has that exact tag.

ScreenshotOpen full size ↗

#Use Parent Matching

Parent matching lets one broad query match several specific states.

Example owned tag:

Character.State.Stunned

Query:

Character.State

Mode:

Include Children

Result:

true

This is useful when logic should respond to any state under a category, such as stunned, burning, frozen, silenced, or dead.

#Beginner Workflow: Stun State

Use this as a first real project workflow.

1. Create Character.State.Stunned.
2. Add GameplayTagComponent to the player or enemy prefab.
3. When a stun effect begins, run Add Gameplay Tag and add Character.State.Stunned.
4. In movement, attack, and interaction logic, use Game Object Has Gameplay Tag to block actions while stunned.
5. When the stun expires, run Remove Gameplay Tag.

#Next Steps

• Read Gameplay Tags Overview to understand hierarchy and matching.
• Read Tag Manager to organize your project database.
• Read Game Creator Actions and Game Creator Conditions for visual scripting workflows.