As mensagens clássicas de bot são um embed com uma fileira de botões colada embaixo. Os Componentes V2 do Discord colocam o texto, as imagens, os botões e os menus suspensos dentro de um único contêiner, então um painel de tickets, um cartão de jogador ou uma listagem de produto é lido como um único card, em vez de uma caixa com controles presos a ela. A Noxyr oferece suporte a ambos, permite escolher para cada recurso e republica os painéis ao vivo quando você troca, para que nada quebre.
O que são os Componentes V2 de verdade
Os Componentes V2 são o sistema de layout de mensagens mais novo do Discord. Em vez da divisão antiga entre "o embed" (texto, cor, imagens) e "os componentes" (botões e menus de seleção em fileiras abaixo dele), uma mensagem V2 é montada a partir de blocos de layout: um contêiner com cor de destaque, blocos de texto, seções que combinam texto com um botão ou uma miniatura, separadores, galerias de mídia e os botões e menus suspensos de sempre, todos aninhados dentro. O resultado fica mais compacto, especialmente no celular, e os controles ficam ao lado do que eles afetam.
O detalhe é que uma única mensagem não pode misturar os dois sistemas: uma mensagem com componentes V2 não pode também carregar um embed clássico. É por isso que os bots precisam escolher por mensagem, e por que a Noxyr registra a escolha por recurso.
V1: o embed clássico
- Familiar para todo usuário do Discord desde 2016; ninguém precisa aprender um formato novo.
- Funciona em toda parte, inclusive em clientes antigos e pontes.
- Os botões e menus ficam abaixo do embed, em até cinco fileiras.
- Títulos, campos e rodapés oferecem muita estrutura sem esforço.
V2: o layout em contêiner
- Os botões e menus suspensos ficam dentro do card, ao lado do texto a que se referem.
- Mais limpo no celular; menos espaço vertical entre a mensagem e os seus controles.
- Separadores e seções tornam painéis longos (uma página de catálogo, um menu de ajuda) mais fáceis de percorrer.
- Algumas coisas mudam: a grade clássica de título e campos é substituída por blocos de texto e seções.
Como a Noxyr lida com isso
Cada servidor tem um estilo padrão para botões e um padrão separado para menus suspensos, além de substituições opcionais por recurso: tickets, catálogo e checkout, verificação, avaliações, sugestões, enquetes, o player de música, mensagens de boas-vindas e de saída, comandos de ajuda e públicos, e mensagens diretas. Servidores que já existiam antes do lançamento do V2 continuam no V1 até que um admin altere isso; servidores que adicionam a Noxyr agora começam no V2. Os sorteios sempre usam o layout clássico, pois o formato da mensagem depende dele.
A troca é feita com um comando ou com uma página do painel (Botões & Menus, em Controle):
/style view: o que cada recurso está usando atualmente./style set feature:all buttons:v2 dropdowns:v2: padrão para o servidor inteiro./style set feature:tickets buttons:v1: apenas um recurso./style reset: remove as substituições para que os recursos sigam novamente o padrão do servidor.
Por padrão, uma mudança republica os seus painéis ao vivo, os painéis de tickets, o catálogo, a verificação e o restante, para que os membros vejam o novo layout imediatamente, e não só na próxima edição. Use repost:false se preferir que os painéis mudem na próxima vez que forem salvos.
Qual você deve escolher?
- Painéis voltados ao público (tickets, verificação, catálogo): V2. Os membros interagem mais com eles, e os botões dentro do card são mais fáceis de acertar no celular.
- Player de música: V2. Os controles pertencem ao card.
- Mensagens de boas-vindas e de saída: tanto faz; use V1 se você depende de uma imagem de banner grande com uma grade de campos embaixo.
- Qualquer coisa de que um leitor de tela ou um cliente antigo dependa: V1 é a escolha mais segura.
Como a escolha é por recurso, você pode mudar um painel de cada vez e perguntar aos membros o que acham antes de trocar o padrão do servidor.
Perguntas frequentes
Perco alguma coisa ao trocar? Nenhuma configuração muda; só o layout das mensagens publicadas. Para voltar, use o mesmo comando.
O meu bot personalizado segue a mesma configuração? Sim. O estilo fica armazenado no servidor, então o seu bot personalizado e a Noxyr publicam o mesmo layout ali.
Por que uma mensagem com menu suspenso usa um estilo diferente de uma mensagem com botões? Uma mensagem não pode misturar sistemas: então, uma mensagem com menu suspenso segue a configuração do menu, e uma mensagem só com botões segue a configuração dos botões.
Experimente: abra o painel, vá em Botões & Menus e troque o seu painel de tickets para V2. O guia de botões vs menu suspenso explica o que vai no próprio painel.