Esta característica es exclusiva de Java Edition.
Para Bedrock Edition equivalente, véase Comandos/replaceitem.
item
| Nivel de permiso requerido |
2 |
|---|---|
| Restricciones |
Ninguno |
Manipula o copia objetos en los inventarios de bloques (cofres, hornos, etc.) o entidades (jugadores o criaturas).
Sintaxis[]
modificación de objeto (bloque <pos>|entidad <targets>) <ranura> <modificador>- Modifica los objetos en el espacio especificado con el modificador especificado.
reemplazar objeto (bloque <pos>|entidad <targets>) <slot> con <item> [<count>]- Reemplaza los objetos en la ranura especificada con los objetos especificados.
reemplazar objeto (bloque <pos>|entidad <targets>) <ranura> de (bloque <fuentePos>|entidad <fuenteTarget>) <fuenteSlot> [<modificador >]- Copia los objetos de origen en el espacio de target y, opcionalmente, los modifica con el
modificador.
- Copia los objetos de origen en el espacio de target y, opcionalmente, los modifica con el
Sintaxis mostrada de varias maneras
Árbol simplificado: item ...... modify <TARGET> <slot> <modifier>... replace <TARGET> <slot>... with <item> [<count>]... from <SOURCE> <sourceSlot> [<modifier>]
- Donde los argumentos sustituidos son:
<TARGET>=(block <pos>|entity <targets>)<SOURCE>=(block <sourcePos>|entity <sourceTarget>)
Minimizado: /item (modify (block <pos>|entity <targets>) <slot> <modifier>|replace (block <pos>|entity <targets>) <slot> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>]))
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 la posición del bloque a modificar.
- It must be a block position composed of <x>, <y> and <z>, each of which must be an integer or a tilde and caret notation.
<targets>: entidad
- Especifica una o más entidades para modificar.
- MC-Arg desc: Illegal parameters
<espacio>: item_slot
- Especifica el espacio de inventario que se modificará. Los valores válidos dependen de si se está modificando un bloque o una entidad.
- Must be a string notation that refer to certain slots in the inventory.
<modificador>: ubicación_recurso
- Especifica el modificador de objeto que se aplicará al objeto elegido.
- MC-Arg desc: Illegal parameters
<item>: item_stack
- Especifica el objeto que se colocará en el bloque o espacio de inventario de la entidad.
- It must be in form of
item_id{data_tags}(accepts item and block tags), in which data tags can be omitted when they are not needed.
<recuento>: entero
- Especifica la cantidad de objetos que se colocarán en el bloque o espacio de inventario de la entidad.
- Must be a 32-bit integer number. And it must be between 1 and 64 (inclusive).
<sourcePos>: block_pos
- Especifica la posición del bloque desde el que copiar objetos.
- It must be a block position composed of <x>, <y> and <z>, each of which must be an integer or a tilde and caret notation.
<sourceTarget>: entidad
- Especifica una entidad desde la que copiar objetos.
- MC-Arg desc: Illegal parameters
<sourceSlot>: item_slot
- Especifica el espacio de inventario desde el que copiar los objetos. Los valores válidos dependen de si la fuente es un bloque o una entidad. Consulte el argumento
<slot>anterior para obtener más información.
Resultado[]
| Comando | Provoca | Java Edition |
|---|---|---|
| cualquiera | los argumentos no están especificados correctamente | no analizable |
/item modificar... | el <modificador> especificado no existe | falla |
/item modificar bloque... | <pos> está descargado o fuera del mundo | |
el bloque en el <pos> no es un contenedor | ||
el bloque en el <pos> no tiene el slot especificado | ||
/item modificar entidad... | <targets> no se resuelve en una o más entidades (el jugador nombrado debe estar en línea ) | |
Todas las entidades seleccionadas cumplen una o más de las siguientes condiciones:
| ||
/... con <item> <count> | <count> excede el límite de pila del objeto especificado | |
/... from block... | <sourcePos> está descargado o fuera del mundo | |
el bloque en <sourcePos> no es un contenedor | ||
el bloque en <sourcePos> no tiene el slot especificado | ||
/... de la entidad... | <sourceTarget> no se resuelve en una sola entidad (el jugador nombrado debe estar en línea) | |
el <sourceTarget> no tiene el slot especificado (por ejemplo, los zombies no tienen horse.armor) | ||
| cualquiera | Al ejecutarse exitosamente |
Salida[]
| Comando | Edición | Situación | Contador de éxitos | /execute store success ... | /execute store result ... |
|---|---|---|---|---|---|
| cualquiera | Java Edition | En caso de fallo | 0 | 0 | 0 |
/item (modify|replace) block ... | En éxito | 1 | 1 | 1 | |
/item (modify|replace) entity ... | En éxito | 1 | 1 | the number of entities whose items are successfully replaced |
Ejemplos[]
- Para reemplazar los objetos en la ranura inferior derecha de un solo cofre dos bloques arriba con cuatro árboles jóvenes de abeto:
/objeto reemplaza bloque ~ ~2 ~ contenedor.26 con minecraft:spruce_sapling 4
- Para reemplazar los objetos en la ranura de la barra de acceso rápido más a la derecha del jugador más cercano con cuatro árboles jóvenes de abeto:
/item reemplaza la entidad @p hotbar.8 con minecraft:spruce_sapling 4
- Para reemplazar el objeto en la mano secundaria del jugador seleccionado con el objeto en su mano principal:
/item reemplaza entidad @s arma.offhand de entidad @s arma.mainhand
- Poner un estandarte marrón en la cabeza de un jugador
/item reemplaza entidad @s armour.head con minecraft:brown_banner
- Para aumentar la cantidad de objetos en tu mano principal:
/item modify entity @s weapon.mainhand example:increase_count- file in a datapack:
data/example/item_modifiers/increase_count.json{ "function": "minecraft:set_count", "count": 1, "add": true }
Historial[]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.17 | 20w46a | Se agregó /item, reemplazando /replaceitem. | |||
| 21w19a | La sintaxis de /item ha sido cambiada. | ||||
| 1.19 | Prerelease 1 | Reemplazar la ranura de la mano secundaria usando /item ya no produce una vibración.[1] | |||
| Java Edition Próximamente | |||||
| 1.20.2 | 23w31a | Ahora puede reemplazar objetos en tocadiscos. | |||
| Ahora se pueden eliminar objetos de las estanterías cinceladas. | |||||
Ver también[]
/data: también puede reemplazar objetos en el inventario de un contenedor o de un mob, o modificar las posibilidades de obtención de armaduras y armas./give: otorga objetos a los jugadores sin especificar espacios de inventario específicos ni sobrescribir otros objetos./replaceitem— El equivalente de Bedrock Edition