As entidades-exibição são entidades úteis para que os criadores de mapas ou pacotes de dados possam exibir várias coisas. Existem 3 entidades-exibição: Entidade-bloco, Entidade-item e Entidade-texto, que são usadas para exibir blocos, itens e textos, respectivamente. Elas só podem ser geradas com o comando /summon
ou /execute summon
.
Comportamento[]
Assim como os marcadores, as entidades-exibição não se movem, não recebem dano, não produzem sons e não têm colisão. Elas não obstruem o posicionamento de blocos e nem empurram os jogadores ou outras entidades de sua própria posição. Diferentemente de marcadores, as entidades-exibição são enviadas ao cliente para renderização e são contadas no valor E
(número total de entidades) mostrado na tela de depuração.
As entidades-exibição não têm caixa de colisão. Ao usar a combinação de teclas de depuração F3 + B, que normalmente mostra as caixas de colisão de todas as entidades visíveis, uma caixa de colisão não é mostrada para as entidades-exibição. Usar F3 + I enquanto olha para uma entidade-exibição não copia os dados da entidade para a área de transferência.
As entidades-exibição geradas com comando sem especificar dados NBT não são visíveis. No caso da entidade-bloco e da entidade-item, o conteúdo exibido por padrão é minecraft:air
.
Uso[]
As entidades-exibição podem ser geradas apenas por comandos. Para exibição de bloco e exibição de item, o conteúdo de exibição padrão é minecraft:air
, portanto, eles gerados com o comando sem especificar dados NBT não são visíveis. Para exibição de texto, o conteúdo padrão é {"text":'""'
}. Ao modificar seus dados de entidade, sendo possível e editar seu conteúdo de exibição e outros efeitos visuais e girar, dimensionar ou converter o modelo.
Usar a entidade-item com custom_model_data
é possível exibir qualquer modelo customizado.
Para a entidade-item, além de modificar diretamente o NBT, o item exibido também pode interagir com o /loot
e /item
no slot container.0
.
Interpolação[]
Alguns efeitos visuais dessas entidades podem ser interpolados ao longo do jogo para exibir a animação de gradiente.
Todos os campos marcados como "É interpolado" em #Dados de entidade abaixo podem ser interpolados. Essas propriedades não se interpolam independentemente umas das outras.
Qualquer alteração em qualquer uma dessas propriedades faz com que o cliente registre os valores anteriores e alterados dessas propriedades. Como o servidor sincroniza as entidades com o cliente no máximo uma vez por tick do jogo, várias alterações dentro de um tick do jogo ainda contam como uma única alteração.
A entidade será renderizada interpolada ao longo do tempo entre os valores anteriores e os valores atuais. O tempo de jogo para iniciar a interpolação (entidade totalmente no estado anterior) é interpolation_start
(tempo do jogo, em ticks de jogo). Tentar definir um valor menor que 0 irá defini-lo para o tempo de jogo atual. O tempo de jogo quando a interpolação termina (entidade totalmente no estado atual) é interpolation_start + interpolation_duration
(tempo do jogo, em ticks de jogo).
Valores de dados[]
ID[]
Entidade | ID de espaço de nome | Chave de tradução |
---|---|---|
Entidade-bloco | block_display | entity.minecraft.block_display |
Entidade-item | item_display | entity.minecraft.item_display |
Entidade-texto | text_display | entity.minecraft.text_display |
Dados de entidade[]
As entidades-exibição possuem dados de entidade associados a elas que contêm várias propriedades da entidade.
Entidade-item:
- root tag
- Tags comuns a todas as entidades Veja Template:Nbt inherit/entity/template
- Predefinição:Nbt inherit/display entity
- item: O item a ser exibido.
- Tags comuns a todos os itens Veja Predefinição:Nbt inherit/itemnoslot/template
- item_display: O modelo a ser exibido. Descreve a transformação de modelo aplicada ao item (como definida no campo
display
no JSON do modelo. Pode sernone
,thirdperson_lefthand
,thirdperson_righthand
,firstperson_lefthand
,firstperson_righthand
,head
,gui
,ground
efixed
. O padrão éfixed
.
Entidade-bloco:
- root tag
- Tags comuns a todas as entidades Veja Template:Nbt inherit/entity/template
- Predefinição:Nbt inherit/display entity
- block_state: O estado de bloco a ser exibido.
- Predefinição:Nbt inherit/block state
Entidade-texto:
- root tag
- Tags comuns a todas as entidades Veja Template:Nbt inherit/entity/template
- Predefinição:Nbt inherit/display entity
- alignment: Direção de alinhamento do texto. Pode ser
center
,left
eright
. O padrão écenter
. - background: A cor do fundo, determinada em ARGB. Já que os pixels com canal alfa inferior a 0,1 são descartados ao serem renderizados com o shader padrão, o fundo torna-se totalmente transparente quando A é inferior a 26 (0x1A). O valor padrão é 1073741824 (0x40000000). É interpolada.
- default_background: Se for verdadeiro, a renderização utilizará a cor de fundo do texto padrão (mesma que a do chat), o que substitui background. O padrão é
false
. - line_width: Largura máxima de linha usada para dividir linhas (nota: uma nova linha também pode ser adicionada com caracteres {cd|\n}}). O padrão é 200.
- see_through: Se o texto será visível através de blocos. O padrão é
false
. - shadow: Se o texto será exibido com sombra. O padrão é
false
. - text: O texto a ser exibido no formato de texto JSON bruto, que será resolvido com o contexto da entidade de exibição.
- text_opacity: O valor alfo do texto renderizado. O valor alfa vai de 0 a 256. Como não há bytes não assinados no NBT, valores maiores do que 127 precisam ser substituidos por
alpha-256
. Portanto, o valor vai de -128 a 127. Assim como o fundo, a renderização do texto é descartada quando é inferior a 26. O valor padrão é -1, o que representa 255 e é completamente opaco. É interpolada.
Histórico[]
Edição Java | |||||
---|---|---|---|---|---|
1.19.4 | 23w06a | A entidade-bloco, a entidade-item e a entidade-texto foi adicionada. |