bevy-gameplay-tag

Organize and query hierarchical gameplay tags in Bevy projects.

7|1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/SuitedRioter/bevy_gameplay_tag --skill bevy-gameplay-tag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bevy-gameplay-tag
Source: https://github.com/SuitedRioter/bevy_gameplay_tag/tree/main/.claude/skills/bevy-gameplay-tag
Command: npx skills add https://github.com/SuitedRioter/bevy_gameplay_tag --skill bevy-gameplay-tag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

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.

Frequently Asked Questions about bevy-gameplay-tag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage hierarchical gameplay tags in Bevy for buffs and item classifications?

Hierarchical gameplay tags in Bevy are managed by applying a plugin-based system that organizes parent-child relationships, allowing child tags like Ability.Skill.Fire to match parent queries for reliable tag-driven logic.

What is hierarchical matching for gameplay tags and when do I need it?

Hierarchical matching is a mechanism where child tags automatically satisfy parent tag queries. You need it when building complex skill systems or AI conditions to ensure reliable state checks across deep tag trees.

How do I load gameplay tag data from a JSON file in a Bevy app?

To load gameplay tag data from JSON, add the GameplayTagsPlugin to your Bevy app and point it to your JSON configuration file, enabling easy game data management and type-safe tag creation.

Does this Bevy tagging approach support reference counting for stacking debuffs?

Yes, the system supports reference counting within its tag containers, enabling event-driven updates and accurate state tracking for stacking buffs or debuffs applied multiple times to an entity.

Can I use event-driven tag updates for AI condition checks in Bevy?

Yes, you can use event-driven tag updates to trigger AI condition checks. The system provides event-driven changes that allow gameplay logic to react immediately when tags are added or removed.

What are the limitations of using JSON-configured gameplay tags in Bevy?

JSON-configured gameplay tags require spawning a specific tag container on entities needing dynamic changes. Complex state-machine style condition checks may require manual query management beyond basic hierarchical matching.