Item Audience
Thebtc_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.