Saltar al contenido principal

Resumen

Los niveles registran la XP de cada miembro con una curva y un tiempo de espera que tú controlas, no con una fórmula fija. Todos los subcomandos de !level de abajo requieren Gestionar servidor.
chu escribe en #general y Petto responde que chu acaba de subir al nivel 15, con una tarjeta con su avatar, el nivel 15 y el rango 4

En Discord: un mensaje hace subir de nivel a un miembro, y Petto le responde con el mensaje de subida y la tarjeta de nivel.

Las páginas de Niveles del dashboard eligen la tarjeta de rank (las tarjetas se diseñan en Tarjetas de imagen) con su vista previa, y configuran las reglas y los eventos de XP.
La página Ajustes de niveles con las tasas de XP, el canal de anuncios y una vista previa del mensaje de subida de nivel

Dashboard → Niveles → Niveles: el XP por mensaje y por minuto en voz, el tiempo de espera, el modo de los roles de recompensa y el anuncio de subida de nivel con su vista previa.

Activarlo y configurar la tasa

liam escribe !level enable true y Petto responde que los niveles están activados

En Discord: se activan los niveles.

liam escribe !level xp 15 25 y Petto confirma de 15 a 25 de XP por mensaje

En Discord: la XP de cada mensaje queda entre 15 y 25.

liam escribe !level voice-xp 5 y Petto confirma 5 de XP por minuto en voz

En Discord: 5 de XP por cada minuto en voz.

liam escribe !level cooldown 60 y Petto confirma una espera de 60 segundos

En Discord: un miembro gana XP de mensajes como mucho una vez por minuto.

La XP por mensaje es una cantidad al azar entre min y max, con un tiempo de espera por miembro. voice-xp es una cantidad fija por minuto en voz, sin tiempo de espera.

La curva de XP

La XP total por nivel es (a·L³ + b·L² + c·L) × difficulty, redondeada. Los niveles de los miembros que ya existen se recalculan con la nueva curva cuando la cambias; toca esto solo si sabes lo que haces.
liam escribe !level curve 1 50 100 3 100 y Petto responde que la curva se actualizó, con la XP de los niveles 10, 25 y 50

En Discord: una curva nueva, con la XP total que pide para los niveles 10, 25 y 50.

liam escribe !level max-level 200 y Petto confirma el nivel máximo de 200

En Discord: el nivel máximo ahora es 200.

Valores predeterminados: a=1, b=50, c=100, difficulty=2.5, rounding=50.

Notificaciones

liam escribe !level notify channel #niveles --every 5 y Petto confirma el modo channel

En Discord: las subidas de nivel van a #niveles, cada 5 niveles.

liam configura un anuncio en respuesta con su propio mensaje y Petto confirma el modo reply

En Discord: el anuncio responde en el mismo canal, con su propio texto.

liam escribe !level notify reply --delete_after 30 y Petto confirma el modo reply

En Discord: el anuncio se borra solo después de 30 segundos.

liam le da al nivel 50 su propio mensaje y Petto responde que el nivel 50 tiene un mensaje propio

En Discord: el nivel 50 recibe un mensaje propio.

liam escribe !level voice-notify channel #niveles y Petto confirma los anuncios de voz en modo channel

En Discord: las subidas de nivel de voz se anuncian en #niveles.

mode es off, reply (en el canal donde subió de nivel), channel (fijo) o dm. Las subidas de nivel de voz también pueden ser reply: van al chat del canal de voz donde está el miembro. every limita los anuncios a cada N niveles en vez de a cada uno. message admite {user}, {level}, {level_xp}, {level_rank}, {level_role} (el rol de recompensa que acaba de ganar) y todas las variables de embed. Como todo MD de Petto, este empieza con una línea gris De <servidor> y tiene botones de info, borrar y reportar: mira MD de Petto.
Usa --message, --every y los demás nombres para todo lo que va después del canal. Las opciones se leen en orden (mode, channel, embed, embed_template, every, message…), así que !level notify reply "¡{user} llegó al nivel {level}!" guardaría tu texto como el nombre de un embed guardado.
El dashboard tiene todo esto en la página Niveles: un interruptor para la respuesta y la mención, el tiempo para borrar, y una línea por cada nivel con su propio mensaje, como 10: ¡{user} ahora es nivel {level}!.

