コマンド/replaceitem

replaceitem

必要権限レベル	1
実行制限	チート限定

ブロック（チェストやかまどなど）やエンティティ（プレイヤーまたはMob）のインベントリにあるアイテムを、指定されたアイテムで置き換える。

構文

replaceitem block <position: x y z> slot.container <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]

replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <itemName: Item> [amount: int] [data: int] [components: json]

replaceitem block <position: x y z> slot.container <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]

replaceitem entity <target: target> <slotType: EntityEquipmentSlot> <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]

引数

<position: x y z>：CommandPosition

アイテムを置き換えるブロックの位置を指定する。

<x>、<y>、<z>の各値は、浮動小数点数またはチルダ・キャレット表記法で表記された3次元座標を指定する。

<target: target>：CommandSelector<Actor>

アイテムを置き換える1つ以上のエンティティを指定する。

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

slotType: EntityEquipmentSlot、slot.container および <slotId: int>：int

アイテムを置き換えるインベントリのスロットを指定する。有効な値は、ブロックとエンティティのどちらを置き換えるかによって異なる。

slotId: int は 32ビットの整数値で指定する。また、値は-2,147,483,648以上2,147,483,647以下で指定する。

ブロックの場合：slot.container <slotId: int> で指定する。<slotId: int>は、スロットを指す数字に置き換える。

• チェスト、ディスペンサー、ドロッパー、ホッパー、およびトラップチェストは、左上のスロットを0として、横方向、縦方向の順に数字が大きくなる。つまり、例えばチェストの一番上の段のスロット番号は、左から右に向かって順に0から8となっている。ラージチェストは、2つの通常チェストとして扱われる。
• 醸造台は、下のスロットが左から右に向かって順に0から2、上のスロットが3、燃料スロットが4となっている。
• かまどは、入力スロットが0、燃料スロットが1、出力スロットが2となっている。

エンティティの場合：以下のいずれかを指定する。スロットIDは、スロットを指す数字に置き換える。

スロット	スロット番号	制限
slot.armor.chest <slotId: int>	任意の番号	防具立て、Mob、 [プレイヤー]]のみ（ただし、すべてのMobがアイテムを表示したり使用したりするわけではない）
slot.armor.feet <slotId: int>	任意の番号
slot.armor.head <slotId: int>	任意の番号
slot.armor.legs <slotId: int>	任意の番号
slot.weapon.mainhand <slotId: int>	任意の番号
slot.weapon.offhand <slotId: int>	任意の番号
slot.container <slotId: int>	0–53	プレイヤー、トロッコのみ
slot.enderchest <slotId: int>	0–26	プレイヤーのみ
slot.hotbar <slotId: int>	0–8
slot.inventory <slotId: int>	0–26
slot.saddle <slotId: int>	任意の番号	ウマ、ロバ、ラバのみ。<item> または itemName: Item は、鞍でなければならない
slot.armor <slotId: int>	任意の番号‌[Bedrock Edition限定]	ウマ、ラマのみ。<item> または itemName: Item は、ウマの場合は馬鎧、ラマの場合はカーペットでなければならない
slot.chest <slotId: int>	0–14	チェストを装備したロバとラバのみ
slot.inventory <slotId: int>	0–7	村人のみ

<itemName: Item>：CommandItem

ブロックまたはエンティティのインベントリスロットに置き換えるアイテムを指定する。

<amount: int>：int

ブロックまたはエンティティのインベントリスロットに置き換えるアイテムの個数を指定する。

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

data: int：int

ブロックまたはエンティティのインベントリスロットに置き換えるアイテムのデータ値を指定する。有効でない値が指定された場合や、値が指定されなかった場合は0となる。

32ビットの整数値で指定する。また、値は-2,147,483,648以上2,147,483,647以下で指定する。

components: json：Json::Value

アイテムコンポーネントを指定する。データタグに似ているが、minecraft:can_place_on、minecraft:can_place_on、minecraft:can_destroy、minecraft:item_lock、および minecraft:keep_on_death の関数のみ有効である。（詳細はコマンド/give#使用例を参照）

JSON オブジェクトで指定する。

oldItemHandling: ReplaceMode

以下のいずれかを指定する。

destroy - 指定されたスロットの既存のアイテムを無視してアイテムを直接置き換える。

keep - 指定されたスロットに既にアイテムが存在している場合はアイテムを置き換えない。

結果

コマンド	トリガー	Bedrock Edition
任意	引数が正しく指定されていない場合	失敗
/replaceitem block ...	指定されたブロックがコンテナではない場合	失敗
	指定されたブロックに指定されたスロットが存在しない場合
/replaceitem entity ...	<targets> または target: target で指定されたターゲットが見つからない場合（プレイヤーの場合はオンラインである必要がある）
	対象のエンティティが以下のいずれかの条件を1つ以上満たしている場合： 指定されたスロットが存在しない場合（例えば、ソンビはスロット horse.armor を持たない） 指定されたアイテムを指定されたスロットに設定できない場合（例えば、プレイヤーの防具スロットには石を設定できない）
/replaceitem ... keep	置き換えモードが keep の場合に、指定されたスロットにアイテムが存在する場合
任意	成功時	指定されたスロットが指定されたアイテムで置き換えられる（それまでにスロットに存在したアイテムは消失する）

出力

コマンド	エディション	状況	成功回数	/execute store success ...	/execute store result ...
任意	Bedrock Edition	失敗字	0	N/A	N/A
/replaceitem block ...		成功時	1	N/A	N/A
/replaceitem entity ...		成功時	アイテムが正しく置き換えられたエンティティの数	N/A	N/A

使用例

• 2ブロック頭上にあるチェストの右下のスロットを、4個のマツの苗木に置き換える：
  • replaceitem block ~ ~2 ~ slot.container 26 sapling 4 1
• 最も近いプレイヤーのホットバーの一番右のスロットを、4個のマツの苗木に置き換える：
  • replaceitem entity @p slot.hotbar 8 sapling 4 1

歴史

Java Edition
1.8		14w26a			/replaceitem が追加された。
1.14		18w43a			/replaceitem が額縁に対して使用できるようになった。
1.17		20w46a			/replaceitem が削除され、/item replace に置き換えられた。
Pocket Edition
1.0.5		alpha 1.0.5.0			/replaceitem が追加された。
1.1.0		alpha 1.1.0.0			/replaceitem で関数 CanPlaceOn および CanDestroy が利用できるようになった。
Bedrock Edition
1.16.0		beta 1.16.0.55			/replaceitem にdestroyとkeepのオプションが追加された。

関連項目

• /item — Java Editionでの同等のコマンド
• /give — インベントリスロットを指定せず、また他のアイテムを置き換えることなく、プレイヤーにアイテムを与えることができるコマンド
• /setfixedinvslot（廃止） — Mobのインベントリのスロットを置き換えることができるコマンド

コマンド 

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