Tag Manager

The Gameplay Tags settings page manages the project’s central tag repository.

Interface

Area	Purpose
Hierarchy	Browse, search, create, rename, delete, duplicate, and reorganize tags.
Details	Inspect a selected path, edit its description, copy its GUID, and run tag actions.

Selecting a tag shows its full path, parent, description, GUID, and hierarchy counts. Add descriptions when a tag is shared by several systems or designers.

Create and find tags

Start with a small set of broad roots, then add children when the project needs them:

Character
Damage
Faction
Interaction
Item
Quest
World

Search accepts full or partial paths such as Fire, Quest.Main, or Interaction.Usable.

Keyboard shortcuts documented by the legacy manager include:

Shortcut	Action
F2 or Enter	Rename the selected tag.
Delete or Backspace	Delete the selected tag.
Ctrl+C or Cmd+C	Copy the selected path.
Left Arrow	Collapse the selected tag or move to its parent.
Right Arrow	Expand the selected tag.

Row actions

Right-click a row for common actions, including adding a child or root tag, renaming, deleting, copying the path, and duplicating.

Rename and reparent

Renaming or reparenting a parent changes the paths of its descendants. The implementation preserves tag GUIDs and creates redirects from old paths to new paths for the affected subtree.

For example:

Damage.Element.Fire

can become:

Damage.Type.Fire

Serialized references

Redirects allow old paths to resolve at runtime, but rename and reparent operations do not synchronously rewrite every scene, prefab, or project asset. Export the database and use version control before restructuring widely used paths.

Delete tags

Deleting a tag removes it and its descendants from the repository after confirmation.

Deletion does not scan project assets

Deletion does not create redirects or scan all scenes and prefabs for references. A removed tag can leave missing serialized references. Search the project and commit or back up the project before deleting a shared tag.

Import and export

Export before large changes or when sharing a repository between projects. JSON import supports:

Mode	Behavior
Merge	Retain existing tags while updating or adding imported entries.
Replace	Clear existing tags and redirects before loading the imported file.

Validation

Repository validation reports:

• invalid paths;
• duplicate paths;
• redirects whose targets no longer exist; and
• redirect cycles.

Run validation after imports, large renames, or repository cleanup.

Naming guidance

• Start broad and become more specific.
• Keep segments short, singular, and meaningful.
• Use the same segment names consistently.
• Avoid spaces, punctuation, temporary labels, and numbers used as values.
• Design parent categories where broad queries will be useful.