Minecraft Wiki

除另有声明,转载时均必须注明出处若簡繁轉換出錯,請以遊戲內為準请勇于扩充与修正内容有兴趣逛逛我们的微博沟通交流,欢迎到社区专页需要协助,请在告示板留言

了解更多

Minecraft Wiki
Advertisement
Disambig gray  關於Java版中功能大致相同的指令,請見「指令/item」。
Information icon
此特性為基岩版教育版獨有。
Rose (texture) JE1
該頁面所介紹的內容已從Java版中移除。

此指令已於Java版1.17/item指令取代。

replaceitem
需要的權限等級

1

限制條件

啟用作弊

替換方塊(儲物箱、熔爐等)或實體(玩家或生物)物品欄內的物品。

語法[]

replaceitem block <position: x y z> slot.container <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> <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(僅block模式)

指定要改變的方塊的位置。可用波浪號來指定一個相對於指令執行處的位置。

target: target(僅entity模式)

指定要改變的實體。必須為一個玩家名或目標選擇器

slotType: EntityEquipmentSlotslot.containerslotId: int

指定要改變的物品欄欄位。有效值取決於要改變的方塊或實體。
對於方塊,必須為slot.container 欄位編號,其中欄位編號用具體的欄位編號數值代替。
  • 儲物箱發射器投擲器漏斗陷阱儲物箱左上角的欄位被編號為0,而後從左到右、從上到下遞增(例如,儲物箱的第一行欄位被從左至右編號為0至8)。大型儲物箱與大型陷阱儲物箱被視為一個容器方塊。
  • 釀造台底部欄位從左至右編號為0至2,而其頂部欄位為3。烈焰粉的欄位為4。
  • 熔爐的欄位中輸入欄位編號為0,燃料欄位為1,而輸出欄位為2。
對於實體,必須為下列之一,其中欄位編號用具體的欄位編號數值代替:
欄位 欄位編號 限制
slot.weapon.mainhand 槽位编号 任意值 盔甲座生物玩家(雖然並非所有生物會顯示或利用這些物品)
slot.weapon.offhand 欄位編號
slot.armor.head 欄位編號(頭盔)
slot.armor.chest 欄位編號(胸甲)
slot.armor.legs 欄位編號(護腿)
slot.armor.feet 欄位編號(靴子)
slot.enderchest 欄位編號 0至26 玩家
slot.hotbar 欄位編號 0至8
slot.inventory 欄位編號 0至物品欄的欄位上限 玩家村民豬布林貓熊悅靈漏斗礦車儲物箱礦車指令方塊礦車,以及馴服的驢子騾子駱馬
slot.saddle 欄位編號 任意值 僅馴服的驢子騾子物品名必須為空氣
slot.armor 欄位編號 0至1 僅馴服的物品名必須屬於馬鎧空氣
slot.chest 欄位編號 0至14 僅馱儲物箱的驢子騾子
slot.equippable 欄位編號 0至1僅hasitem 0:僅驢子騾子物品名必須為空氣
1:僅駱馬物品名必須屬於馬鎧(馬)、地毯(駱馬)或空氣

itemName: Item

指定被放置於方塊或實體的物品欄欄位內的物品。必須為物品ID,或具有物品形態的方塊的ID

amount: int(可選)

指定被放置物品的數量。必須在1至64間(含),可以突破物品的堆疊限制。

data: int(可選)

指定被放置物品的物品資料。必須為一個在-2,147,483,648至2,147,483,647間(含,不輸入逗號)的整數,且在對指定物品無效時被重設為0。若未指定,預設為0。

components: json(可選)

指定被放置物品的物品組件。類似於NBT標籤,但僅支持minecraft:can_place_onminecraft:can_destroyminecraft:item_lockminecraft:keep_on_death

oldItemHandling: ReplaceMode(可選)

必須是下列之一:
  • destroy - 忽略指定欄位中的原始物品,直接進行替換。
  • keep - 如果一個物品占用了該欄位,則不進行替換。

效果[]

指令觸發條件基岩版
任意參數未正確指定 無法解析
amount: int小於1或大於64 執行失敗
/replaceitem block ...指定的方塊並非容器
指定的方塊不擁有指定的欄位
/replaceitem entity ...<target: target> 無法解析指定實體(指定玩家必須線上)
目標實體沒有指定的欄位(例如,殭屍沒有slot.armor),或指定欄位無法被替換為指定物品
指定欄位無法放入指定物品(例如玩家的armor.chest無法放入石頭)
/replaceitem ... keepkeep模式下指定的欄位已擁有物品
任意執行成功時將指定欄位替換為指定物品(原物品丟失)

輸出[]

指令版本條件成功次數/execute store success .../execute store result ...
任意基岩版執行失敗0N/AN/A
/replaceitem block ...執行成功1N/AN/A
/replaceitem entity ...執行成功被成功替換物品的實體的數量N/AN/A

示例[]

  • 將上方1格處的一個小型儲物箱右下角欄位內的物品替換成4棵杉木樹苗
replaceitem block ~ ~1 ~ slot.container 26 minecraft:sapling 4 1
  • 將自己的快捷欄最右欄位內的物品替換成4棵杉木樹苗:
replaceitem entity @s slot.hotbar 8 minecraft:sapling 4 1
  • 將所有人的非慣用手內的物品換成空氣:
replaceitem entity @a slot.weapon.offhand 0 air 1 0
  • 把自己物品欄右下角欄位內的物品換成空氣:
replaceitem entity @s slot.inventory 26 air 1 0

歷史[]

Java版
1.814w26a加入了/replaceitem指令。
1.1418w43a現在可以在物品展示框上使用。
1.1720w46a移除了/replaceitem,並加入了/item取代其功能。
攜帶版
1.0.51.0.5.0加入了/replaceitem指令。
1.1.01.1.0.0現在/replaceitem指令支持canplaceoncandestroy
基岩版
1.16.01.16.0.55/replaceitem加入了新參數destroykeep來指定替換模式。

參見[]

  • /data - 也能替換一個容器或實體物品欄中的物品,或改變盔甲與武器的掉落率。
  • /give - 不指定具體欄位、不覆蓋原有物品地給予玩家物品。

語言

Advertisement