Gameplay TagsGame Creator 2 Module

#Changelog

All notable changes to Gameplay Tags for Game Creator 2 are documented here.

The project follows semantic versioning:

MAJOR.MINOR.PATCH
Version Part Meaning
MAJOR Breaking changes or migration-heavy updates.
MINOR New compatible features and capabilities.
PATCH Bug fixes, visual polish, and performance refinements.

#[1.6.2] - 2026-08-18 - Gameplay Tag Reactions & Visual Scripting Suite

#Added

⚡ Gameplay Tag Reactions & Lifecycle Events

  • Tagged Game Object Trigger Events: Native Game Creator 2 Events (On Tagged Game Object Created, On Tagged Game Object Enabled, On Tagged Game Object Disabled, On Tagged Game Object Destroying, On Gameplay Tag Starts Matching, On Gameplay Tag Stops Matching) with automatic Target = matched instance resolution.
  • Gameplay Tag Reaction Component (GameplayTagReaction): Specialized Game Creator 2 component that automatically executes instructions against matching Tagged Game Objects with built-in FIFO serialized queueing and play-mode telemetry.
  • Self & Target Resolution: Automatically binds Self to the Trigger/Reaction host GameObject and Target to the matched Tagged Game Object instance for native Game Creator instruction execution.
  • Reaction Trigger Types:
    • Tagged Game Object Enabled: Triggers when a Tagged Game Object is enabled/instantiated matching the tag query.
    • Tagged Game Object Created: Fires once when a Tagged Game Object is created/awakened.
    • Tagged Game Object Disabled: Triggers when an active Tagged Game Object is disabled/pooled.
    • Tagged Game Object Destroying: Triggers in OnDestroy before the Tagged Game Object becomes invalid.
    • Tagged Game Object Starts Matching: Triggers when an active Tagged Game Object gains tags causing it to match the query.
    • Tagged Game Object Stops Matching: Triggers when an active Tagged Game Object loses tags causing it to no longer match the query.
  • Hierarchical & Exact Matching: Support for Include Children and Exact matching modes via inspector dropdowns.
  • Execution Modes: Added Simultaneous (parallel execution for all matched objects), Queue (FIFO serialized), and Ignore While Busy.
  • Startup Timing & Delay: Added Immediate, Next Frame (yields 1 frame for newly spawned characters to initialize animators/colliders), and Custom Seconds startup timing options.
  • Cross-Scene Persistence (Persist Across Scenes): Keeps the Reaction GameObject active across scene transitions (DontDestroyOnLoad) with automatic deterministic duplicate protection (Keep Existing) and root-hierarchy detaching.
  • Global Lifecycle Events: Added EventCreated, EventRegistered, EventUnregistered, EventDestroying, EventComponentCreated, EventComponentActivated, EventComponentDeactivated, EventComponentDestroying, and EventComponentTagsChanged on GameplayTagComponent.
  • Hierarchy Creation Menus: Added menu item under GameObject > Game Creator > Gameplay Tags > Gameplay Tag Reaction.
  • UI Toolkit Inspector: Native Game Creator 2 inspector layout with When, Tag, Match, Include Existing Game Objects, Persist Across Scenes, target resolution callouts, parented persistence warnings, timing/delay options, and Advanced foldouts.

🔄 Imperative Reactions & Batch Queries

  • For Each Tagged Game Object (InstructionGameplayTagForEach): Supports both Inline Instructions (InstructionList) and external Actions Components, sequential and concurrent execution modes, and Include Inactive support.
  • Dual-Registry Inactive & Pooled Object Discovery: Added dual-registry component tracking to GameplayTagComponent (GetAllComponentsNonAlloc) to discover and operate on disabled/pooled GameObjects across queries and reactions.

🧩 Visual Scripting Suite

  • Instructions:
    • For Each Tagged Game Object (InstructionGameplayTagForEach)
    • Execute Reaction Manually (InstructionGameplayTagReactionExecute)
    • Set Reaction Tag (InstructionGameplayTagReactionSetTag)
    • Set Reaction When (InstructionGameplayTagReactionSetWhen)
    • Set Reaction Match (InstructionGameplayTagReactionSetMatch)
    • Set Reaction Delay (InstructionGameplayTagReactionSetDelay)
    • Cancel Reaction (InstructionGameplayTagReactionCancel)
    • Evaluate Existing Objects in Reaction (InstructionGameplayTagReactionEvaluateExisting)
  • Conditions:
    • Is Reaction Running (ConditionGameplayTagReactionIsRunning)
    • Reaction Has Queued Objects (ConditionGameplayTagReactionHasQueued)
    • Reaction Matches Object (ConditionGameplayTagReactionMatchesObject)
  • Properties:
    • Gameplay Tag Reaction Tag (PropertyGetGameplayTagReactionTag)
    • Gameplay Tag Reaction Queued Count (PropertyGetGameplayTagReactionQueuedCount)
    • Gameplay Tag Reaction Is Running (PropertyGetGameplayTagReactionIsRunning)
  • Clean Sub-Menu Organization: Restructured all visual scripting pickers into organized sub-categories (Manage/, Hierarchy/, Queries/, Reactions/).
  • Runtime Mutation & Defaults Reset API: Added runtime configuration APIs (SetWhen, SetGameplayTag, SetMatch, SetDelay, SetIncludeExistingGameObjects, SetPersistAcrossScenes, SetExecution, SetReactionActive, ResetRuntimeStateToDefaults).

