Comandos/item

Para Edição Bedrock equivalente, consulte Comandos/replaceitem.

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

Manipular ou copiar itens nos inventários de blocos (baús, fornalhas, etc.) ou entidades (jogadores ou criaturas).

Sintaxe

item modify (block <pos>|entity <targets>) <slot> <modifier>

Modifica os itens no slot especificado com o modificador especificado.

item replace (block <pos>|entity <targets>) <slot> with <item> [<count>]

Substitui os itens no slot especificado pelos itens especificados.

item replace (block <pos>|entity <targets>) <slot> from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>]

Copia os itens de origem para o slot de destino e, opcionalmente, modifica-o com o modifier.

Sintaxe exibida de várias maneiras

Árvore simplificada:
item ... ... modify <TARGET> <slot> <modifier> ... replace <TARGET> <slot> ... with <item> [<count>] ... from <SOURCE> <sourceSlot> [<modifier>] onde os argumentos substituídos são: <TARGET> = (block <pos>|entity <targets>) <SOURCE> = (block <sourcePos>|entity <sourceTarget>)

Minimizado:
/item

Maximizado:

item modify block <pos> <slot> <modifier> item modify entity <targets> <slot> <modifier> item replace block <pos> <slot> with <item> [<count>] item replace block <pos> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item replace block <pos> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item replace entity <targets> <slot> with <item> [<count>] item replace entity <targets> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item replace entity <targets> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>]

Argumentos

<pos>: block_pos

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

It deve ser um bloco de posição composto de <x>, <y> e <z>, cada um deles deve ser um número inteiro ou notação de til e circunflexo.

<targets>: entity

Especifica uma ou mais entidades a serem modificadas.

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

<slot>: item_slot

Especifica o slot de inventário a ser modificado. Os valores válidos dependem se um bloco ou uma entidade está sendo modificada.: Must be a string notation that refer to certain slots in the inventory.

<modifier>: resource_location

Especifica o modificador de item a ser aplicado no item escolhido.

Deve ser um ID de espaço de nome.

<item>: item_stack

Especifica o item a ser colocado no bloco ou slot de inventário da entidade.

It must be a item argument (does not accept item tags).

<count>: integer

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

Deve ser um número inteiro de 32 bits. And it must be between 1 and 64 (inclusive).

<sourcePos>: block_pos

Especifica a posição do bloco para copiar os itens.

It deve ser um bloco de posição composto de <x>, <y> e <z>, cada um deles deve ser um número inteiro ou notação de til e circunflexo.

<sourceTarget>: entity

Especifica uma entidade da qual copiar itens.

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

<sourceSlot>: item_slot

Especifica o slot de inventário do qual copiar os itens. Os valores válidos dependem se a origem é um bloco ou uma entidade. Consulte o argumento <slot> acima para obter mais informações.

Resultado

Comando	Gatilho	Edição Java
qualquer	os argumentos não estão especificados corretamente	não analisável
/item modify ... /item ... from ...	o <modifier> especificado não existe	Falha
/item modify block ... /item replace block ...	<pos> está descarregado ou fora do mundo
	o bloco no <pos> não é um container
	o bloco no <pos> não tem o slot especificado
/item modify entity ... /item replace entity ...	<targets> falha ao resolver para uma ou mais entidades (o jogador nomeado deve estar online)
	Todas as entidades selecionadas atendem a uma ou mais das seguintes condições: Não possui o slot especificado (por exemplo, zumbis não possuem horse.armor) O item especificado não pode ser colocado no slot especificado (por exemplo, para colocar uma pedra no armor.chest de um jogador)
/... with <item> <count>	<count> excede o limite de pilha do item especificado
/... from block ...	<sourcePos> está descarregado ou fora do mundo
	o bloco em <sourcePos> não é um container
	o bloco em <sourcePos> não tem o slot especificado
/... from entity ...	<sourceTarget> falha ao resolver para uma única entidade (o jogador nomeado deve estar online)
	o <sourceTarget> não tem o slot especificado (por exemplo, zumbis não têm horse.armor)
qualquer	Com sucesso	Manipula itens no slot especificado.

Saída

Comando	Edição	Situação	Contagem de sucesso	/execute store succeess ...	/execute store result ...
qualquer	Edição Java	Em caso de falha	0	0	0
/item (modify|replace) block ...		Em caso de sucesso	1	1	1
/item (modify|replace) entity ...		Em caso de sucesso	1	1	o número de entidades cujos itens foram substituídos com sucesso

Exemplos

• Para substituir os itens no slot inferior direito de um único baú dois blocos acima por quatro mudas de abeto:
  • /item replace block ~ ~2 ~ container.26 with minecraft:spruce_sapling 4
• Para substituir os itens no slot da barra de atalho mais à direita do jogador mais próximo por quatro mudas de abeto:
  • /item replace entity @p hotbar.8 with minecraft:spruce_sapling 4
• Para substituir o item na mão secundária do jogador selecionado pelo item na mão principal:
  • /item replace entity @s weapon.offhand from entity @s weapon.mainhand
• Para colocar um estandarte marrom na cabeça de um jogador
  • /item replace entity @s armor.head with minecraft:brown_banner
• Para aumentar a contagem do item em sua mão principal:
  • /item modify entity @s weapon.mainhand example:increase_count
  • arquivo em um pacote de dados: data/example/item_modifiers/increase_count.json

    {
      "function": "minecraft:set_count",
      "count": 1,
      "add": true
    }
    

Histórico

Edição Java
1.17		20w46a			Adicionado /item, substituindo /replaceitem.
		21w19a			A sintaxe de /item foi alterada.

Veja também

• /data — também pode substituir itens no inventário de um container ou criatura, ou modificar as chances de drop de armaduras e armas
• /give — dê itens aos jogadores sem especificar slots de inventário específicos ou substituir outros itens
• /replaceitem — O equivalente em Edição Bedrock

Comandos

Ver em: Template:Comandos/content [editar]