Cargos por reação

Visão geral

Monte menus de cargos flexíveis sem comandos slash. O Petto aceita reações clássicas com emoji e botões clicáveis, com comportamento independente de alternar, só dar ou só remover para cada cargo vinculado. Use para que os membros escolham as próprias cores, avisos ou interesses, ou para dar o cargo de membro quando alguém aceita as regras. O mais rápido é o criador do dashboard; os comandos também funcionam em qualquer mensagem.

Comandos

!reactionrole add <message_id> <emoji> <role> [channel] [mode] [type] [label]
!reactionrole remove <message_id> <emoji> [channel]
!reactionrole list <message_id> [channel]
!reactionrole clear <message_id> [channel]

!reactionrole add 123456789012345678 🎮 @Gamer #general toggle
!reactionrole list 123456789012345678
!reactionrole add 123456789012345678 :joystick: @Gamer #general toggle button Gamer

!reactionrole add (reação)

kira vincula 🎮 em uma mensagem do canal de cargos ao cargo Eventos e Petto confirma no modo toggle — No Discord: um emoji de uma mensagem vinculado a um cargo.

!reactionrole add (botão)

liam adiciona um botão 🏆 para Caçadores de missões ao menu de cores e Petto confirma o cargo do botão — No Discord: um botão adicionado ao menu de cores.

!reactionrole remove

liam remove o vínculo 🎉 do menu de cores, Petto confirma, e o mesmo comando de novo diz que esse emoji não estava vinculado — No Discord: um vínculo removido, e a resposta quando o emoji não está mais vinculado.

!reactionrole list

chu lista o menu de cores e Petto responde com os cinco cargos por botão e o modo — No Discord: os cargos de uma mensagem, listados com !rr.

!reactionrole clear

liam limpa a mensagem de avisos e Petto diz que removeu três vínculos — No Discord: todos os vínculos de uma mensagem removidos de uma vez.

Quando não funciona

Petto recusa 🔴 porque já está vinculado, diz que não encontra uma mensagem e avisa nova da permissão manage_roles que falta — No Discord: um emoji já vinculado, uma mensagem que não é encontrada e um membro sem Gerenciar cargos.

Se você não informar channel, é usado o canal atual. emoji aceita tanto emojis personalizados quanto os padrão. type é reaction por padrão. Use button para transformar a mensagem em um menu de cargos clicável; uma mensagem pode ter até 25 botões do Petto em cinco fileiras. label é o texto do botão e, por padrão, é o nome do cargo. O modo de botão não pode ser adicionado a uma mensagem que já tem outro painel de componentes, como um painel de tickets ou do VoiceMaster. Nome curto: !rr. !reactionroleconfig mostra todos os cargos por reação e por botão do servidor e os comandos para mudá-los.

Petto lista os nove cargos vinculados do Petto Land com canal, emoji, cargo e modo, e depois os comandos do reactionrole — No Discord: o cartão do !reactionroleconfig com os cargos do Petto Land e os comandos.

Criador no dashboard

O jeito mais rápido de fazer um menu de cargos é o criador do dashboard: Automação → Cargos por reação → Criar um menu de cargos.

Escolha o canal e escreva a mensagem

Escolha onde a mensagem será publicada e depois adicione texto e um embed (título, descrição, cor, rodapé, miniatura e imagem). Dá para carregar um embed salvo no gerador de embeds como ponto de partida, e um link abre o gerador.

O criador com #cargos escolhido e o painel Mensagem: um embed salvo para começar, o conteúdo e o embed com título, descrição e cor — Dashboard → Automação → Cargos por reação → Criar reaction role: o canal e a mensagem, com o embed do menu de cores.

Adicione fileiras de botões

Cada fileira tem até 5 botões e uma mensagem tem até 5 fileiras (25 botões). Para cada botão, escolha um nome (ou Vazio para mostrar só o emoji), uma cor (Azul, Cinza, Verde ou Vermelho), o cargo, o comportamento (alternar, só dar ou só remover) e um emoji opcional.

A fileira 1 do criador com os botões Vermelho, Azul e Verde, a cor, o cargo, o comportamento alternar e o emoji, e as ferramentas para mover, copiar e remover — Dashboard → Automação → Cargos por reação → Criar reaction role: as fileiras de botões, cada um com nome, cor, cargo, comportamento e emoji.

Escolha os emojis

O seletor de emojis tem uma aba Servidor com os seus emojis personalizados e uma aba Unicode, ambas com busca.

A janela Escolher emoji com as abas Servidor e Unicode, a busca e a grade de emojis — Dashboard → Automação → Cargos por reação → Criar reaction role: o seletor de emojis na aba Unicode.

Salve

A barra de alterações não salvas aparece enquanto você edita. Ao salvar, a mensagem é publicada, ou editada se você abriu um menu que já existia.

A prévia do menu de cores com os cinco botões, o botão Criar reaction role e a barra Você tem alterações não salvas — Dashboard → Automação → Cargos por reação → Criar reaction role: a prévia da mensagem, o botão que a publica e a barra de alterações não salvas.

