Minecraft Wiki
編集の要約なし
 
(3人の利用者による、間の3版が非表示)
1行目: 1行目:
  +
{{Infobox command
{{:コマンド/infobox
 
|clear
+
|name=clear
  +
|oplevel=
|op
 
  +
* 2 {{only|java|short=1}}
|Java Edition 1.4.2|Java Edition 12w37a
 
  +
* 1 {{only|bedrock|short=1}}
|PE 1.0.5|Pocket Edition alpha 1.0.5.0
 
  +
|others=[[設定|チート]]限定{{only|bedrock|short=1}}
 
}}
 
}}
   
プレイヤーのインベントリからアイテムを消去する。
+
[[プレイヤー]][[インベントリ]]からアイテムを消去する。カーソルで持っている状態でスロットには設置されていないアイテムにも作用する。
 
== 構文 ==
 
;構文
 
   
 
* '''Java Edition'''
 
* '''Java Edition'''
: <code>clear [''<targets>''] [''<item>''] [''<maxCount>'']</code>
+
: <code>clear [<対象>] [<アイテム>] [<最大個数>]</code>
   
 
* '''Bedrock Edition'''
 
* '''Bedrock Edition'''
: <code>clear [''player: target''] [''itemName: Item''] [''data: int''] [''maxCount: int'']</code>
+
: <code>clear [player: target] [itemName: Item] [data: int] [maxCount: int]</code>
  +
