Zum Hauptinhalt springen

Give Item Action

The btc_give_item_action allows you to distribute custom items defined in your RPG Core Configuration. It handles inventory logic automatically, dropping items on the ground if the player is full.

info

Mechanic: This action connects directly to the Item Catalog. If an ID doesn't exist, it will fail silently or warn in console depending on settings.

Configuration​

items

"> A list of items to give. Used for batch rewards.

itemId — String

Shortcut. The unique ID of the single item to give.

amount — Int

Shortcut. Quantity for the single item.

Data Structure: ItemGive​

FieldTypeDescription
idStringRequired. The Item ID from catalog.
amountIntQuantity to give.

Example Usage​

# Give 1 Excalibur
btc_give_item_action:
  itemId: "excalibur"
  amount: 1
# Give a kit of items
btc_give_item_action:
  items:
    - id: "miner_helmet"
      amount: 1
    - id: "super_torch"
      amount: 64