O menu Escolha sua cor no canal de cargos com os botões Vermelho, Azul, Verde, Roxo e Eventos — No Discord: um menu de cargos com um embed e duas fileiras de botões, como o criador publica.

Os botões podem ser movidos para a esquerda ou para a direita e duplicados (a cópia fica sem emoji até você escolher um, porque cada botão de uma mensagem precisa de um emoji diferente), e as fileiras podem subir ou descer. Para mudar um menu depois, abra-o na lista de Cargos por reação com Editar a mensagem no criador.

A lista Cargos por reação do Petto Land com nove vínculos, o botão Vermelho aberto para editar e o formulário para adicionar um — Dashboard → Automação → Cargos por reação: os cargos vinculados do servidor, um aberto com Editar a mensagem no criador.

O criador funciona com embeds clássicos. Mensagens com Components V2 não podem ter botões de cargos.

O mesmo seletor de emojis é usado em Reações a mensagens, Gatilhos de reação, Starboard, Tickets, Botões com resposta e Parceiros.

Botões por comando

!reactionrole add também aceita embed (com message_id igual a new, publica uma mensagem a partir de um embed salvo), style (cor do botão) e row (de 1 a 5), para que os menus feitos por comando possam usar o mesmo layout.

Exemplos

Cargos de cor com botões
Cargos de notificação com reações
Aceitar as regras

Crie a mensagem do menu

Command

!embed create color-roles {embed}$v{title: 🎨 Escolha sua cor}$v{description: Clique em um botão para pegar uma cor, clique de novo para tirá-la.}$v{color: #f0a88f}

liam cria color-roles a partir de um código e Petto mostra o embed Escolha sua cor — No Discord: o embed salvo do menu, feito com !embed create.

Publique com o primeiro botão

Command

!reactionrole add new 🔴 @Vermelho #cargos --embed color-roles --label Vermelho --style 4

new publica o embed salvo em #cargos e coloca o botão nele. Copie o ID dessa mensagem para os próximos botões.

Petto publica Escolha sua cor com um botão vermelho Vermelho e responde com o link da mensagem — No Discord: o embed publicado em #cargos com o botão Vermelho.

Adicione os outros botões

Command

!reactionrole add 123456789012345678 🔵 @Azul #cargos --type button --label Azul --style 1

O menu agora tem os botões Vermelho e Azul, depois que liam adiciona o azul com --style 1 — No Discord: a mesma mensagem com o segundo botão, Azul.

style é a cor do botão: 1 azul (blurple), 2 cinza, 3 verde, 4 vermelho.

Commands

!reactionrole add 123456789012345678 📢 @Anúncios #cargos
!reactionrole add 123456789012345678 🎉 @Eventos #cargos
!reactionrole add 123456789012345678 🎁 @Sorteios #cargos

Os membros reagem para receber o cargo e tiram a reação para perdê-lo.

Uma mensagem em #cargos que explica os avisos, com as reações 📢, 🎉 e 🎁 e quantos membros escolheram cada uma — No Discord: a mensagem de avisos com as três reações que os membros usam.

Command

!reactionrole add 123456789012345678 ✅ @Membro #regras add

O modo add só dá o cargo: tirar a reação não remove o cargo, então os membros não perdem o acesso sem querer.

liam vincula ✅ na mensagem das regras ao cargo Membros no modo add e Petto confirma — No Discord: ✅ na mensagem das regras, no modo add.

Um embed salvo publicado com new pode usar variáveis, preenchidas para quem usa o comando, então as do servidor, como {server_name} ou {server_membercount}, são as que fazem mais sentido ali.

Modos

Alternar (padrão)

Reagir dá o cargo, reagir de novo tira o cargo.

O menu de cores e as duas respostas privadas do Petto, Vermelho adicionado e Vermelho removido — No Discord: nova aperta Vermelho duas vezes: ganha o cargo e depois perde. Só nova vê as respostas.

Só dar

Reagir dá o cargo, tirar a reação não faz nada.

Mia aperta Eventos, Petto diz que deu o cargo, e na segunda vez diz que ela já o tem — No Discord: Eventos no modo só dar: o segundo clique não tira o cargo.

Só remover

Reagir tira o cargo, útil junto com um cargo que os membros já recebem ao entrar.

tommy aperta o botão vermelho Sem avisos de eventos, Petto tira Eventos, e na segunda vez diz que ele não o tem — No Discord: um botão Sem avisos de eventos no modo só remover: só tira o cargo.

Os botões seguem os mesmos modos e Petto responde ao membro em privado (só ele vê). Com reações Petto não diz nada: o cargo simplesmente muda.

Início

Guias

Conceitos

Moderação

Automação

Comunidade

Roleplay

Diversos

Boas-vindas

Configuração

Recursos

Problemas comuns

Novidades

Cargos por reação

Visão geral

Comandos

Criador no dashboard

Botões por comando

Exemplos

Modos

​Visão geral

​Comandos

​Criador no dashboard

​Botões por comando

​Exemplos

​Modos

Visão geral

Comandos

Criador no dashboard

Botões por comando

Exemplos

Modos