手冊:/clear

clear

命令

權限等級

1

命令旗標

用法旗標

普通命令（0）

可見性旗標

可見（0）

同步旗標

同步命令（0）

執行旗標

允許執行（0）

型別旗標

無型別（0）

作弊旗標

作弊命令（0）

遊戲內描述

“

清空玩家物品欄中的物品。

”

限制條件

無

/clear命令用於清除玩家物品欄中的物品。

語法

clear [player: target] [itemName: Item] [data: int] [maxCount: int]

參數

player

target型別，目標選擇器或玩家名，指定待清除背包的玩家。目標選擇器只能是玩家。如果未指定，預設指定為命令執行者。

itemName

Item型別，物品ID，指定待清除的物品，必須是一個物品ID或存在其物品形式的方塊ID。如果未指定，預設指定所有物品。

data

int型別，指定待清除物品的數據值（例如顏色方向等）。

如果未指定或指定的數據值對此物品無效則為0，如果指定為-1則不考慮此物品的數據值。必須為-1到2147483647之間的數字（含）。

maxCount

int型別，指定要被清除的物品的最大數目。

必須為-1到2147483647之間的數字（含）。

效果

命令	觸發條件	執行結果
任意	參數未正確指定	失敗
	玩家物品欄中不存在指定物品
	[player: target]不存在或指定了非玩家目標
	在指定了有效的命令名，正常給出了命令的用法時	成功
	可清除的物品數小於最大數量指定的數目
	最大清除數量為0

輸出

命令	執行結果	成功次數增量
任意	失敗	0
	成功	擁有指定物品的玩家數

範例

/clear - 清除自己的物品。

/clear @a - 清除所有玩家的所有物品。

/clear @r diamond - 清除隨機一名玩家的鑽石。

/clear @p wool 5 - 清除最近玩家的淺綠色羊毛(數據值為5代表淺綠色)。

/clear @a concrete -1 64 - 清除所有玩家至多64個任意數據值的混凝土。

/clear @a wool 14 0 - 檢測玩家是否有紅色羊毛。

響應

WebSocket

• ：根物件
  •  header：報文訊息的頭。
    •  messagePurpose：該條報文訊息的傳送目的，對於命令響應恆為commandResponse。
    •  requestId：造成該響應的請求報文的UUID。
    •  version：該報文的版本。
  •  body：報文訊息的內容。
    •  statusCode：該響應的狀態碼。
    •  statusMessage：該響應的狀態訊息，對於命令響應為該命令的執行意見回饋文字。

腳本API

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

• ：根物件
  •  statusCode：該響應的狀態碼。
  •  statusMessage：該響應的狀態訊息，對於命令響應為該命令的執行意見回饋文字。

歷史

攜帶版
1.0.5		1.0.5.0			加入了/clear命令。

畫廊

• 
  命令/clear的說明頁面。
• 
  命令clear @a grass的執行效果，但並不會輸出它清除了什麼方塊。
• 
  命令clear @a wool 14 0的執行效果，很明顯它的功用轉為了檢測而非清除。
• 
  檢測玩家是否有紅色羊毛的簡易命令裝置，其中重複型指令方塊內的命令為clear @a wool 14 0，而連鎖式指令方塊為title @a actionbar 有玩家拥有红色羊毛。。