Components V2 do Discord: o novo layout de mensagens

Como ele difere dos embeds

No formato clássico, um bot envia o conteúdo da mensagem, até dez embeds e fileiras de botões abaixo deles. O layout é fixo: o embed é um bloco só e os botões sempre ficam pendurados embaixo.

Com o Components V2, o bot ativa uma flag na mensagem e então a descreve como uma árvore de blocos. Você pode colocar texto, uma miniatura ao lado, uma galeria de mídia, uma linha separadora e um botão, tudo dentro de um único contêiner, e estilizar o contêiner com uma cor de destaque, como a barra lateral de um embed.

Os principais blocos

• Contêiner: o cartão que agrupa outros blocos.
• Seção: texto com um botão ou miniatura ao lado.
• Exibição de texto: texto em Markdown, quantos blocos forem necessários.
• Galeria de mídia e arquivo: imagens e downloads dentro do cartão.
• Separador: espaçamento ou uma linha divisória.
• Linha de ação: botões e menus de seleção, como antes.

Compromissos que vale conhecer

Uma mensagem marcada como V2 não pode usar também os campos antigos de conteúdo e embed, então um bot escolhe um formato por mensagem. Clientes antigos do Discord que não suportam V2 não conseguem exibir essas mensagens corretamente, por isso muitos bots ainda oferecem os dois. Mensagens V2 também não podem voltar a ser clássicas, porque a flag é definida quando a mensagem é criada.

O benefício é a flexibilidade. Botões em linha, menus suspensos ao lado do texto que controlam e layouts mais limpos no celular são mais fáceis em V2.

Como o Noxyr lida com isso

O Noxyr deixa você escolher V1 ou V2 para cada recurso. V1 é o embed clássico com botões embaixo, e V2 coloca botões e menus dentro do cartão da mensagem. Servidores novos começam em V2. Você também pode transformar os controles de tickets, os votos de enquetes ou o player de música em um único menu suspenso. Encontre a opção em Botões e Menus no painel, ou use /style. As configurações estão descritas na documentação de botões e menus.

Se você tem um painel de tickets, veja como ele fica em V2 na documentação de painéis de tickets.

Vale trocar?

Se seus membros usam sobretudo apps do Discord atualizados, V2 oferece painéis mais limpos. Se você quer máxima compatibilidade, mantenha o visual clássico em mensagens importantes. O artigo V2 versus embeds clássicos tem exemplos lado a lado.