手册:/give

give

命令

权限等级

1

命令旗标

用法旗标

普通命令（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：该响应的状态消息，对于命令响应为该命令的执行反馈文本。

脚本API

主页面：Manual:@minecraft/server.Dimension.runCommand

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

历史

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

画廊

• File:待添加