手冊:/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:待加入