Skip to main content
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.
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
List<ItemGive>
A list of items to give. Used for batch rewards.
​
itemId
String
Shortcut. The unique ID of the single item to give.
​
amount
Int
default:"1"
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