🔍 Scene View Debug Gizmos & Visual Diagnostics

  • Edit Mode & Play Mode Scene View Gizmos: Real-time floating tag badges rendered above tagged GameObjects in both Edit Mode and Play Mode with custom 9-sliced rounded borders, anchor discs, and connection guidelines.
  • Customizable World Offset (DebugWorldOffset): Position debug cards cleanly above characters or props directly from the GameplayTagComponent Inspector.
  • Real-Time Editor Repaints: Instant Scene View synchronization when changing tags, container modes, or offsets in the Inspector.
  • Zero-Overhead Production Stripping: Debug overlays and gizmo drawing systems are automatically stripped from release player builds.

🎮 Interactive Example Scenes & Packaging

  • New Example Scene (3_GameplayTagReactions.unity): Interactive scene demonstrating reactive GameplayTagReaction components, Trigger lifecycle events, inline vs actions For Each loops, inactive object discovery, and in-scene tutorial cards.
  • Self-Contained Installer Package: Rebuilt internal Package.unitypackage with recursive directory synchronization and automatic cross-asset GUID remapping for the Game Creator Hub installer.

#Fixed

  • Fixed Unity 6.3 compilation issue with FindObjectsSortMode overloads in PropertyTypeGetGameplayTag.
  • Updated MakeSerializable attribute guard to UNITY_6000_3_OR_NEWER.
  • Completely removed test tracking instructions from Game Creator's type selector menu.

#[1.6.1] - 2026-08-16 - Menu Path Refinement

#Changed

  • Standardized GameObject creation menu path to GameObject > Game Creator > Gameplay Tags > ....

#[1.6.0] - 2026-07-28 - Unity 6 Compatibility

#Added

  • Added conditional compilation support for Unity 6.0.0 and later in PropertyTypeGetGameplayTag.
  • Updated runtime overlay bootstrap method for Unity 6.0.0+ component retrieval.

#[1.5.0] - 2026-07-24 - Examples Suite & Editor UI Enhancements

#Added

  • Example Scenes Suite:
    • 1_GameplayTagBasic.unity: Basic tag assignment, conditions, and tag-based action flows.
    • 1_GameplayTagDoorExample.unity: Interactive door unlocking and key requirement mechanics.
    • 2_GameplayTagIntermediate.unity: Multi-tag queries, combat filtering, and buff/debuff systems.
  • Editor UI Enhancements:
    • Implemented Unity icon caching mechanism to optimize tag repository inspector performance.
    • Refactored GameplayTagsRepositoryDrawer with enhanced tag details view, GUID display, and category hierarchy.
    • Streamlined GameplayTagsDefaultTagsInstaller for idempotent tag installs via Game Creator Hub.

#[1.4.0] - 2026-07-24 - Solution & Tooling Update

#Changed

  • Updated Visual Studio / VS Code configuration files and modernized solution layout.

#[1.3.0] - 2026-07-24 - Maintenance Release

#Changed

  • Internal project references and test suite structure maintenance.

#[1.1.0] - 2026-07-24 - Maintenance Release

#Changed

  • Asset bundle metadata and solution configurations alignment.

#[1.0.0] - 2026-07-24 - Initial Release

#Added

  • Hierarchical Gameplay Tags with dot syntax (e.g. Character.State.Stunned).
  • Central Gameplay Tags settings page for Game Creator.
  • Tag creation, rename, delete, duplicate, search, expand, collapse, import, and export workflows.
  • Tag details panel with path, parent, description, GUID display, and management actions.
  • Tag picker dropdowns for single tags and tag containers.
  • GameplayTagComponent for assigning runtime tags to GameObjects.
  • Container and Single Tag component modes.
  • Runtime APIs for adding, removing, clearing, setting, querying, and responding to tags.
  • Game Creator 2 Actions for setting, mutating, finding, filtering, raycasting, and overlap queries.
  • Game Creator 2 Conditions for tag and container checks.
  • Game Creator 2 Events for tag changes, trigger checks, and collision checks.
  • Game Creator value and property support for Gameplay Tags and Gameplay Tag Containers.
  • Save memory support for runtime tags on a GameplayTagComponent.
  • Validation support for invalid paths, duplicate paths, missing redirect targets, and redirect cycles.