Skip to main content

Remove Item Action

The btc_remove_item_action removes specific custom RPG items from a player’s inventory. It scans the inventory (including hotbar and offhand) for items matching the custom Item ID. Type: Action Entry ID: btc_remove_item_action

Configuration

FieldTypeDefaultDescription
itemsList<BtcItemRemove>[]List of items to remove.
itemIdString""Shortcut to remove a single item ID.
amountInt1Shortcut amount for itemId.

BtcItemRemove Structure

FieldTypeDefaultDescription
idString""The custom item ID to target.
amountInt1Quantity to remove.

Behavior

  • Scans the player’s inventory.
  • Identifies custom items stored via NBT/PersistentDataContainer matching the configured IDs.
  • Removes the specified total amount, taking from multiple slots if necessary.
  • Does not drop items on the ground; they are simply deleted.