命令/replaceitem

关于Java版中功能大致相同的命令，请见“命令/item”。

本文章所述内容仅适用于基岩版和​教育版。

此条目所介绍的内容已从Java版中移除。

此命令已于Java版1.17被/item命令取代。

replaceitem

需要的权限等级

1

限制条件

启用作弊

替换方块（箱子、熔炉等）或实体（玩家或生物）物品栏内的物品。

目录

1 语法

2 参数

3 结果

4 输出

5 示例

6 历史

7 参见

8 导航

语法[编辑 | 编辑源代码]

replaceitem block slot.container [amount: int] [data: int] [components: json]

replaceitem block slot.container [amount: int] [data: int] [components: json]

replaceitem entity [amount: int] [data: int] [components: json]

replaceitem entity [amount: int] [data: int] [components: json]

参数[编辑 | 编辑源代码]

position: x y z（仅block模式）

指定要改变的方块的位置。可用波浪号（~ ~ ~）或脱字符（^ ^ ^）来指定一个相对于命令执行处的位置。

target: target（仅entity模式）

指定要改变的实体。必须为一个玩家名或目标选择器。

slotType: EntityEquipmentSlot、slot.container和slotId: int

指定要改变的物品栏槽位。有效值取决于要改变的方块或实体。

对于方块，必须为slot.container 槽位编号，其中槽位编号用具体的槽位编号数值代替。

箱子、发射器、投掷器、漏斗和陷阱箱左上角的槽位被编号为0，而后从左到右、从上到下递增（例如，箱子的第一行槽位被从左至右编号为0至8）。大型箱子与大型陷阱箱被视为一个整体，其槽位编号为0至53。

酿造台底部槽位从左至右编号为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。

amount: int（可选）

指定被放置物品的数量。必须在1至64间（含），可以突破物品的堆叠限制。

当该值突破某物品的堆叠限制时，命令仍会执行成功，但得到的总是该物品的最大堆叠数量（如执行/replaceitem entity @a slot.weapon.mainhand 0 snowball 64会将所有玩家的主手替换为16个雪球）。

data: int（可选）

指定被放置物品的物品数据。必须为一个在-2,147,483,648至2,147,483,647间（含，不输入逗号）的整数，且在对指定物品无效时被重置为0。若未指定，默认为0。

components: json（可选）

指定被放置物品的物品组件。类似于NBT标签，但仅支持minecraft:can_place_on、minecraft:can_destroy、minecraft:item_lock、minecraft:keep_on_death。

oldItemHandling: ReplaceMode（可选）

必须是下列之一：

destroy - 忽略指定槽位中的原始物品，直接进行替换。

keep - 如果一个物品占用了该槽位，则不进行替换。

结果[编辑 | 编辑源代码]

命令触发条件基岩版

任意参数未正确指定 无法解析

amount: int小于1或大于64 执行失败

/replaceitem block ...指定的方块并非容器

指定的方块没有指定的槽位

/replaceitem entity ...未能选中至少一个实体（若指定玩家名则必须在线）

所有选中的实体均满足以下至少一个条件：

目标实体没有指定的槽位（例如，僵尸没有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

给所有僵尸都戴上金头盔：

replaceitem entity @e[type=zombie] slot.armor.head 0 golden_helmet

历史[编辑 | 编辑源代码]

Java版1.814w26a加入了/replaceitem命令。1.1418w43a现在可以在物品展示框上使用。1.1720w46a移除了/replaceitem，并加入了/item取代其功能。携带版1.0.51.0.5.0加入了/replaceitem命令。1.1.01.1.0.0现在/replaceitem命令支持canplaceon和candestroy。基岩版1.16.01.16.0.55为/replaceitem加入了新参数destroy和keep来指定替换模式。

参见[编辑 | 编辑源代码]

/data - 也能替换一个容器或实体物品栏中的物品，或改变盔甲与武器的掉落率。

/give - 不指定具体槽位、不覆盖原有物品地给予玩家物品。

导航[编辑 | 编辑源代码]

查

论

编命令

当前可用

clear

clone

damage

deop

difficulty

effect

enchant

execute

experience

xp

fill

function

gamemode

gamerule

give

help

kick

kill

list

locate

loot

me

op

particle

place

playsound

recipe

reload

ride

say

schedule

scoreboard

setblock

setworldspawn

spawnpoint

spreadplayers

stop

stopsound

summon

tag

msg

tell

w

tellraw

time

title

teleport

tp

transfer

weather

whitelist

仅Java版

advancement

attribute

ban

ban-ip

banlist

bossbar

data

datapack

debug

defaultgamemode

dialog

fetchprofile[新增：JE 1.21.9]

fillbiome

forceload

item

jfr

pardon

pardon-ip

perf

publish

random

return

rotate

save-all

save-off

save-on

seed

setidletimeout

spectate

team

teammsg

tm

test

tick

trigger

version

warden_spawn_tracker

waypoint

worldborder

仅基岩版

allowlist

changesetting

clearrealmevents

gametips

project

reloadconfig

reloadpacketlimitconfig

save

sendshowstoreoffer

仅教育版

classroommode

code

getchunkdata

getchunks

geteduclientinfo

geteduserverinfo

getspawnpoint

globalpause

resourceuri

takepicture

基岩版和教育版

?

ability

agent

aimassist

camera

camerashake

clearspawnpoint

closewebsocket

codebuilder_actorinfo

controlscheme

daylock

alwaysday

dedicatedwsserver

dialogue

enableencryption

event

fog

gametest

gettopsolidblock

hud

immutableworld

inputpermission

listd

mobevent

music

permission

ops

playanimation

querytarget

replaceitem

script

scriptevent

setmaxplayers

structure

testforblocks

testforblock

testfor

tickingarea

titleraw

toggledownfall

worldbuilder

wsserver

connect

已移除

placefeature

仅Java版

?

achievement

banip

blockdata

broadcast

entitydata

home

iron

locatebiome

replaceitem

setspawn

solid

stats

toggledownfall

testfor

testforblock

testforblocks

unban

wood

仅基岩版

clearfixedinv

mixer

resupply

set_movement_authority

setfixedinvslot

setfixedinvslots

simulationtype

volumearea

仅教育版

collect

dropall

move

position

tpagent

transfer

turn

基岩版和教育版

attack

createagent

destroy

detect

detectredstone

drop

executeasother

executeasself

getitemcount

getitemdetail

getitemspace

inspectdata

inspect

place

till

transferserver