Minecraft: Give Item

Gives an item or one random item from an item tag or configured random row.

When to use it

  • Channel Point item rewards.
  • Random loot from Minecraft or modded item tags.
  • Give custom named or enchanted items.
  • Return the viewer or other giver name in the Item Given event.

Fields

  • Use Random Item: When enabled, one configured item row is picked when the effect runs.
  • Item ID: Full item ID such as minecraft:diamond, or an item tag such as #minecraft:logs or #c:ingots. A tag shuffles its matching items and tries them until Minecraft successfully gives one.
  • Amount: How many of the selected item to give.
  • Item Data: Optional item components, NBT, names, lore, enchantments, or modded data. Firebot variables are supported. Use $minecraftItemName for the readable name of the actual item selected by Minecraft.
  • + Add Item: Adds another possible random row when Use Random Item is enabled. Each row may contain an item ID or item tag.
  • Giver Name: Optional text available as $minecraftItemGiverName in this effect's Item Data and in the Minecraft Item Given event. Firebot variables such as $userDisplayName are supported.
  • Use Blacklist: Prevents matching items from being given.
  • Blacklisted Items: One exact item ID, wildcard, or item tag per line. Use mekanism:* to exclude all Mekanism items, or #cabletiers:elite_importers to exclude every item in that tag. When a source tag is selected, blocked results are removed first. Remaining items are shuffled and attempted until one succeeds. The effect fails when no allowed item can be given.

Custom item name

For Minecraft 1.21.1:

[custom_name='{"text":"$minecraftItemName from $minecraftItemGiverName","color":"gold"}']

$userDisplayName in Giver Name is replaced by Firebot. Minecraft then replaces $minecraftItemName and $minecraftItemGiverName in Item Data after the exact item is known, including when Item ID is a tag.

Examples

Give diamonds

Use Random Item: off
Item ID: minecraft:diamond
Amount: 5
Item Data:
Giver Name: $userDisplayName

Give a random log

Use Random Item: off
Item ID: #minecraft:logs
Amount: 16
Item Data: [custom_name='{"text":"$minecraftItemName from $minecraftItemGiverName","color":"gold"}']
Giver Name: $userDisplayName
Use Blacklist: on
Blacklisted Items:
minecraft:crimson_stem
minecraft:warped_stem
mekanism:*
#cabletiers:elite_importers

Random configured rows

Use Random Item: on
Row 1: #minecraft:logs, Amount 16
Row 2: minecraft:diamond, Amount 3
Row 3: minecraft:stick, Amount 1, Item Data [custom_name='{"text":"$minecraftItemName from $minecraftItemGiverName","color":"gold"}']
Giver Name: $userDisplayName

#c:mineable/axe and other #c:mineable/* entries are treated as their vanilla #minecraft:mineable/* block-tag equivalents for compatibility.