Ejemplos

Comando
Resultado
chu escribe en #general y Petto responde: ¡GG @chu, acabas de llegar al nivel 12!

En Discord: chu sube de nivel y Petto responde al mensaje con el texto clásico.

Variables

La lista completa, con {level_xp_current} y {level_xp_needed}, está en Variables. Las variables se reconocen sin importar las mayúsculas y con espacios dentro de las llaves, así que {user.mention}, { User.Mention } y {USER_MENTION} funcionan todas, y también los nombres que usan otros bots ({mention}, {member}, {level.xp}, {level.rank}…). Una variable que Petto no conoce se queda como la escribiste, así que un error de escritura es fácil de ver.

Rank y clasificaciones

!rank responde con una tarjeta (una imagen con el avatar, el nombre, el nivel, el puesto y una barra de progreso), el embed, o ambos, según !level rank-style. El embed muestra el nivel, el puesto entre todos los miembros clasificados, la XP que lleva en este nivel y la que necesita, la barra de progreso y la XP total, y además el tiempo en voz en un rank de voz. card indica la tarjeta de imagen que se usa; un servidor sin una recibe una tarjeta predeterminada, con su propio color para voz.
chu escribe !rank y Petto responde con una tarjeta: chu, nivel 15, rango 4, 2050 de 5950 XP con la barra

En Discord: la tarjeta de rank predeterminada.

chu escribe !rank @shi voice y Petto responde con la tarjeta de voz de shi: nivel de voz 18, rango 2

En Discord: el rank de voz de otro miembro, en la tarjeta verde azulada.

chu escribe !rank y Petto responde con un embed: nivel 15, rango 4 de 312, 2050 de 5950 XP, progreso 34% con la barra y la experiencia total

En Discord: el rank como embed, con rank-style embed.

chu escribe !rank y Petto responde con el embed del rank y la tarjeta como imagen

En Discord: el embed con la tarjeta dentro, con rank-style both.

liam escribe !level rank-style both myrank y Petto confirma tarjeta y embed usando la tarjeta myrank

En Discord: !rank ahora responde con la tarjeta y el embed, usando la tarjeta myrank.

!top muestra la clasificación de messages o voice. period es all (predeterminado), week o month, y las clasificaciones semanales y mensuales empiezan vacías solas cada semana y cada mes.
chu escribe !top y Petto responde con la clasificación de Petto Land: Chillet nivel 31, kira 27, mia.draws 24, chu 15 y más, página 1 de 32

En Discord: la clasificación del servidor, 10 miembros por página con botones.

chu escribe !top 1 messages week y Petto lista la XP de esta semana: kira 4120, zoe_plays 3610, chu 2985 y más

En Discord: la clasificación de esta semana, por la XP ganada en la semana.

chu escribe !top 1 voice y Petto responde con la clasificación de voz: Chillet nivel de voz 22, shi 18, zoe_plays 14 y más

En Discord: la clasificación de voz.

El embed está ordenado como los de otros bots de niveles: el miembro arriba con el avatar al costado, luego un campo debajo de otro (Nivel, Rango en el servidor, Experiencia y Progreso con la barra), y la experiencia total con la hora al final. No tiene color. La tarjeta predeterminada, cuando un servidor no ha diseñado una, tiene el avatar a la izquierda, el nivel y la barra al lado, en el color durazno de Petto (verde azulado para voz), sobre una imagen que viene con Petto.
La página Tarjeta de rank con Tarjeta elegida, la tarjeta de rank predeterminada, la tarjeta level para las subidas, la vista previa de la tarjeta de liam en el nivel 12 y la del embed

Dashboard → Niveles → Tarjeta de rank: tarjeta, embed o ambos, las tarjetas del rank y de la subida de nivel, y las vistas previas.

Página pública de clasificación

