手册:/give

来自Minecraft基岩版开发Wiki
give
用法旗标
普通命令(0)
可见性旗标
可见(0)
同步旗标
同步命令(0)
执行旗标
允许执行(0)
类型旗标
无类型(0)
作弊旗标
作弊命令(0)
游戏内描述

给予玩家物品。

/give命令用于给予玩家特定物品。

语法[编辑]

give <player: target> <itemName: Item> [amount: int] [data: int] [components: json]

参数[编辑]

player
target类型,指定给予物品的玩家。目标选择器只能是玩家。如果未指定,默认指定为命令执行者。
itemName
Item类型,指定待给予的物品,必须是一个物品ID或存在其物品形式的方块ID。
amount
int类型,指定给予物品的数量。必须是1~32767内的整数(含),默认为1。
data
int类型,指定待清除物品的数据值(例如颜色方向等)。
如果未指定或指定的数据值对此物品无效则为0。必须为0到32767之间的数字(含)。
components
json类型,指定所给予的物品的物品组件。目前仅支持以下几类:
目前基岩版所有的物品组件
组件名 组件作用 组件基本格式
minecraft:can_place_on 在冒险模式下,玩家可以把带有

此标签的方块放置在特定方块上。

{"minecraft:can_place_on":{"blocks":["block1","block2",...]}}
minecraft:can_destroy 在冒险模式下,玩家可以利用带有

此标签的物品破坏特定方块。

{"minecraft:can_destroy":{"blocks":["block1","block2",...]}}
minecraft:item_lock 将物品锁定在特定的位置,使其

不能用于丢弃合成等。其中:

lock_in_inventory指物品栏

lock_in_slot指快捷栏

{"minecraft:item_lock":{"mode":"lock_in_inventory"}}
{"minecraft:item_lock":{"mode":"lock_in_slot"}}
minecraft:keep_on_death 在死亡后控制某些物品不会掉落。 {"minecraft:keep_on_death":{}}

效果[编辑]

命令触发条件执行结果
任意参数未正确指定失败
[player: target]不存在或指定了非玩家目标
json组件有语法错误,或不为目前支持的基本组件
在指定了有效的命令名,正常给出了命令的用法时成功

输出[编辑]

命令执行结果成功次数增量
任意失败0
成功被给予物品的玩家数

示例[编辑]

/give @a command_block - 给予所有玩家一个命令方块。
/give @p apple 32 - 给予最近玩家32个苹果。
/give @r diamond_pickaxe 1 40 - 给予随机玩家一个消耗了40耐久的钻石镐。
/give Alex lever 2 0 {“can_place_on”:{“blocks”:[“gold_block”]}} - 给予[Alex]2个能够放在金块上(在冒险模式)的拉杆。
/give Steve netherite_shovel 1 50 {“can_destroy”:{“blocks”:[“sand”]}} - 给予[Steve]1个能够破坏沙子(在冒险模式)的消耗了50耐久的下界合金锹。
/give @s wool 10 5 {“can_place_on”:{“blocks”:[“grass”,“sand”]},“can_destroy”:{“blocks”:[“sand”]}} - 给予自己10个能够破坏沙子的,也能够放在草方块和沙子上的(在冒险模式)的黄绿色羊毛。
/give @a diamond_sword 1 0 {"can_place_on":{"blocks":["dirt"]},"can_destroy":{"blocks":["grass"]},"item_lock":{"mode":"lock_in_inventory"},"keep_on_death":{}} - 给予所有人可以放在泥土上(虽说没有意义)、可以破坏草方块(冒险模式)、锁定在物品栏且死亡不会掉落的一把完好钻石剑。

响应[编辑]

WebSocket[编辑]

  • :根对象
    •  header:报文消息的头。
      •  messagePurpose:该条报文消息的发送目的,对于命令响应恒为commandResponse
      •  requestId:造成该响应的请求报文的UUID。
      •  version:该报文的版本。
    •  body:报文消息的内容。
      •  statusCode:该响应的状态码。
      •  statusMessage:该响应的状态消息,对于命令响应为该命令的执行反馈文本。

Manual:/give/response

示例[编辑]

脚本API[编辑]

  • :根对象
    •  statusCode:该响应的状态码。
    •  statusMessage:该响应的状态消息,对于命令响应为该命令的执行反馈文本。

Manual:/someCommand/response

示例[编辑]

历史[编辑]

携带版
0.16.0build 1加入了/give命令。
用法与Java版1.10中基本相同:不支持数据标签,且player目标是可选的。
基岩版
1.1加入了json组件minecraft:can_place_onminecraft:can_destroy
1.16.100加入了json组件minecraft:item_lockminecraft:keep_on_death

画廊[编辑]

Template:Commands