Game Tags

Documentation | Discussion | Discord

Game Tags provide hierarchical labels with custom names to tag, identify, categorize, reference, query, match and filter tagged objects.

Game Tag is represented in editor inspector as a structured string with arbitrary nested subtag hierarchy levels divided by a delimiter sign ‘.’ in format “Europe.France.Lyon”.

Game Tags are fully compatible with Unity DOTS framework, Jobs system and Burst compiler. All Game Tag parent or children enumerating or matching methods can be directly called from within Jobs.

Game Tag is implemented as a struct with a unique stable signed integer ID value, avoiding the string or object reference comparisons in tag evaluations altogether.

Associated managed classes like Game Tag Containers or Game Tag Queries can be converted to native Burst compatible structures with equivalent functionality with minimal overhead.

Game Tags maintains an internal reference database to quickly find tagged objects, retrieve all object tags or to get all objects matching the Game Tag Query both in editor and runtime.

Game Tag Query defines an expressive arbitrary nested condition tree to evaluate a collection of tags, similarly to evaluating an enum flag. Query can be easily constructed both in the editor and in code, providing a flexible framework to evaluate conditions and drive gameplay logic.