;引数
+
== 引数 ==
: ''targets''(BE:''player: target'')(省略可能)
 
  +
{{argument|対象|entity|player: target|CommandSelector<Player>}}
:: プレイヤー名、または[[#ターゲットセレクター|ターゲットセレクター]]でなければならない。指定されなかった場合、コマンドを実行したプレイヤーが対象となる。コマンドブロックでは、この引数は必須となる。
 
  +
: アイテムを削除するプレイヤーを指定する。デフォルトでは、コマンドを実行したプレイヤーが対象となる。
: ''item''(BE: ''itemName: Item'')(省略可能)
 
  +
: {{arg desc|je=entity|amount=multiple|type=players|be=player}}
:: 消去するアイテムの[[データ値|ID]]を指定する。指定されなかった場合、プレイヤーのインベントリ内にあるすべてのアイテムを消去する。
 
  +
: ''data: int''(省略可能){{only|bedrock}}
 
  +
:: 消去するアイテムの[[データ値]]を指定する。指定されなかった、または <code>-1</code> が指定された場合、アイテムのデータ値に関わらず''item''に合致するすべてのアイテムを消去する。
 
  +
{{argument|アイテム|item_predicate|itemName: Item|enum}}
: ''maxCount''(BE: ''maxCount: int'')(省略可能)
 
  +
: 削除するアイテムを指定する。{{in|je}}、絞り込むNBTタグもここで指定する。
:: 消去するアイテムの最大個数を指定する。指定されなかった、または <code>-1</code> が指定された場合{{only|bedrock}}、''item''および''data''に合致するすべてのアイテムを消去する。<code>0</code> が指定された場合はアイテムは消去されないが、条件に合致するアイテムが存在した場合、結果は成功となる(アイテムの消去ではなくアイテムの検知が可能となる)。
 
  +
: {{arg desc|je=item_predicate|be=CommandItem}}
;結果
 
  +
: 引数が正しく指定されなかった、''player''引数でオンラインのプレイヤーを解決できなかった、またはアイテムが消去できなかった(''maxCount''が <code>0</code> である場合を除く)場合に失敗する。
 
  +
: 成功すると、プレイヤーから指定したアイテムが消去される。
 
  +
{{argument|data: int|int}}
;例
 
  +
: 削除するアイテムの[[データ値/Bedrock Edition|データ値]]を指定する。指定しなかった場合および<code>-1</code>を指定した場合は、<code>itemName: Item</code>の指定に該当するすべてのアイテムが削除される。指定したアイテムの種類に対して無効なデータ値を指定した場合は、0を指定したものとして見なされる。
:のインベントリからすべてのアイテムを消去する
 
  +
: {{arg desc|be=int}} -1以上21億4748万3647以下の値で指定する。
:: <code>clear</code>
 
  +
: Aliceのインベントリからすべてのアイテムを消去する
 
  +
:: <code>clear Alice</code>
 
  +
{{argument|最大個数|integer|maxCount: int|int}}
: Aliceのインベントリからすべての羊毛を消去する
 
  +
: 削除するアイテムの最大数を指定する。指定しない場合(および<code>-1</code>{{only|bedrock}}の場合)、<code>item</code>および<code>itemName: Item</code>かつ<code>data: int</code>に該当するアイテムがすべて削除される。<code>0</code>を指定した場合、アイテムを削除する代わりに条件に一致するアイテムの個数が表示される。
:: <code>clear Alice minecraft:wool</code>
 
  +
: {{arg desc|be=int|je=integer|min=0}} {{IN|bedrock}}-1以上21億4748万3647以下の値で指定する。
: すべてのプレイヤーのインベントリから橙色の羊毛を消去する
 
  +
:: <code>clear @a minecraft:wool 1</code>{{only|Bedrock}}<code>clear @a minecraft:orange_wool</code>{{only|Java}}
 
 
== 結果 ==
:寄りのプレイヤーのインベントリから「ダメージ増加 I」のエンチャント効果が付与された金の剣を消去する
 
  +
:: <code>clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}</code>{{only|Java}}
 
  +
{{Result table}}
;関連項目
 
  +
{{Result table|引数が適切に指定されていない|unparseable|unparseable}}
: {{cmd|data}} — ブロック、またはエンティティのインベントリのアイテムを変更または消去すコマンド
 
  +
{{Result table|実行者がプレイヤーでないのに、<code><対象></code>・<code>player: target</code>が省略されている。|fail|fail}}
: {{cmd|give}} — プレイヤーにアイテムを与えるコマンド
 
  +
{{Result table|<code>player: target</code>が[[:en:Target selectors#Player type and single type|プレイヤータイプ]]でない。|-}}
: {{cmd|kill}} — アイテムエンティティを消去するコマンド
 
  +
{{Result table|<code><targets></code>・<code>player: target</code>から1人以上ののプレイヤーを検出できない。|fail}}
: {{cmd|replaceitem}} — ブロックエンティティのインベントリのアイテムを置換コマンド
 
  +
{{Result table|指定したアイテムがプレイヤーのインベントリがない。}}
  +
{{Result table|<code>data: int</code>が-1未満。|-}}
  +
{{Result table|<code>maxCount: int</code>が-1未満。}}
  +
{{Result table|succeed|指定した条件によってアイテムを削除するか、条件にあったアイテムの数を検出する。}}
  +
{{Result table}}
  +
  +
== 出力 ==
  +
  +
{{Output table}}
  +
{{Output table|edition=je|失敗時|0|0|0}}
  +
{{Output table|成功時|1|1|削除および検出されたアイテムの数。}}
  +
{{Output table|edition=be|失敗時|0}}
  +
{{Output table|成功時|指定のアイテムを持っていたプレイヤーの数。}}
  +
{{Output table}}
  +
  +
== 注釈 ==
  +
プレイヤーがチェストや作業台などのUIを開いている時にも、チェストや作業台側のスロットのアイテムはプレイヤーのインベントリ外と見なされ削除されない。ただし、インベントリ外からカーソルで摑んで取り出したアイテムに関しては削除される。
  +
  +
{{IN|bedrock}}インベントリ内からカーソルで取り出したアイテムは全モードで削除されるが、{{in|java}}クリエイティブモードに限り削除されない。
  +
  +
{{IN|java}}、プレイヤーの2×2のクラフトスロットもプレイヤーのインベントリ内と見なされ削除される。
  +
  +
== 使用例 ==
 
*のインベントリからすべてのアイテムを削除する:<code>clear</code>
 
* Aliceのインベントリからすべてのアイテムを削除する:<code>clear Alice</code>
  +
* Aliceのインベントリからすべての白色の羊毛を削除する:<code>clear Alice minecraft:white_wool</code>
 
* Aliceのインベントリからすべての羊毛を削除する:<code>clear Alice #minecraft:wool</code>
 
* 全てのプレイヤーから橙色の羊毛を削除する:<code>clear @a minecraft:wool 1</code>{{only|Bedrock}} または<br> <code> clear @a minecraft:orange_wool</code>{{only|Java}}
 
*も近いプレイヤーから「ダメージ増加」のエンチャントのついた金の剣を削除する
 
** <code>clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}</code>{{only|Java}}
  +
* ランダムなプレイヤーに対して、そのプレイヤーが石を持っているかどうか検査する:<code>clear @r minecraft:stone -1 0</code>{{only|Bedrock}} または<br> <code> clear @r minecraft:stone 0</code>{{only|Java}}
   
 
== 歴史 ==
 
== 歴史 ==
{{h|java}}
+
{{history|java}}
{{History||1.3.1|snap=12w37a|{{cmd|clear|link=none}} が追加された。}}
+
{{History||1.4.2|snap=12w37a|{{cmd|clear|link=none}}が追加された。}}
 
{{history|||snap=12w38a|{{cmd|clear|link=none}}に引数{{cd|item}}が追加された。}}
 
{{history||1.8|snap=14w02a|{{cmd|clear|link=none}}に引数{{cd|data}}追加された。}}
  +
{{History||1.9|snap=15w31b|{{cmd|clear|link=none}}でオフハンドのアイテムが削除されるようになった。}}
  +
{{History||1.13|snap=17w45a|{{cmd|clear|link=none}}の構文が、{{cmd|clear [<対象>] [<アイテム>] [<データ>] [<個数>] [<NBT>]}}から{{cmd|clear [<target>] [<item>] [<count>]}}に変更された。}}
  +
{{History||1.16|snap=20w07a|{{cmd|clear|link=none}}で、インベントリ内の2×2のクラフトスロットを削除できるようになった。}}
  +
{{History|||snap=20w22a|{{cmd|clear|link=none}}がインベントリ内のクラフトスロットに対して正しく機能するようになった。}}
   
  +
{{history|pocket}}
{{history|||snap=12w38a|引数 {{cd|item}} が追加された。}}
 
{{history||1.8|snap=14w02a|引数 {{cd|data}} が追加された。}}
+
{{History||1.0.5|snap=alpha 1.0.5.0|{{cmd|clear|link=none}}が追加された。}}
   
  +
{{history|foot}}
{{history|Bedrock Edition}}{{History||1.0.5|snap=alpha 1.0.5.0|{{cmd|clear|link=none}} が追加された。}}
 
  +
 
== 関連項目 ==
 
* {{cmd|data}} — エンティティのインベントリのアイテムのデータ編集でき
 
* {{cmd|give}} — プレイヤーにアイテムを与えることができる。
 
* {{cmd|kill}} — アイテムエンティティを破壊する
  +
* {{cmd|item}}{{only|java}} — エンティティのインベントリを置き換えたり、修飾子を付与したりする。
 
* {{cmd|replaceitem}}{{only|bedrock}} — エンティティおよびブロックエンティティのインベントリのアイテムを置
   
 
{{h|foot}}
 
{{h|foot}}
61行目: 105行目:
 
[[カテゴリ:Java Edition]]
 
[[カテゴリ:Java Edition]]
 
[[カテゴリ:Bedrock Edition]]
 
[[カテゴリ:Bedrock Edition]]
  +
   
 
[[de:Befehl/clear]]
 
[[de:Befehl/clear]]

2023年10月5日 (木) 09:46時点における最新版

clear
必要権限レベル
  • 2 ‌[JE限定]
  • 1 ‌[BE限定]
実行制限

チート限定‌[BE限定]

プレイヤーインベントリからアイテムを消去する。カーソルで持っている状態でスロットには設置されていないアイテムにも作用する。

構文

  • Java Edition
clear [<対象>] [<アイテム>] [<最大個数>]
  • Bedrock Edition
clear [player: target] [itemName: Item] [data: int] [maxCount: int]

引数

JE<対象>エンティティ
BEplayer: targetプレイヤー

アイテムを削除するプレイヤーを指定する。デフォルトでは、コマンドを実行したプレイヤーが対象となる。
プレイヤー名、ターゲットセレクターまたはUUID[Java Edition限定]で指定する。また、ターゲットセレクターはプレイヤーを指すものである必要がある。


JE<アイテム>アイテム条件
BEitemName: Item文字列(引用符無し)

削除するアイテムを指定する。Java Editionでは、絞り込むNBTタグもここで指定する。
アイテムの引数(アイテムタグも可)Java Editionでは, it指定する。 Bedrock Editionでは, it must be a item id or a block ID for which items exist.


<data: int>int

削除するアイテムのデータ値を指定する。指定しなかった場合および-1を指定した場合は、itemName: Itemの指定に該当するすべてのアイテムが削除される。指定したアイテムの種類に対して無効なデータ値を指定した場合は、0を指定したものとして見なされる。
32ビットの整数値で指定する。 -1以上21億4748万3647以下の値で指定する。


JE<最大個数>32ビット整数
BEmaxCount: int32ビット整数

削除するアイテムの最大数を指定する。指定しない場合(および-1[Bedrock Edition限定]の場合)、itemおよびitemName: Itemかつdata: intに該当するアイテムがすべて削除される。0を指定した場合、アイテムを削除する代わりに条件に一致するアイテムの個数が表示される。
32ビットの整数値で指定する。Java Editionでは,値は0以上2,147,483,647以下で指定する。 Bedrock Editionでは-1以上21億4748万3647以下の値で指定する。

結果

コマンドトリガーJava EditionBedrock Edition
任意引数が適切に指定されていない 構文解析不能 構文解析不能
実行者がプレイヤーでないのに、<対象>player: targetが省略されている。 失敗 失敗
player: targetプレイヤータイプでない。 -
<targets>player: targetから1人以上ののプレイヤーを検出できない。 失敗
指定したアイテムがプレイヤーのインベントリがない。
data: intが-1未満。 -
maxCount: intが-1未満。
成功時指定した条件によってアイテムを削除するか、条件にあったアイテムの数を検出する。

出力

コマンドエディション状況成功回数/execute store success .../execute store result ...
任意Java Edition失敗時000
成功時11削除および検出されたアイテムの数。
Bedrock Edition失敗時0N/AN/A
成功時指定のアイテムを持っていたプレイヤーの数。N/AN/A

注釈

プレイヤーがチェストや作業台などのUIを開いている時にも、チェストや作業台側のスロットのアイテムはプレイヤーのインベントリ外と見なされ削除されない。ただし、インベントリ外からカーソルで摑んで取り出したアイテムに関しては削除される。

Bedrock Editionではインベントリ内からカーソルで取り出したアイテムは全モードで削除されるが、Java Editionではクリエイティブモードに限り削除されない。

Java Editionでは、プレイヤーの2×2のクラフトスロットもプレイヤーのインベントリ内と見なされ削除される。

使用例

  • 自身のインベントリからすべてのアイテムを削除する:clear
  • Aliceのインベントリからすべてのアイテムを削除する:clear Alice
  • Aliceのインベントリからすべての白色の羊毛を削除する:clear Alice minecraft:white_wool
  • Aliceのインベントリからすべての羊毛を削除する:clear Alice #minecraft:wool
  • 全てのプレイヤーから橙色の羊毛を削除する:clear @a minecraft:wool 1[Bedrock Edition限定] または
    clear @a minecraft:orange_wool[Java Edition限定]
  • 最も近いプレイヤーから、「ダメージ増加Ⅰ」のエンチャントのついた金の剣を削除する。
    • clear @p minecraft:golden_sword{Enchantments:[{id:"minecraft:sharpness",lvl:1s}]}[Java Edition限定]
  • ランダムなプレイヤーに対して、そのプレイヤーが石を持っているかどうか検査する:clear @r minecraft:stone -1 0[Bedrock Edition限定] または
    clear @r minecraft:stone 0[Java Edition限定]

歴史

Java Edition
1.4.212w37a/clearが追加された。
12w38a/clearに引数itemが追加された。
1.814w02a/clearに引数がdata追加された。
1.915w31b/clearでオフハンドのアイテムが削除されるようになった。
1.1317w45a/clearの構文が、/clear [<対象>] [<アイテム>] [<データ>] [<個数>] [<NBT>]から/clear [<target>] [<item>] [<count>]に変更された。
1.1620w07a/clearで、インベントリ内の2×2のクラフトスロットを削除できるようになった。
20w22a/clearがインベントリ内のクラフトスロットに対して正しく機能するようになった。
Pocket Edition
1.0.5alpha 1.0.5.0/clearが追加された。

関連項目

  • /data — エンティティのインベントリ内のアイテムのデータを編集できる。
  • /give — プレイヤーにアイテムを与えることができる。
  • /kill — アイテムエンティティを破壊する。
  • /item[Java Edition限定] — エンティティのインベントリを置き換えたり、修飾子を付与したりする。
  • /replaceitem[Bedrock Edition限定] — エンティティおよびブロックエンティティのインベントリのアイテムを置き換える。