Vanity e Server Tags

​

O que dá para fazer

• Verificar o texto do Status personalizado ou o nome do perfil de um membro e gerenciar um cargo.
• Verificar o Server Tag que um membro usa (o servidor dele, o texto, ou se ele mostra um) e gerenciar um cargo.
• Manter um cargo seguro quando várias regras o usam, e nunca tirar um cargo que alguém deu manualmente.
• Agradecer o membro em um canal quando uma regra passa a corresponder, com um embed salvo de Embeds (clássico ou V2), se quiser.
• Registrar cada cargo que as regras adicionam ou removem, com um cartão do Petto ou um embed salvo para cada tipo de entrada.
• Verificar todo mundo de uma vez com uma barra de progresso ao vivo.

​

Primeira configuração

1. Dê ao Petto Gerenciar cargos e coloque o cargo dele acima de todos os cargos que uma regra deve adicionar ou remover (Configurações do servidor → Cargos). Caso contrário, o Discord recusa a mudança de cargo.
2. As regras de Status personalizado precisam da Presence Intent do Petto, que já está ativada.
3. Crie uma regra, depois confira com !vanity test e aplique com !vanity sync.

​

Regras de Vanity

​

Fontes

​

Crie uma regra

!vanity add cinnamochi cinnamochi @Rep
!vanity add cinnamochi cinnamochi @Rep --source custom_status --comparison contains --action add_role

• name: um nome curto para a regra (letras, números, - e _);
• word: o texto a procurar (até 200 caracteres);
• role: o cargo que a regra gerencia;
• source: onde procurar (padrão custom_status);
• comparison: equals, contains (padrão), starts_with, ends_with ou regex;
• action: add_role (padrão) ou remove_role.

​

Outros comandos

!vanity list

!vanity edit

!vanity remove

!vanity test

!vanity sync

!vanity sync <user>

!vanity offline

​

Quando um membro fica offline

• remove (o padrão): quando o Discord avisa que o membro ficou offline, o Petto tira o cargo. Ele devolve quando o membro estiver online com um Status personalizado que corresponda, e agradece de novo.
• keep: o membro mantém o cargo até ficar online de novo, e ele só sai quando o Petto vê que o status deixou de corresponder.

​

Regras de Server Tag

!guildtag add partner is_guild_id @Partner 707307527846625280
!guildtag add shows-tag identity_enabled @Tagged

​

Como os cargos ficam seguros

• Um cargo fica enquanto pelo menos uma regra de adicionar corresponde e nenhuma regra de remover corresponde (uma regra de remover sempre vence).
• O Petto só tira um cargo se lembra de tê-lo adicionado ele mesmo. Um cargo que alguém deu manualmente nunca é removido, mesmo que uma regra depois passe a corresponder e deixe de corresponder.
• Se o bot não consegue ler um valor agora (o Status personalizado de alguém que está offline ou invisível, porque o Discord o esconde, ou de alguém de quem ele não tem a presença), a regra deixa o cargo como está em vez de tratá-lo como vazio. O cargo só é tirado quando a pessoa está online e o status não corresponde mais.
• Bots nunca são alterados.
• Várias regras podem gerenciar o mesmo cargo: é um cargo só. Ele fica enquanto pelo menos uma regra de adicionar corresponde, sai quando nenhuma corresponde (e nenhuma regra de remover corresponde), e o membro recebe um agradecimento por fonte (Vanity e Server Tag), não um por regra. Um cargo que uma regra de Vanity e uma regra de Server Tag gerenciam continua sendo um cargo só.

​

Mensagens de agradecimento

!vanity notify #thanks
!vanity notify #thanks my-embed none
!guildtag notify #tags
!vanity notify-off

!vanity notify #thanks

!vanity notify #thanks my-embed none

!guildtag notify #tags

!vanity notify-off

​

Registro de mudanças de cargos

!identity logs #staff-log
!identity log-event vanity_add false
!identity log-embed tag_add my-embed
!identity logs-off

!identity logs

!identity log-event

!identity log-embed

!identity logs-off

​

Variáveis para as mensagens

{vanity.rule} {vanity.word} {vanity.source} {vanity.value} {vanity.role}
{tag} {tag.rule} {tag.condition} {tag.rule_value} {tag.guild_id} {tag.enabled} {tag.badge} {tag.role}
{rule.name} {rule.source} {rule.value} {rule.condition} {rule.reason} {rule.role} {rule.role_id}
{rule.action} {rule.action_text} {rule.result} {rule.error} {rule.matched_value} {rule.event} {rule.event_title}

​

Cargos que voltam

​

Vindo do bot Vanity

​

Solução de problemas

​

O cargo não é adicionado

1. O Petto tem Gerenciar cargos e o cargo dele está acima do cargo de destino.
2. A fonte certa foi escolhida (custom_status não é o nome de usuário).
3. O texto corresponde à comparação. Teste com !vanity test @member.
4. Rode !vanity sync depois de mudar uma regra.

​

O cargo não é tirado

1. O servidor pode estar em keep (!vanity offline): nesse caso, um membro offline ou invisível mantém o cargo, porque o Discord esconde o Status personalizado dele. Use !vanity offline remove (o padrão) se quiser que o cargo saia quando ele ficar offline.
2. O Petto só tira cargos que ele mesmo deu. Um cargo que alguém deu manualmente fica.
3. Se outra regra que gerencia o mesmo cargo ainda corresponde, o cargo fica. Confira com !vanity test @member.

​

A mensagem de agradecimento não chega

​

O Server Tag aparece vazio ou atrasado