The Non Useful (トーク | 投稿記録) 細編集の要約なし |
(→引数) |
||
(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 [ |
+ | : <code>clear [<対象>] [<アイテム>] [<最大個数>]</code> |
* '''Bedrock Edition''' |
* '''Bedrock Edition''' |
||
− | : <code>clear [ |
+ | : <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> |
||
+ | |||
⚫ | |||
+ | |||
− | :: <code>clear Alice</code> |
||
+ | {{argument|最大個数|integer|maxCount: int|int}} |
||
⚫ | |||
+ | : 削除するアイテムの最大数を指定する。指定しない場合(および<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以下の値で指定する。 |
||
− | : すべてのプレイヤーのインベントリから橙色の羊毛を消去する |
||
+ | |||
⚫ | |||
⚫ | |||
⚫ | |||
+ | |||
⚫ | |||
+ | {{Result table}} |
||
⚫ | |||
+ | {{Result table|引数が適切に指定されていない|unparseable|unparseable}} |
||
⚫ | |||
+ | {{Result table|実行者がプレイヤーでないのに、<code><対象></code>・<code>player: target</code>が省略されている。|fail|fail}} |
||
⚫ | |||
+ | {{Result table|<code>player: target</code>が[[:en:Target selectors#Player type and single type|プレイヤータイプ]]でない。|-}} |
||
⚫ | |||
+ | {{Result table|<code><targets></code>・<code>player: target</code>から1人以上ののプレイヤーを検出できない。|fail}} |
||
⚫ | |||
+ | {{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のクラフトスロットもプレイヤーのインベントリ内と見なされ削除される。 |
||
+ | |||
+ | == 使用例 == |
||
⚫ | |||
⚫ | |||
+ | * Aliceのインベントリからすべての白色の羊毛を削除する:<code>clear Alice minecraft:white_wool</code> |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
+ | * ランダムなプレイヤーに対して、そのプレイヤーが石を持っているかどうか検査する:<code>clear @r minecraft:stone -1 0</code>{{only|Bedrock}} または<br> <code> clear @r minecraft:stone 0</code>{{only|Java}} |
||
== 歴史 == |
== 歴史 == |
||
− | {{ |
+ | {{history|java}} |
− | {{History||1. |
+ | {{History||1.4.2|snap=12w37a|{{cmd|clear|link=none}}が追加された。}} |
⚫ | |||
⚫ | |||
+ | {{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||1.0.5|snap=alpha 1.0.5.0|{{cmd|clear|link=none}}が追加された。}} |
+ | {{history|foot}} |
||
⚫ | |||
+ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
+ | * {{cmd|item}}{{only|java}} — エンティティのインベントリを置き換えたり、修飾子を付与したりする。 |
||
⚫ | |||
{{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時点における最新版
プレイヤーのインベントリからアイテムを消去する。カーソルで持っている状態でスロットには設置されていないアイテムにも作用する。
構文
- Java Edition
clear [<対象>] [<アイテム>] [<最大個数>]
- Bedrock Edition
clear [player: target] [itemName: Item] [data: int] [maxCount: int]
引数
JE:<対象>
:エンティティ
BE:player: target
:プレイヤー
- アイテムを削除するプレイヤーを指定する。デフォルトでは、コマンドを実行したプレイヤーが対象となる。
- プレイヤー名、ターゲットセレクターまたはUUID[Java Edition限定]で指定する。また、ターゲットセレクターはプレイヤーを指すものである必要がある。
JE:<アイテム>
:アイテム条件
BE:itemName: 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ビット整数
BE:maxCount: int
:32ビット整数
- 削除するアイテムの最大数を指定する。指定しない場合(および
-1
[Bedrock Edition限定]の場合)、item
およびitemName: Item
かつdata: int
に該当するアイテムがすべて削除される。0
を指定した場合、アイテムを削除する代わりに条件に一致するアイテムの個数が表示される。 - 32ビットの整数値で指定する。Java Editionでは,値は0以上2,147,483,647以下で指定する。 Bedrock Editionでは-1以上21億4748万3647以下の値で指定する。
結果
コマンド | トリガー | Java Edition | Bedrock Edition |
---|---|---|---|
任意 | 引数が適切に指定されていない | 構文解析不能 | 構文解析不能 |
実行者がプレイヤーでないのに、<対象> ・player: target が省略されている。 | 失敗 | 失敗 | |
player: target がプレイヤータイプでない。 | - | ||
<targets> ・player: target から1人以上ののプレイヤーを検出できない。 | 失敗 | ||
指定したアイテムがプレイヤーのインベントリがない。 | |||
data: int が-1未満。 | - | ||
maxCount: int が-1未満。 | |||
成功時 | 指定した条件によってアイテムを削除するか、条件にあったアイテムの数を検出する。 |
出力
コマンド | エディション | 状況 | 成功回数 | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
任意 | Java Edition | 失敗時 | 0 | 0 | 0 |
成功時 | 1 | 1 | 削除および検出されたアイテムの数。 | ||
Bedrock Edition | 失敗時 | 0 | N/A | N/A | |
成功時 | 指定のアイテムを持っていたプレイヤーの数。 | N/A | N/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.2 | 12w37a | /clear が追加された。 | |||
12w38a | /clear に引数item が追加された。 | ||||
1.8 | 14w02a | /clear に引数がdata 追加された。 | |||
1.9 | 15w31b | /clear でオフハンドのアイテムが削除されるようになった。 | |||
1.13 | 17w45a | /clear の構文が、/clear [<対象>] [<アイテム>] [<データ>] [<個数>] [<NBT>] から/clear [<target>] [<item>] [<count>] に変更された。 | |||
1.16 | 20w07a | /clear で、インベントリ内の2×2のクラフトスロットを削除できるようになった。 | |||
20w22a | /clear がインベントリ内のクラフトスロットに対して正しく機能するようになった。 | ||||
Pocket Edition | |||||
1.0.5 | alpha 1.0.5.0 | /clear が追加された。 |
関連項目
/data
— エンティティのインベントリ内のアイテムのデータを編集できる。/give
— プレイヤーにアイテムを与えることができる。/kill
— アイテムエンティティを破壊する。/item
[Java Edition限定] — エンティティのインベントリを置き換えたり、修飾子を付与したりする。/replaceitem
[Bedrock Edition限定] — エンティティおよびブロックエンティティのインベントリのアイテムを置き換える。