/replaceitem

/replaceitem

Nível de permissão exigido	Desconhecido
Restrições	Nenhuma

{
    "title": "<code>/replaceitem</code>",
    "rows": [
        {
            "field": "Desconhecido",
            "label": "(link to Nível de permissão article, displayed as Nível de permissão<br />exigido)"
        },
        {
            "field": "Nenhuma",
            "label": "(link to Comandos#Restrições article, displayed as Restrições)"
        }
    ],
    "invimages": [],
    "images": []
}

Substituir itens nos inventários de blocos (baú, fornalhas, etc.) ou entidades (jogadores ou criaturas) com os itens dados.

Sintaxe

• Edição Java

replaceitem block <pos> <slot> <item> [<qunatidade>]

replaceitem entity <alvos> <slot> <item> [<qunatidade>]

• Edição Bedrock

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

replaceitem entity <target: alvo> <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: alvo> <slotType: EntityEquipmentSlot> <slotId: int> <oldItemHandling: ReplaceMode> <itemName: Item> [amount: int] [data: int] [components: json]

Argumentos

EJ: <pos>: block_pos
EB: position: x y z: CommandPosition

Especifica a posição do bloco a ser modificado.

EJ: <alvos>: entity
EB: target: target: CommandSelector<Actor>

Deve ser um nome de jogador, seletores de destino ou o UUID‌. 

Especifica uma ou mais entidades para modificar.

EJ: <slot>: item_slot
EB: slotType: EntityEquipmentSlot: Slot de Equipamento, slot.container e <slotId: int>: int

Especifica o slot de inventário a ser modificado. Os valores válidos dependem se um bloco ou entidade está sendo modificado.

Na Edição Bedrock, slotId: int deve ser um Número inteiro de 32 bits (de -2147483648 (-2³¹) a 2147483647 (2³¹-1) ). E deve ser entre -2147483648 e 2147483647 (inclusivo).

Por blocos, deve ser container.<slot_number> (BE: slot.container <slotId: int>) onde <slot_number> ou <slotId: int> é substituído por um número especificando o slot.

• Baús, ejetores, liberadores, funil, e baú com armadilhas são numerados 0 para o slot superior esquerdo e, em seguida, aumentam primeiro horizontalmente, depois verticalmente (então, por exemplo, os slots da linha superior de um baú são numerados de 0 a 8 da esquerda para a direita). Baús duplos e baús duplos com armadilha são tratados como dois blocos de contêineres únicos.
• Os slots inferiores de um suporte de poções são numerados de 0 a 2 da esquerda para a direita, o slot superior é 3 e o slot de combustível é 4.
• Os slots de uma fornalha são numerados 0 para o slot de entrada, 1 para o slot de combustível e 2 para o slot de saída.

Outros blocos que contêm itens, mas não têm GUIs de inventário(vasos e jukeboxes) só pode ser alterado com /data.

Para entidades, deve ser um dos seguintes, onde o número do slot ou ID do slot é substituído por um número especificando o slot:

Slot	Números de slot	Restrições
armor.chest(BE: slot.armor.chest <slotId: int>)	qualquer número‌	suporte de armaduras, criaturas, e jogadores apenas (embora nem todos as criaturas mostrem ou façam uso dos itens)
armor.feet(BE: slot.armor.feet <slotId: int>)	qualquer número‌
armor.head(BE: slot.armor.head <slotId: int>)	qualquer número‌
armor.legs(BE: slot.armor.legs <slotId: int>)	qualquer número‌
weapon.mainhand(BE: slot.weapon.mainhand <slotId: int>)	qualquer número‌
weapon.offhand(BE: slot.weapon.offhand <slotId: int>)	qualquer número‌
container.<slot_number>(BE: slot.container <slotId: int>)	0–53	jogadores, molduras‌ (slot 0), e carrinho de minas apenas
enderchest.<slot_number> (BE: slot.enderchest <slotId: int>)	0–26	jogadores apenas
hotbar.<slot_number> (BE: slot.hotbar <slotId: int>)	0–8
inventory.<slot_number> (BE: slot.inventory <slotId: int>)	0–26
horse.saddle (BE: slot.saddle <slotId: int>)	qualquer número‌	cavalos, burros, e mulas apenas; <item> or itemName: Item deve ser uma sela
horse.chest‌		burros, e mulas apenas; <item> deve ser um baú
horse.armor (BE: slot.armor <slotId: int>)	qualquer número‌	cavalos e lhamas apenas; <item> ou itemName: Item deve ser um tipo de armadura para cavalo (se for um cavalo) ou um tapete (se for uma lhama)
horse.<slot_number> (BE: slot.chest <slotId: int>)	0–14	burros e mulas com apenas baús
villager.<slot_number> (BE: slot.inventory <slotId: int>)	0–7	aldeão apenas

