Commands/give

From Minecraft Wiki
Jump to: navigation, search
give
Restrictions

Operator

First introduced

Alpha v1.0.15 (0.1.0)
PE Alpha 0.16.0 (PE Alpha 0.16.0 build 1)

Gives an item to one or more players.

Syntax[edit]

  • Java Edition
give <target> <item> [<count>]
  • Bedrock Edition
give <player: target> <itemName: Item> [amount: int] [data: int] [components: json]

Arguments[edit]

JE<targets>: entity
BE: player: target: CommandSelector<Player>

Must be a player name, a target selector or a UUID[Java Edition only]. And the target selector must be of player type.
Specifies the target(s) to give item(s) to.

JE<item>: item_stack
BE: itemName: Item: CommandItem

In Java Edition, it must be a item argument (does not accept item tags). In Bedrock Edition, it must be a item id or a block ID for which items exist.
Specifies the item to give.

JE<count>: integer
BE: amount: int: int

Must be a 32-bit integer number. And it must be between 1 and 2147483647 (inclusive). In Bedrock Edition, it must be between 1 and 32767 (inclusive).
Specifies the number of items to give. If not specified, defaults to 1.

BE: data: int: int

Must be a 32-bit integer number. It must be between 0 and 32767 (inclusive).
Specifies the item data value of the given item(s). Values that are invalid for the specified item id revert to 0. If not specified, defaults to 0.

BE: components: json: Json::Value

Must be a JSON Object.
Specifies the item components of the given item(s). Like data tags but supports only minecraft:can_place_on and minecraft:can_destroy functions (for example, /give @p iron_shovel 1 0 {"minecraft:can_destroy":{"blocks":["grass"]}})

Result[edit]

CommandTriggerJava EditionBedrock Edition
anythe arguments are not specified correctly Unparseable Failed
if <targets> or player: target fails to resolve to one or more online players Failed
On successGives the specified item(s) to the target(s)

On success, summons the specified item(s) at the location(s) of the target(s). If <targets> or player: target resolves to multiple targets, each receives the specified number of items. If there is room in the player's inventory, or the player is in creative mode, the item entity summoned is "fake", with its PickupDelay tag set to 32767 and its Age tag set to 5999, which would normally make it impossible to pick up the item, and have it despawn within a tick. If the player's inventory is full and they are not in creative mode, the item entity's Owner tag is set to the target and its PickupDelay tag set to 0 so that it can be picked up only by that player until within 10 seconds of it despawning, at which time other players may pick it up.

Output[edit]

CommandEditionSituationSuccess Count/execute store succeess .../execute store result ...
anyJava EditionOn fail00N/A
On success11the number of targeted players
Bedrock EditionOn fail0N/AN/A
On successthe number of players who are given item(s)N/AN/A

Examples[edit]

  • To give the nearest player a diamond sword with Lore that says "A legendary weapon":
    • /give @p minecraft:diamond_sword{display:{Lore:["\"A legendary weapon\""]}} 1[Java Edition only]
  • To give all players a potion that has the Night Vision effect:
  • To give a random player a Sharpness X diamond sword:
    • /give @r diamond_sword{Enchantments:[{id:"minecraft:sharpness",lvl:10}]} 1[Java Edition only]
  • To give the player executing the command a block of diamond that can be placed on dirt and can break quartz blocks, even in adventure mode.
    • /give @s minecraft:diamond_block{CanPlaceOn:["minecraft:dirt"],CanDestroy:["minecraft:quartz_block"]} 1[Java Edition only]
    • /give @s diamond_block 1 0 {"minecraft:can_place_on":{"blocks":["dirt"]},"minecraft:can_destroy":{"blocks":["quartz_block"]}} [Bedrock Edition only]
  • To give all players a level 2 Wither Potion with Knockback X:
    • /give @a potion{Enchantments:[{id:"minecraft:knockback",lvl:10}],CustomPotionEffects:[{Id:20,Amplifier:1}]} 1[Java Edition only]

History[edit]

Java Edition Alpha
v1.0.15(Alpha server 0.1.0) Added /give.
The /give command always gives exactly one of the specified item (by numeric ID) to the specified player.
?(at or prior to Alpha server 0.1.2_01) Added count argument to /give.
Java Edition
1.0.0Beta 1.9 Prerelease 4Added damage value argument to /give.
1.3.112w16a/give is now usable in singleplayer.
1.513w04a/give now accepts data value as the fourth argument.
1.7.213w36aAdded dataTag argument to /give.
1.814w32b/give can no longer make 'illegal' stacks (such as 70 diamonds[verify] or 5 iron swords).
Pocket Edition Alpha
0.16.0build 1Added /give.
The functionality is almost equivalent to the Java 1.10 usage, except there is no support for data tags and the player target is optional in /give.

See also[edit]

  • /summon – summon any entity at any location

References[edit]