Portais de Cargos
Guia do Usuário
Publique uma mensagem com um botão: o membro que clica recebe um ou mais cargos, desde que já possua os cargos que você exigir. Ideal para liberar o acesso a uma seção reservada após uma primeira etapa.
O que ele faz
- Publica um embed personalizado acompanhado de um botão, no canal que você escolher.
- Verifica os cargos exigidos antes de conceder qualquer coisa.
- Atribui os cargos a dar com um clique, sem intervenção da equipe.
- Responde de forma privada no canal (mensagem efêmera): nem o sucesso nem a recusa poluem a conversa.
- O botão continua ativo ao longo do tempo: ele funciona mesmo após uma reinicialização do bot.
Este módulo não é AutoRole, Role Gate nem RoleRoster
Quatro módulos lidam com cargos, com funções bem distintas:
| Módulo | Princípio |
|---|---|
| Portais de Cargos | Um botão condicional: se você tem os cargos A e B, então você recebe o cargo C. |
| AutoRole | Painéis com menus suspensos nos quais cada um se serve livremente e pode devolver o que pegou. Nenhuma condição. |
| Role Gate | Cargos concedidos automaticamente na entrada, trocas de cargos e remoção de cargos dos membros ausentes. Nenhum clique. |
| RoleRoster | Um diretório: exibe a lista dos membros de um cargo. Não atribui nada. |
Em resumo: o portal é o único dos quatro que impõe uma condição antes de conceder um cargo.
Início rápido (Admin)
- Abra o dashboard → categoria Ferramentas & Equipe → Portais Seguros.
- Clique em Novo Portal.
- Dê um nome interno (ele não aparece no Discord) e escolha o canal de publicação.
- Informe os cargos a atribuir — isso é obrigatório — e, se necessário, os cargos exigidos.
- Personalize o embed e o botão e depois Salve.
- Na lista, clique no ícone de envio para publicar o painel no canal.
Comandos
Este módulo não tem nenhum comando no Discord: tudo é configurado pelo dashboard, e os membros usam apenas o botão do painel.
Configuração pelo dashboard
A lista dos portais exibe, para cada um, seu nome, seu canal, seus cargos exigidos e seus cargos concedidos, com três ações: publicar o painel, editar, excluir.
A janela de configuração reúne quatro blocos:
- Informações básicas: nome interno (obrigatório) e canal de publicação (obrigatório).
- Condições & Ganhos:
- Cargos exigidos — opcional. Se você deixar esse campo vazio, todos podem clicar.
- Cargos a atribuir — obrigatório, um ou mais cargos.
- Aparência (Embed): título, descrição e cor.
- Botão: texto exibido e emoji (com seletor de emojis).
O número de portais é limitado a 1 para um servidor não premium (valor padrão, ajustável pela equipe TennoCore).
Bom saber
- O bot precisa da permissão Gerenciar cargos, e seu cargo deve estar posicionado acima dos cargos que ele deve atribuir. Caso contrário, o membro recebe uma mensagem de erro mencionando a hierarquia.
- Os cargos exigidos são verificados com E: o membro deve possuir todos os cargos listados. Se faltar algum, o bot informa exatamente quais.
- Um membro que já possui todos os cargos do portal recebe apenas uma informação, sem efeito.
- O portal nunca remove um cargo. Para um funcionamento alternado (pegar / devolver), use o AutoRole.
- Editar um portal não altera a mensagem já publicada: o texto, a cor e o rótulo do botão continuam os originais. Republique o painel para obter uma mensagem atualizada e depois exclua a antiga.
- Não deixe várias cópias do mesmo portal no servidor: apenas a última mensagem publicada é reativada após uma reinicialização do bot; os botões antigos ficam inertes.
- Excluir um portal no dashboard não exclui a mensagem publicada no Discord: o botão continuará visível, mas sem efeito. Apague a mensagem manualmente.
- O canal deve ser um canal em que o bot possa escrever; se o canal tiver sido excluído nesse meio-tempo, a publicação falha.
- Os portais funcionam também com um bot personalizado: o botão é atendido pelo seu bot quando o TennoCore não está no servidor.