Referência de comandos
Componentes de item
Itens em comandos são escritos como um id seguido de componentes entre colchetes. Os componentes guardam tudo o que há de especial em um item, como nome, encantamentos e durabilidade.
Detalhes
| Sintaxe de item | id[component=value,component=value]. A parte minecraft: dos IDs e dos nomes de componentes pode ser omitida. |
| Remover um componente | Um ! antes do nome sem valor remove o componente, por exemplo minecraft:diamond_sword[!attribute_modifiers]. |
| Repetição | Cada componente só pode aparecer uma vez por item. |
| Valores | Escrito no formato de dados: números, texto entre aspas, listas entre [ ] e valores nomeados entre { }. |
| Tipos de componentes | 119 que podem ser usados em comandos. |
| Testes de item | Usado por /clear e /execute if items. Comece com um id de item, uma marcação de item com # ou * para qualquer item, depois testes opcionais entre [ ]. |
| Combinação de testes | Uma vírgula significa que os dois testes precisam passar, | significa que qualquer um pode passar, e ! antes de um teste o inverte. |
| Teste exato | component=value passa quando o item tem exatamente esse valor. |
| Teste parcial | name~value verifica uma parte de um componente. Disponível para attribute_modifiers, bundle_contents, container, custom_data, damage, enchantments, firework_explosion, fireworks, jukebox_playable, potion_contents, stored_enchantments, trim, villager/variant, writable_book_content e written_book_content. |
| Teste de quantidade | count=5 para um tamanho de pilha exato, ou count~{min:..,max:..} para um intervalo. |
| Onde os dados entre chaves ainda valem | Dados de entidade e de bloco: /summon, /data, o argumento de seletor nbt e os dados de bloco após um id de bloco. |
Componentes comuns
| enchantments | Encantamentos do item com seus níveis | /give @s minecraft:diamond_sword[enchantments={sharpness:5,unbreaking:3}] |
| stored_enchantments | Encantamentos de um livro encantado | /give @s minecraft:enchanted_book[stored_enchantments={mending:1}] |
| custom_name | Nome mostrado para o item, como componente de texto | /give @s minecraft:stick[custom_name={text:"Magic Wand",color:"gold",italic:false}] |
| item_name | Nome base do item, como componente de texto | /give @s minecraft:stick[item_name="Wand"] |
| lore | Linhas extras da dica, uma lista de componentes de texto | /give @s minecraft:stick[lore=["First line",{text:"Second line",color:"gray"}]] |
| damage | Durabilidade já gasta | /give @s minecraft:diamond_pickaxe[damage=100] |
| max_damage | Durabilidade total | /give @s minecraft:diamond_pickaxe[max_damage=5000] |
| unbreakable | O item nunca perde durabilidade | /give @s minecraft:diamond_pickaxe[unbreakable={}] |
| max_stack_size | Maior pilha, de 1 a 99 | /give @s minecraft:ender_pearl[max_stack_size=64] |
| attribute_modifiers | Alterações de atributos enquanto o item está em um espaço | /give @s minecraft:stick[attribute_modifiers=[{type:"minecraft:attack_damage",amount:10,id:"example:bonus",operation:"add_value",slot:"mainhand"}]] |
| potion_contents | Tipo, cor e efeitos personalizados: Poção | /give @s minecraft:potion[potion_contents={custom_color:16711680,custom_effects:[{id:"minecraft:speed",amplifier:1,duration:600}]}] |
| dyed_color | Cor do corante como um número ou como [red,green,blue] de 0 a 1 | /give @s minecraft:leather_chestplate[dyed_color=16711680] |
| fireworks | Tempo de voo e explosões de um foguete | /give @s minecraft:firework_rocket[fireworks={flight_duration:2,explosions:[{shape:"large_ball",colors:[I;16711680],fade_colors:[I;255],has_trail:true,has_twinkle:true}]}] |
| firework_explosion | Explosão de uma estrela de fogos de artifício | /give @s minecraft:firework_star[firework_explosion={shape:"star",colors:[I;65280]}] |
| written_book_content | Título, autor e páginas de um livro escrito | /give @s minecraft:written_book[written_book_content={title:"Guide",author:"Steve",pages:["Page one",{text:"Page two",bold:true}]}] |
| writable_book_content | Páginas de um livro e pena | /give @s minecraft:writable_book[writable_book_content={pages:["Notes"]}] |
| food | Fome e saturação restauradas ao comer | /give @s minecraft:stick[food={nutrition:4,saturation:2.4,can_always_eat:true},consumable={}] |
| consumable | Torna o item utilizável ao comer ou beber | /give @s minecraft:stick[consumable={consume_seconds:0.8,animation:"eat"}] |
| tooltip_display | Oculta a dica de ferramenta ou componentes individuais dela | /give @s minecraft:diamond_sword[enchantments={sharpness:5},tooltip_display={hidden_components:["minecraft:enchantments"]}] |
| enchantment_glint_override | Força o brilho de encantamento ligado ou desligado | /give @s minecraft:stick[enchantment_glint_override=true] |
| rarity | Classe de cor do nome: common, uncommon, rare ou epic | /give @s minecraft:stick[rarity="epic"] |
| custom_data | Dados livres para pacotes de dados | /give @s minecraft:stick[custom_data={quest_item:1b}] |
| custom_model_data | Valores que os pacotes de recursos usam para escolher um modelo | /give @s minecraft:stick[custom_model_data={floats:[1.0f],strings:["wand"]}] |
| item_model | Modelo usado para desenhar o item | /give @s minecraft:stick[item_model="minecraft:blaze_rod"] |
| can_break | Blocos que o item pode quebrar no modo Aventura | /give @s minecraft:diamond_pickaxe[can_break={blocks:"#minecraft:logs"}] |
| can_place_on | Blocos nos quais o item pode ser colocado no modo Aventura | /give @s minecraft:stone[can_place_on={blocks:"minecraft:grass_block"}] |
| container | Itens guardados dentro de um item contêiner | /give @s minecraft:chest[container=[{slot:0,item:{id:"minecraft:diamond",count:3}}]] |
| bundle_contents | Itens dentro de um pacote | /give @s minecraft:bundle[bundle_contents=[{id:"minecraft:arrow",count:16}]] |
| profile | Skin exibida por uma cabeça de jogador: Jogador | /give @s minecraft:player_head[profile={name:"Notch"}] |
| trim | Material e padrão: Armadura | /give @s minecraft:iron_chestplate[trim={material:"minecraft:gold",pattern:"minecraft:coast"}] |
| equippable | Permite vestir o item em um espaço | /give @s minecraft:stick[equippable={slot:"head"}] |
| use_cooldown | Tempo de espera em segundos após o uso | /give @s minecraft:ender_pearl[use_cooldown={seconds:5}] |
| repair_cost | Custo extra da bigorna em níveis | /give @s minecraft:diamond_sword[repair_cost=10] |
| block_entity_data | Dados de bloco aplicados quando o bloco é colocado | /give @s minecraft:spawner[block_entity_data={id:"minecraft:mob_spawner",Delay:20s}] |
| entity_data | Dados de entidade aplicados quando o item cria uma entidade | /give @s minecraft:armor_stand[entity_data={id:"minecraft:armor_stand",Small:1b}] |
Testes de item
| id | Esse item | /clear @s minecraft:diamond |
| #tag | Qualquer item da tag | /clear @s #minecraft:planks |
| * | Qualquer item | /clear @s * |
| [component] | Itens que têm o componente | /clear @s *[damage] |
| [!component] | Itens que não têm o componente | /clear @s *[!damage] |
| [component=value] | Itens cujo componente é exatamente o valor | /clear @s minecraft:diamond_sword[damage=0] |
| [name~value] | Itens que passam em um teste parcial | /clear @s *[enchantments~[{enchantments:"minecraft:sharpness",levels:{min:3}}]] |
| [count=n] | Pilhas exatamente desse tamanho | /clear @s minecraft:stick[count=5] |
| [count~{min:n}] | Pilhas em uma faixa de tamanho | /clear @s *[count~{min:32}] |
| [a|b] | Itens que passam em um dos dois testes | /clear @s *[damage|unbreakable] |
| [a,b] | Itens que passam nos dois testes | /clear @s #minecraft:swords[enchantments~[{}],!custom_name] |
Tipos de valores de dados
| Byte | Número inteiro com b | 1b |
| Curto | Número inteiro com s | 20s |
| Inteiro | Número inteiro, ou com i | 5 |
| Long | Número inteiro com L | 4L |
| Float | Número com f | 5.5f |
| Duplo | Número com ponto decimal, ou com d | 6.5d |
| Verdadeiro ou falso | true ou false, armazenado como 1b ou 0b | true |
| Texto | Entre aspas duplas ou simples. Palavras simples não precisam de aspas | "Steve" |
| Lista | Valores entre [ ] separados por vírgulas | [1,2,3] |
| Valores nomeados | pares key:value em { } | {id:"minecraft:diamond",count:3} |
| Lista de bytes | [B; ...] | [B;1b,2b] |
| Lista de inteiros | [I; ...] | [I;1,2] |
| Lista de long | [L; ...] | [L;1L,2L] |
| Número hexadecimal ou binário | 0x ou 0b na frente | 0x1F |
| Sem assinatura ou assinado | u ou s antes da letra do tipo | 255ub |
| Agrupamento de dígitos | Sublinhados entre dígitos | 1_000 |
| bool(...) | Transforma um número em verdadeiro ou falso | bool(1) |
| uuid(...) | Transforma um texto UUID na sua forma armazenada | uuid("dd12be42-52a9-4a91-a8a1-11c01849e498") |
Onde os dados entre chaves são usados
| Dados de entidade ao invocar | /summon minecraft:pig ~ ~ ~ {NoAI:1b} |
| Alterar dados de entidade | /data merge entity @n[type=minecraft:zombie] {NoAI:1b,CustomName:"Bob"} |
| Leitura com um caminho de dados | /data get entity @s Inventory[{id:"minecraft:diamond"}].count |
| Componente dentro de um caminho de dados | /data get entity @s SelectedItem.components."minecraft:damage" |
| Dados de bloco | /data get block ~ ~ ~ Items[0] |
| Armazenamento de comandos | /data modify storage my_pack:data name set value "Steve" |
| Filtro do seletor | /kill @e[type=minecraft:zombie,nbt={NoAI:1b}] |
Exemplos
/give @s minecraft:diamond_sword[custom_name={text:"Excalibur",color:"gold",italic:false},enchantments={sharpness:5},unbreakable={}]Dá uma espada inquebrável com Afiação V e nome dourado.
/give @s minecraft:diamond_sword[!attribute_modifiers]Dá uma espada de diamante sem seus bônus de dano de ataque e velocidade.
/give @s minecraft:potion[potion_contents={potion:"minecraft:strong_healing"}]Dá: Poção de Cura II.
/item replace entity @s weapon.mainhand with minecraft:diamond_sword[enchantments={sharpness:5}]Coloca na sua mão principal uma espada de diamante com Afiação V.
/clear @s *[damage~{durability:{max:10}}]Remove todos os itens com 10 ou menos de durabilidade restante.
/execute if items entity @s weapon.mainhand minecraft:diamond_sword run say yesDiz yes se você segurar uma espada de diamante.
/execute if items entity @s container.* *[custom_data~{key:1b}] run say yesDiz yes se algum espaço do inventário contiver um item cujos dados personalizados tenham key definido como 1b.
/data merge storage my_pack:data {a:1,b:2b,c:3s,d:4L,e:5.5f,f:6.5d,g:"text",h:[1,2,3],i:[B;1b,2b],j:[I;1,2],k:[L;1L,2L],l:{m:true}}Armazena um valor de cada tipo de dado.