Minecraft Wiki
Advertisement
Information icon.svg
この項目はBedrock Edition、およびEducation Edition限定の要素です。 
Rose (texture) JE1.png
このページでは、 Java Editionの古いバージョンに存在する要素について説明しています。 
このコマンドは、Java Edition 1.17/item コマンドに置き換えられました。
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: EntityEquipmentSlotslot.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: intint

ブロックまたはエンティティのインベントリスロットに置き換えるアイテムのデータ値を指定する。有効でない値が指定された場合や、値が指定されなかった場合は0となる。
32ビットの整数値で指定する。また、値は-2,147,483,648以上2,147,483,647以下で指定する。


components: jsonJson::Value

アイテムコンポーネントを指定する。データタグに似ているが、minecraft:can_place_onminecraft:can_place_onminecraft:can_destroyminecraft: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失敗字0N/AN/A
/replaceitem block ...成功時1N/AN/A
/replaceitem entity ...成功時アイテムが正しく置き換えられたエンティティの数N/AN/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.814w26a/replaceitem が追加された。
1.1418w43a/replaceitem額縁に対して使用できるようになった。
1.1720w46a/replaceitem が削除され、/item replace に置き換えられた。
Pocket Edition
1.0.5alpha 1.0.5.0/replaceitem が追加された。
1.1.0alpha 1.1.0.0/replaceitem で関数 CanPlaceOn および CanDestroy が利用できるようになった。
Bedrock Edition
1.16.0beta 1.16.0.55/replaceitem にdestroyとkeepのオプションが追加された。

関連項目[]

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