What problem does it solve?
Bevy projects often struggle to organize, query, and react to complex hierarchical gameplay tags (such as Ability.Skill.Fire, Status.Buff.Speed, or Item.Type.Equipment.Weapon). This Skill provides a complete tagging system with fast lookups, parent-child relationships, and event-driven updates to simplify building tag-driven gameplay systems.
Core Features & Use Cases
- Hierarchical matching across tag trees (child tags match parent queries)
- Efficient containers with binary-search queries and parent tag caching
- Reference counting for stacking buffs/debuffs and event-driven changes
- JSON-configured tag data for easy game data management
- Complex queries and state-machine style condition checks
- Type-safe tag creation and manager-access patterns
Quick Start
To start using bevy_gameplay_tag in a Bevy app, add the GameplayTagsPlugin to your App, optionally load tags from a JSON file (assets/tag_data.json), spawn a GameplayTagCountContainer on entities that require dynamic tag changes, and use the provided APIs to query or modify tags.