> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Item Audience

> Audience that forces a player to carry a specific item with restrictions.

# Item Audience

The `btc_quest_item_audience` is a powerful tool to force players to carry a specific item—usually a quest item or a key artifact—during a specific mission or context.

**Type:** `Audience Entry`
**ID:** `btc_quest_item_audience`

## Configuration

| Field              | Type                           | Default      | Description                                                           |
| :----------------- | :----------------------------- | :----------- | :-------------------------------------------------------------------- |
| `item`             | `Var<Item>`                    | `Item.Empty` | The item to be given to the player.                                   |
| `consumable`       | `Boolean`                      | `false`      | If true, the player can consume the item (food/potion).               |
| `onConsume`        | `List<Ref<TriggerableEntry>>`  | `[]`         | Actions to trigger if consumed.                                       |
| `onInteract`       | `List<Ref<TriggerableEntry>>`  | `[]`         | Actions to trigger on interaction (right/left click).                 |
| `interactionTypes` | `List<BTCItemInteractionType>` | `[ALL]`      | Types of interaction to listen for (LEFT\_CLICK, RIGHT\_CLICK, etc.). |
| `interactCooldown` | `Long`                         | `10`         | Cooldown in pulses (ticks/50ms?) for interaction triggers.            |
| `unbreakable`      | `Boolean`                      | `true`       | If true, item never loses durability.                                 |

## Behavior

* **Forced Possession**: When a player enters the audience or joins the server while in it, they actomatically receive the item.
* **Protection**:
  * **Cannot Drop**: Prevents dropping the item (Q).
  * **Cannot Store**: Prevents putting the item in chests, shulker boxes, or item frames.
  * **Cannot Craft**: Prevents using the item in crafting grids.
  * **Death Protection**: If the player dies, the item is removed from drops and instantly restored to them on respawn.
* **Removal**: When the player leaves the audience, the item is automatically removed from their inventory.

## Use Cases

* **Delivery Quests**: Give the player a package they must deliver. They can't lose it or stash it.
* **Key Items**: Give the player a key to open a door.
* **Tools**: Provide a temporary tool required for a specific task.