Vanity y Server Tags

​

Qué puede hacer

• Revisar el texto del estado personalizado o el nombre de perfil de un miembro y gestionar un rol.
• Revisar el Server Tag que lleva un miembro (su servidor, su texto, o si muestra uno) y gestionar un rol.
• Mantener un rol seguro cuando varias reglas lo usan, y nunca quitar un rol que alguien dio a mano.
• Agradecer al miembro en un canal cuando una regla empieza a coincidir, con un embed guardado de Embeds (clásico o V2) si quieres.
• Registrar cada rol que las reglas agregan o quitan, con una tarjeta de Petto o un embed guardado para cada tipo de entrada.
• Revisar a todos de una vez con una barra de progreso en vivo.

​

Configuración inicial

1. Dale a Petto Gestionar roles y sube su rol por encima de todos los roles que una regla deba agregar o quitar (Ajustes del servidor → Roles). Si no, Discord rechaza el cambio de rol.
2. Las reglas de estado personalizado necesitan el Presence Intent de Petto, que ya está activado.
3. Crea una regla, luego revísala con !vanity test y aplícala con !vanity sync.

​

Reglas Vanity

​

Fuentes

​

Crear una regla

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

• name: un nombre corto para la regla (letras, números, - y _);
• word: el texto que se busca (hasta 200 caracteres);
• role: el rol que gestiona la regla;
• source: dónde buscar (por defecto custom_status);
• comparison: equals, contains (predeterminado), starts_with, ends_with o regex;
• action: add_role (predeterminado) o remove_role.

​

Otros comandos

!vanity list

!vanity edit

!vanity remove

!vanity test

!vanity sync

!vanity sync <user>

!vanity offline

​

Cuando un miembro se desconecta

• remove (el predeterminado): cuando Discord avisa que el miembro se desconectó, Petto le quita el rol. Se lo devuelve cuando vuelve a estar conectado con un estado personalizado que coincide, y le agradece de nuevo.
• keep: el miembro conserva el rol hasta que vuelve a estar conectado, y solo se le quita cuando Petto ve que el estado dejó de coincidir.

​

Reglas de Server Tag

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

​

Cómo se mantienen seguros los roles

• Un rol se queda mientras al menos una regla de agregar coincida y ninguna de quitar coincida (una regla de quitar siempre gana).
• Petto solo quita un rol si recuerda haberlo agregado él mismo. Un rol que alguien dio a mano nunca se quita, aunque una regla coincida después y deje de coincidir.
• Si el bot no puede leer un valor en ese momento (el estado personalizado de alguien desconectado o invisible, porque Discord lo oculta, o alguien de quien no tiene presencia), la regla deja su rol como está en vez de tratarlo como vacío. El rol solo se quita cuando está conectado y el estado ya no coincide.
• A los bots nunca se les cambia nada.
• Varias reglas pueden gestionar el mismo rol: es un solo rol. Se queda mientras al menos una regla de agregar coincida, se va cuando ninguna coincide (y ninguna de quitar coincide), y al miembro se le agradece una vez por cada fuente (Vanity y Server Tag), no una vez por regla. Un rol que gestionan a la vez una regla Vanity y una de Server Tag sigue siendo un solo rol.

​

Mensajes de agradecimiento

!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 cambios de roles

!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

​

Variables para los mensajes

{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}

​

Roles que vuelven

​

Si vienes del bot Vanity

​

Solución de problemas

​

No se agrega el rol

1. Petto tiene Gestionar roles y su rol está por encima del rol de destino.
2. Se eligió la fuente correcta (custom_status no es el nombre de usuario).
3. El texto coincide con la comparación. Prueba !vanity test @member.
4. Usa !vanity sync después de cambiar una regla.

​

No se quita el rol

1. Puede que el servidor esté en keep (!vanity offline): entonces un miembro desconectado o invisible conserva el rol, porque Discord oculta su estado personalizado. Usa !vanity offline remove (el predeterminado) si quieres que se quite cuando se desconecte.
2. Petto solo quita roles que dio él mismo. Un rol que alguien dio a mano se queda.
3. Si otra regla que gestiona el mismo rol sigue coincidiendo, el rol se queda. Revísalo con !vanity test @member.

​

No llega el mensaje de agradecimiento

​

El Server Tag aparece vacío o tarde