コマンド/item

Bedrock Editionでの同様の機能を持つコマンドについては「コマンド/replaceitem」をご覧ください。

item

必要権限レベル	2
実行制限	なし

このコマンドでは、収納ブロック（チェストやかまどなど）やエンティティ（プレイヤーやMob）のインベントリ上のアイテムを編集・コピーすることができる。

構文

item modify (block <座標>|entity <対象>) <スロット> <修飾子>

指定されたスロット上のアイテムに指定されたアイテム修飾子を作用させ、アイテムのデータや個数を編集する。

item replace (block <座標>|entity <対象>) <スロット> with <アイテム> [<個数>]

指定したスロットのアイテムを、指定したアイテムで置き換える。

item replace (block <座標>|entity <対象>) <スロット> from (block <参照元の座標>|entity <参照元の対象>) <参照元のスロット> [<修飾子>]

参照元のスロットのアイテムをコピーする。追加でアイテム修飾子を作用させることもできる。

引数

<座標>：ブロック座標

変更するブロックの座標を指定する。

整数またはチルダ・キャレット表記法で表記された<x>、<y>、<z>でブロック座標を指定する。

<対象>：エンティティ

変更する単一もしくは複数のエンティティを指定する。

プレイヤー名、ターゲットセレクターまたはUUIDで指定する。

<スロット>：インベントリのスロット

変更されるインベントリのスロットを指定する。有効な値はブロックもしくはエンティティによって異なる。

インベントリ内の特定のスロットに対応する文字列表記で指定する。

<修飾子>：名前空間付ID

選択したアイテムに作用させるアイテム修飾子を指定する。

名前空間IDで指定する。

<アイテム>：アイテム

ブロックやエンティティのインベントリのスロットに配置するアイテムを指定する。

アイテムの引数（アイテムタグは不可）で指定する。

<個数>：32ビット整数

ブロックやエンティティのインベントリのスロットに設定するアイテムの数を指定する。

32ビットの整数値で指定する。また、値は1以上64以下で指定する。

<参照元の座標>：ブロック座標

コピー元のブロックの座標を指定する。

整数またはチルダ・キャレット表記法で表記された<x>、<y>、<z>でブロック座標を指定する。

<参照元の対象>：エンティティ

コピー元のエンティティの座標を指定する。

プレイヤー名、ターゲットセレクターまたはUUIDで指定する。

<参照元のスロット>：インベントリのスロット

アイテムのコピー元のスロットを指定する。有効な数値はブロックやエンティティによって異なる。詳細は上記の <スロット> を参照。

結果

コマンド	トリガー	Java Edition
任意	引数が正しく指定されていない場合	構文解析不能
	<modifier>が存在しない場合	失敗
/item modify block ... /item replace block ...	<pos>がロードされた範囲でないもしくはワールドの外の場合
	<pos>のブロックがコンテナではない場合
	<pos>のブロックに指定されたスロットがない場合
/item modify entity ... /item replace entity ...	<targets>で１つ以上のエンティティに解決できない場合(名前のついたプレイヤーはオンラインでなければならない)
	選択された全てのエンティティが、次の一つ以上の条件を満たしている場合: 指定されたスロットがない (例: ゾンビにはhorse.armorがありません) 指定されたアイテムを指定されたスロットに設定することができない (例: 石をプレイヤーのarmor.chestに設定できません)
/... with <item> <count>	<count>が指定されたアイテムのスタック制限を超える場合
/... from block ...	<sourcePos>がロードされた範囲でないもしくはワールドの外の場合
	<sourcePos>のブロックがコンテナではない場合
	<sourcePos>のブロックに指定されたスロットがない場合
/... from entity ...	<sourceTarget>で１つ以上のエンティティに解決できない場合(名前のついたプレイヤーはオンラインでなければならない)
	<sourceTarget>のようなスロットがない (例: ゾンビにはhorse.armorがありません)
任意	成功時	指定されたスロットのアイテムを操作します。

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Java Edition	失敗時	0	0	0
/item (modify|replace) block ...		成功時	1	1	1
/item (modify|replace) entity ...		成功時	1	1	アイテムの置き換えに成功したエンティティの数

使用例

• ２ブロック上にあるチェストの、右下のスロットのアイテムをトウヒの苗木に置き換える:
  • /item replace block ~ ~2 ~ container.26 with minecraft:spruce_sapling 4
• 最も近いプレイヤーのホットバーの右端のスロットを４つのトウヒの苗木に置き換える:
  • /item replace entity @p hotbar.8 with minecraft:spruce_sapling 4
• コマンド実行者のオフハンドのアイテムをメインハンドのアイテムに置き換える:
  • /item replace entity @s weapon.offhand from entity @s weapon.mainhand
• プレイヤーの頭に茶色のbannerを置く:
  • /item replace entity @s armor.head with minecraft:brown_banner

歴史

Java Edition
1.17		20w46a			/itemを追加し/replaceitemが置き換えられた。
		21w19a			/itemの構文が変更された。

関連項目

• /data — コンテナのアイテムやMobのインベントリや武器や防具のドロップを変更できます
• /give — 特定のスロットやアイテムの上書きなしにプレイヤーへアイテムを与えます
• /replaceitem — Bedrock Editionでの同機能をもつコマンド

コマンド 

テンプレート:Commands/contentを表示 [編集]