Un servidor puede mostrar su clasificación en la web. Está desactivada hasta que la actives en el dashboard (Niveles, luego Clasificación, Página pública).
La página Clasificación con la página pública activada, el nombre pettoland, la invitación discord.gg/pettoland, el enlace petto.sbs/lb/pettoland y los primeros miembros por XP

Dashboard → Niveles → Clasificación: el interruptor de la página pública, el nombre en la dirección, el enlace del botón para unirse y la clasificación.

  • La página está en petto.sbs/lb/<name>. El nombre es el que elijas (de 2 a 32 letras, números o guiones), o el ID del servidor si lo dejas vacío. También existe como /es/lb/<name> y /pt-br/lb/<name>.
  • Muestra el top 500 por mensajes o por voz, 25 por página: nombre, imagen, nivel y XP de cada miembro. No se muestra nada más de un miembro, y un miembro que se fue aparece como exmiembro.
  • Un botón para unirse opcional lleva a la gente a una invitación que elijas (tiene que empezar con https://).
  • Al desactivar el interruptor, la página responde “no es pública” al instante.
La página pública de clasificación de Petto Land con las pestañas Mensajes y Voz, los botones Unirse al servidor y Copiar enlace, y los miembros con su nivel, XP y mensajes

En la web: petto.sbs/lb/pettoland, la clasificación pública de Petto Land con el botón para unirse.

La clasificación de voz del dashboard: Chillet nivel de voz 22, shi 18, zoe_plays 14, kira 12 y más, con XP de voz y minutos

Dashboard → Niveles → Clasificación de voz: los miembros por XP de voz, con sus minutos en voz.

Reglas contra el abuso

liam escribe !level rules y Petto lista el largo mínimo, el texto repetido, lo que necesita la voz, el límite de chat, el bonus diario y de racha, los miembros que se van y los multiplicadores

En Discord: sin opciones, las reglas actuales del servidor.

liam escribe !level rules min_chars 5 y Petto responde Actualizado con las reglas, ahora con un largo mínimo de 5 caracteres

En Discord: los mensajes de menos de 5 caracteres dejan de ganar XP.

liam escribe !level rules anti_repeat on y Petto responde Actualizado con Ignorar texto repetido activado

En Discord: el texto repetido vuelve a no ganar XP.

liam escribe !level rules voice_min_members 50 y Petto responde que voice_min_members acepta un número entero de 1 a 20

En Discord: un valor fuera de rango se rechaza y Petto dice qué acepta la regla.

Sin opciones muestra los valores actuales. Los ajustes son: Los servidores nuevos empiezan con 3 caracteres, la protección contra repeticiones activada y 1 persona necesaria en voz.
La tarjeta Empezar desde un perfil con Relajado, Equilibrado y Estricto, la tarjeta Chat con el largo mínimo y el límite diario de XP, y la tarjeta Voz con las personas necesarias y la XP estando solo

Dashboard → Niveles → Reglas y eventos: los perfiles, y las reglas del chat y de la voz.

Eventos de XP

liam escribe !level event add weekend 2 2d all y Petto confirma weekend, número 3: x2 de XP por 2 días, empezando ahora

En Discord: un fin de semana de XP doble que empieza ahora.

liam escribe !level event add voicenight 1.5 6h voice 1d y Petto confirma x1.5 de XP de voz por 6 horas, empezando mañana

En Discord: un evento de voz que empieza mañana.

liam escribe !level event list y Petto lista weekend x2 toda la XP que termina en 2 días, y voicenight x1.5 XP de voz que empieza en 24 horas

En Discord: los eventos en curso y los que vienen.

liam escribe !level event remove 4 y Petto responde Evento de XP eliminado

En Discord: un evento cancelado por su número.

Un evento multiplica la XP que se gana durante una cantidad de horas o días. applies_to es all, text o voice, y starts_in lo programa para más tarde en vez de empezarlo ahora. El multiplicador va de 1.1 a 20, un evento dura de 1 minuto a 60 días, y un servidor puede tener 25 eventos en curso o programados a la vez.
La tarjeta Eventos de XP con weekend a x2 para toda la XP y voicenight a x1.5 para voz, y los campos nombre, multiplicador, se aplica a, dura y empieza en

Dashboard → Niveles → Reglas y eventos: los eventos de XP, y el formulario para añadir uno.

Bonus diario y rachas

Configura daily_bonus y streak_bonus con !level rules para dar XP extra por la primera actividad del día, más una cantidad extra por cada día seguido anterior, hasta streak_max_days. La racha es {level_streak} en los mensajes de subida de nivel.
liam escribe !level rules daily_bonus 50 y Petto responde Actualizado con Bonus diario 50 XP y el de racha de 10 XP por día, hasta 7 días

En Discord: 50 de XP por la primera actividad de cada día.

La tarjeta Bono diario y racha con 50 de XP al día, 10 de XP por día anterior y el bonus de racha que se detiene a los 7 días

Dashboard → Niveles → Reglas y eventos: el bono diario y la racha.

Niveles de voz

El tiempo en voz tiene sus propios ajustes, así que los niveles de voz y de mensajes pueden seguir reglas distintas.
liam escribe !level voice-enable true y Petto responde que los niveles de voz están activados

En Discord: se activan los niveles de voz.

liam escribe !level voice-curve 1 50 100 3 100 y Petto responde que la curva de XP de voz se actualizó con la XP de los niveles 10, 25 y 50

En Discord: una curva de voz nueva con su vista previa.

liam escribe !level voice-max-level 300 y Petto confirma el nivel de voz máximo de 300

En Discord: el nivel de voz máximo ahora es 300.

liam escribe !level voice-role-mode all y Petto confirma el modo de roles de voz: todos los ganados

En Discord: los miembros conservan todos los roles de recompensa de voz.

liam escribe !level voice-ignore #AFK y Petto responde que AFK se añadió a los canales de voz ignorados

En Discord: el canal AFK deja de dar XP de voz.

  • voice-enable activa o desactiva los niveles por tiempo en voz (la cantidad por minuto es !level voice-xp).
  • voice-curve es la misma fórmula que la curva de XP, aplicada a la voz, y sus valores predeterminados también son los mismos (a=1, b=50, c=100, difficulty=2.5).
  • voice-max-level es el nivel de voz más alto (1000 por defecto).
  • voice-role-mode dice si los miembros conservan todos los roles de recompensa de voz (all) o solo el más alto (highest, lo predeterminado).
  • voice-ignore mete o saca un canal de voz, o toda una categoría, de la XP de voz, como hace !level ignore con los canales de texto. Úsalo otra vez para deshacerlo.
  • Los niveles de voz tienen sus propios roles de recompensa: !level reward add 10 @Conversador --type voice. Mira Recompensas por nivel.
La página Niveles de voz, activada, con 5 de XP por minuto de voz, solo el rol de recompensa más alto, el anuncio desactivado, su mensaje y vista previa, y el canal AFK ignorado

Dashboard → Niveles → Niveles de voz: el interruptor, la XP por minuto, los roles de recompensa, el anuncio con su vista previa y los canales ignorados.

Quién gana XP

liam escribe !level ignore #comandos y Petto responde que se añadió a los canales ignorados

En Discord: un canal que no gana XP.

liam escribe !level ignore #STAFF y Petto responde que STAFF se añadió a las categorías ignoradas

En Discord: una categoría entera que no gana XP.

liam escribe !level ignore --role @Silenciado y Petto responde que @Silenciado ya no gana XP

En Discord: un rol cuyos miembros no ganan XP.

liam escribe !level ignore --only_role @Miembros y Petto responde que @Miembros se añadió a los roles que pueden ganar XP

En Discord: solo los miembros con este rol ganan XP.

Usarlo otra vez sobre el mismo lo revierte. Las opciones que no son la primera van con --, como --role @Silenciado. Todo esto también se puede configurar en el dashboard, en Niveles y en Reglas y eventos.
  • channel puede ser un canal o una categoría. Los canales de la lista, y todos los canales de una categoría de la lista, no dan XP.
  • role es un rol cuyos miembros no ganan XP.
  • only_role elige los roles que son los únicos que pueden ganar XP. Si no eliges ninguno, todos pueden ganar XP.
La tarjeta Quién gana XP con Silenciado en los roles que no ganan XP y nada en los únicos roles que ganan XP

Dashboard → Niveles → Reglas y eventos: los roles que no ganan XP y los únicos roles que la ganan.

Miembros que se van y vuelven

liam escribe !level rules restore_roles on y Petto responde Actualizado: su XP se conserva y los roles de recompensa se devuelven al volver

En Discord: los miembros que vuelven recuperan sus roles de recompensa.

liam escribe !level rules reset_on_leave on y Petto responde Actualizado: su XP se borra y los roles se devuelven al volver

En Discord: la XP de un miembro que se va se borra.

liam escribe !level manage sync y Petto responde que revisó 12 miembros con nivel y entregó los roles de recompensa que faltaban

En Discord: los miembros con nivel reciben los roles de recompensa que les faltaban.

  • restore_roles (activado por defecto): un miembro que vuelve recupera los roles de recompensa que ganaron sus niveles.
  • reset_on_leave (desactivado por defecto): se borran la XP y el nivel de un miembro que se va. Desactivado los conserva.
  • manage sync revisa a cada miembro que tiene un nivel y le da los roles de recompensa que ganó y todavía no tiene, para niveles de mensajes y de voz. Es para después de agregar recompensas a un servidor que ya tiene niveles. Revisa hasta 2000 miembros cada vez, con una pausa corta, así que úsalo otra vez para el resto de un servidor grande.
La tarjeta Miembros que se van y vuelven con devolver los roles de recompensa activado y borrar la XP y el nivel desactivado

Dashboard → Niveles → Reglas y eventos: qué pasa con la XP y los roles de recompensa de un miembro que se va.

Bonus al entrar

liam escribe !level join 0 5 y Petto responde que los miembros nuevos ahora empiezan con el nivel 5

En Discord: los miembros nuevos empiezan en el nivel 5.

liam escribe !level sync-join y Petto responde Sincronización completa, 3 miembros afectados

En Discord: el bonus se da a los miembros que siguen en cero.

Da a los miembros nuevos una XP/nivel inicial. level tiene prioridad si se configuran ambos. sync-join aplica de forma retroactiva el bonus actual a todos los miembros que siguen en cero.

Gestión manual de XP/nivel

liam escribe !level manage xp add @nico 500 y Petto responde que añadió 500 XP a @nico

En Discord: 500 de XP añadidos a un miembro.

liam escribe !level manage xp transfer @mia.draws 200 @zoe_plays y Petto responde que transfirió 200 XP de @mia.draws a @zoe_plays

En Discord: 200 de XP pasados de un miembro a otro.

liam escribe !level manage level set @nico 12 y Petto responde que nico ahora es nivel 12

En Discord: un miembro puesto en el nivel 12 (la XP lo sigue).

liam escribe !level reset @maxwell y Petto responde que reinició la XP y el nivel de maxwell y le quitó los roles de recompensa

En Discord: la XP, el nivel y los roles de recompensa de un miembro se borran.

action es add, set, remove o (solo XP) transfer a otro miembro. reset borra la XP/nivel de un miembro y le quita sus roles de recompensa.

Estado

Muestra toda la configuración actual en un solo lugar.
liam escribe !level status y Petto lista cada ajuste: XP, voz, curvas, niveles máximos, modo de roles, anuncios, estilo del rank, reglas, bonus al entrar, canales y roles ignorados, recompensas y multiplicadores

En Discord: toda la configuración en una tarjeta.

!levelconfig (nombre corto !xpconfig, necesita Gestionar servidor) responde con una tarjeta de lo que este servidor tiene guardado para los niveles, y cada comando de !level para cambiarlo.
liam escribe !levelconfig y Petto responde con la tarjeta de ajustes de niveles: cada ajuste guardado, luego los comandos para cambiarlo y más comandos, y un botón de documentación

En Discord: la tarjeta de ajustes del módulo, con cada comando para cambiarlo.

Relacionado

Recompensas por nivel

Roles de recompensa y multiplicadores de XP.