EJ: <item>: item_stack
EB: itemName: Item: [[Tipos de argumento#Comando#<item>|Comando#<item>]]

Especifica o item a ser colocado no bloco ou slot de estoque da entidade.

EJ: <count>: integer
EB: amount: int: int

Deve ser um Número inteiro de 32 bits (de -2147483648 (-2³¹) a 2147483647 (2³¹-1) ). deve estar entre -2147483648 e 2147483647 (inclusive). E deve estar entre 1 e 64 (inclusive).

Especifica o número de itens a serem colocados no bloco ou slot de estoque da entidade.

EB: data: int: int

Deve ser um Número inteiro de 32 bits (de -2147483648 (-2³¹) a 2147483647 (2³¹-1) ). Deve estar entre -2147483648 e 2147483647 (inclusive).

Especifica os dados do item para o(s) item(ns) a serem colocados no bloco ou slot de estoque da entidade. Os valores que são inválidos para o id do item especificado serão padronizados como 0. Se não for especificado, o padrão será 0.

EB: components: json: Json::Value

Deve ser um objeto JSON .

Especifica o componentes do item. Como tags de dados, mas suporta apenas minecraft:can_place_on, minecraft:can_destroy, minecraft:item_lock, e minecraft:keep_on_death funções (veja Comandos/give#Exemplos)

EB: oldItemHandling: ReplaceMode

Deve ser um dos seguintes:

destroy - Substitui diretamente os itens, ignorando os itens originais no slot especificado.

keep - Não substitui itens se um item ocupar esse slot.

Resultado

Comando	Circunstância	Edição Java	Edição Bedrock
Qualquer	os argumentos não são especificados corretamente	Não analisável	Falha
	<count> excede o limite de pilha do item especificado	Falha	Bem-sucedido
/replaceitem block ...	se o bloco especificado não for um contêiner		Falha
	se o bloco especificado não tiver o slot especificado
/replaceitem entity ...	se <targets> ou target: target falha em resolver para uma ou mais entidades (jogadores nomeados devem estar online)
	se nenhum dos alvos tiver o slot especificado (por exemplo, zumbis não têm horse.armor)
	se o item especificado não puder ser colocado no slot especificado de qualquer entidade alvo (por exemplo, coloque uma pedra na armadura. peito de um jogador)
/replaceitem ... keep	se um item ocupa o slot especificado no modo de manutenção	N/A
Qualquer	De outra forma	Substituir os itens no slot especificado pelos itens especificados (os itens anteriores nesse slot são perdidos).

Conclusão

Comando	Edição	Situação	Contagem de sucesso	/execute store succeess ...	/execute store result ...
qualquer	Edição Java	em falha	0	0	0
/replaceitem block ...		No sucesso	1	1	1
/replaceitem entity ...		No sucesso	1	1	o número de entidades cujos itens foram substituídos com sucesso
qualquer	Edição Bedrock	Em falha	0	N/A	N/A
/replaceitem block ...		No sucesso	1	N/A	N/A
/replaceitem entity ...		No sucesso	o número de entidades cujos itens foram substituídos com sucesso	N/A	N/A

Exemplos

• Para substituir os itens na fenda inferior direita de um único baú, dois blocos acima, por quatro mudas de abeto:
  • replaceitem block ~ ~2 ~ container.26 minecraft:spruce_sapling 4‌
  • replaceitem block ~ ~2 ~ slot.container 26 sapling 4 1‌
• Para substituir os itens no slot de hotbar mais à direita do jogador mais próximo com quatro mudas de abeto:
  • replaceitem entity @p hotbar.8 minecraft:spruce_sapling 4‌
  • replaceitem entity @p slot.hotbar 8 sapling 4 1‌

Histórico

[ocultar]Edição Java
1.8			14w26a				Adicionado /replaceitem.
1.14			18w43a				/replaceitem agora pode ser usado na molduras.
1.17			20w46a				Removido /replaceitem. Foi substituído por /item replace.
[ocultar]Edição Pocket
1.0.5			alpha 1.0.5.0				Adicionado /replaceitem.
1.1.0			alpha 1.1.0.0				CanPlaceOn e CanDestroyfunções agora são suportadas para /replaceitem.
[ocultar]Edição Bedrock
1.16.0			beta 1.16.0.55				Adicionada nova sobrecarga para /replaceitem com uma opção de destruir ou manter.

Veja também

• /blockdata — também pode substituir itens em um contêiner
• /entitydata — também pode substituir itens no inventário de uma criatura ou modificar as chances de queda de armaduras e armas
• /give — dê itens aos jogadores sem especificar slots de inventário específicos ou sobrescrever outros itens