手冊:/clear

出自Minecraft基岩版开发Wiki
clear
用法旗標
普通命令(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:該響應的狀態訊息,對於命令響應為該命令的執行意見回饋文字。

Manual:/clear/response

範例[編輯]

腳本API[編輯]

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

Manual:/someCommand/response

範例[編輯]

歷史[編輯]

攜帶版
1.0.51.0.5.0加入了/clear命令。

畫廊[編輯]

Template:Commands