> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/for-ultimatequest/configuration/triggers/items-equipment.md).

# Item, Enchanting, and Equipment Triggers

Each section documents the current event context. PLAYER is the player credited with quest progress; TARGET is not automatically PLAYER. Missing values remain absent. All of these triggers observe progress and do not expose mutable damage/drop results.

## Configuration example

```yaml
source:
  trigger: consume
  amount: 10
```

## `consume`

Runs for player item consumption, using the consumed item as context.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerItemConsumeEvent`          |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Consumed stack / event hand       |

## `enchant_item`

Runs for enchanting-table enchantment of an item, not anvil combination.

| Context              | Value                                                             |
| -------------------- | ----------------------------------------------------------------- |
| Event / payload      | `EnchantItemEvent`                                                |
| Availability         | Paper and Spigot                                                  |
| PLAYER               | Player associated with this event                                 |
| SOURCE               | Quest player                                                      |
| TARGET               | Absent                                                            |
| LOCATION             | Player location                                                   |
| TRIGGER\_ITEM / slot | Enchanted stack / HAND                                            |
| Extra context        | `original_experience`, `enchantment_level_cost`, `original_lapis` |

original\_experience is the displayed level cost; enchantment\_level\_cost and original\_lapis are the chosen button index plus one (normally 1–3). These are context values, not progress increments.

## `item_damage`

Runs when a player item takes durability damage.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerItemDamageEvent`           |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Damaged item / resolved slot      |
| Extra context        | `original_item_damage`            |

## `item_held`

Runs when a player changes the selected hotbar slot.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerItemHeldEvent`             |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | New selected hotbar item / HAND   |

## `swap_hand`

Runs when a player swaps main/offhand items, with the event new main-hand item.

| Context              | Value                             |
| -------------------- | --------------------------------- |
| Event / payload      | `PlayerSwapHandItemsEvent`        |
| Availability         | Paper and Spigot                  |
| PLAYER               | Player associated with this event |
| SOURCE               | Quest player                      |
| TARGET               | Absent                            |
| LOCATION             | Player location                   |
| TRIGGER\_ITEM / slot | Event new main-hand item / HAND   |

## `item_group_cooldown`

Observes item/group cooldown changes; a specific item is only attached when resolvable.

| Context              | Value                                                |
| -------------------- | ---------------------------------------------------- |
| Event / payload      | `PlayerItemGroupCooldownEvent`                       |
| Availability         | Paper mode and event class required                  |
| PLAYER               | Player associated with this event                    |
| SOURCE               | Quest player                                         |
| TARGET               | Absent                                               |
| LOCATION             | Player location                                      |
| TRIGGER\_ITEM / slot | Matching held item only when the material is exposed |

## `name_entity`

Runs when a player names an entity.

| Context              | Value                               |
| -------------------- | ----------------------------------- |
| Event / payload      | `PlayerNameEntityEvent`             |
| Availability         | Paper mode and event class required |
| PLAYER               | Player associated with this event   |
| SOURCE               | Quest player                        |
| TARGET               | Named entity                        |
| LOCATION             | Target/entity location              |
| TRIGGER\_ITEM / slot | Held NAME\_TAG if found             |

[Trigger overview](/for-ultimatequest/configuration/triggers.md) · [Event conditions](/for-ultimatequest/configuration/conditions.md)