Equip Ability
The Equip Ability transitions valid equipment items to the Equipped state, typically placing them on the character's hand, depending on your equipment state setup.
This ability is a specialization of the abstract ChangeEquipmentState ability class, which provides shared logic for resolving equipment items, validating prerequisites, and applying state changes.
Item Requirement
Only items that include a Equipment Fragment are eligible to be equipped. The fragment defines the current state of the equipment and provides utility methods to update or query its status.
Usage Options
You can select items through an Item Query or provide them directly as an optional object in the ability's trigger payload. These options give you flexibility to support a wide range of gameplay scenarios, such as:
Interactive selection: Activate the ability and allow the player (or AI) to choose which item to equip. This covers cases like " equip the item in the primary hand " or " select a weapon from the wheel ".
Direct activation: Provide a specific item in the payload when the target item is already known. Common examples include " press 1 to equip the shotgun " or "select the equip option for an item in the UI_".