#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

Requirement	Status
Unity	Tested with Unity `6000.3.4f1` and compatible with Unity 2022.3+ / Unity 6.
Game Creator 2	Game Creator 2 Core is required.

#Installation

Import Gameplay Tags for Game Creator 2 into your Unity project.
Confirm Game Creator 2 Core is installed and compiling.
Open Game Creator's Settings window and select Gameplay Tags.
(Optional) Install Default Tags and Examples via the Game Creator Hub Installs window.

Game Creator settings window with Gameplay Tags selected — Game Creator settings with the Gameplay Tags module selected.

Note
The plugin stores project tags in a central repository at Assets/GameplayTags/Resources/Settings/. Inspectors, Game Creator fields, tag pickers, Actions, Conditions, Events, Reactions, 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:

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

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

Character.State.Stunned selected in the tag manager — The tag manager with Character.State.Stunned selected and its metadata visible in the details panel.

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

Tag	Use
`Character`	Broad character-related category.
`Character.State`	All gameplay state tags for characters.
`Character.State.Stunned`	Specific stunned state.

#Add Tags to a GameObject

Select a player, enemy, or test GameObject.
Add Game Creator > Gameplay Tags > Gameplay Tag Component (or use menu GameObject > Game Creator > Gameplay Tags > ...).
Add Character.State.Stunned using the tag picker.

GameplayTagComponent inspector with Character.State.Stunned assigned — GameplayTagComponent in Single Tag mode with Character.State.Stunned selected.

The GameplayTagComponent makes a GameObject visible to Gameplay Tag Actions, Conditions, Events, Reactions, 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.

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

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

Game Object Has Gameplay Tag Condition configured in Game Creator.

#Use Parent Matching

Parent matching lets one broad query match several specific states.

Owned: 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.

VideoOpen video ↗

Parent-child tag matching example using Include Children.

#Next Steps

Read Gameplay Tags Overview to understand hierarchy and matching.
Read Tag Containers to handle multiple simultaneous tags.
Read Gameplay Tag Reactions to build reactive triggers and lifecycle rules.
Read Game Creator Actions and Game Creator Conditions for visual scripting.