Scoreboards Documentation
Everything you need to create and manage Discord leaderboards
- Añade el bot — Invita a Scoreboards a tu server de Discord con el enlace de invitación de la página principal.
- Pasa por el asistente — Usa
/leaderboard create: un formulario rápido para ponerle nombre al ranking, elegir el tipo y, si quieres, un canal de logs — y se publica directamente en el canal. Los rankings de puntos, Highscore y Time arrancan con un par de entradas de ejemplo para que veas cómo se comporta el ranking; desaparecen en cuanto llega la primera puntuación real. Después, pulsa Más opciones en la respuesta para el orden, partidas por equipos o todos contra todos. - Asigna los roles — Abre el panel para definir el rol
bot permission(quién puede gestionar rankings) y el rolvalidator(quién puede aprobar envíos). - Añade más rankings — Vuelve a usar
/leaderboard createpara cada uno. Más opciones en la respuesta fija el orden, partidas por equipos o todos contra todos; todo lo demás está en el panel. - Publícalo — Usa
/leaderboard showen un canal para colocar el ranking interactivo, con botones de envío y paginación.
Scoreboards solo necesita un puñado de permisos de Discord, y un servidor con la configuración por defecto ya los concede. Los que importan van por canal — un bot puede tener acceso a un canal y estar fuera del siguiente —, así que cuando un ranking deja de actualizarse, este es el primer sitio donde mirar.
En el canal del ranking
- View Channel y Read Message History — para encontrar su propio mensaje del ranking y editarlo. Sin ellos el ranking solo se actualiza cuando alguien ejecuta
/leaderboard show: un comando de barra se responde aunque el bot no pueda leer, una edición no. - Send Messages — para publicar el ranking y avisarte cuando algo va mal.
- Embed Links y Attach Files — el ranking es una imagen con un pie debajo. Sin Attach Files se pierde la imagen; sin Embed Links, el pie y la tabla de respaldo.
- Create Public Threads y Send Messages in Threads — los hilos de partida de los rankings ELO y League se abren aquí.
En el canal de logs
El mismo conjunto. Los envíos se publican ahí para revisarlos y el bot los edita al aprobarlos o rechazarlos; las entradas con imagen van como adjuntos. Si el canal del ranking no puede alojar un hilo de partida, se abre aquí. Si el bot no puede escribir en el canal de logs, la solicitud de revisión se publica en el canal del ranking, indicando el permiso que falta.
En todo el servidor
- Manage Roles — para los Tier Roles y los roles que se venden en la tienda. Además, el rol de Scoreboards tiene que estar por encima de todos los roles que reparte, en Server Settings → Roles.
- Change Nickname — solo si renombras al bot en Branding.
- Manage Channels, Connect y Move Members — solo para los canales de voz del matchmaking, y solo en la categoría donde está el canal de logs.
El enlace Add to Discord pide View Channel, Send Messages, Embed Links, Attach Files, Read Message History y Send Messages in Threads. Todo lo demás sale de los valores por defecto de @everyone de tu servidor o de los roles que le des al bot — así que un servidor que haya restringido @everyone tiene que darle esos permisos al bot por su cuenta, por canal o en su rol.
Cuando falta un permiso, el bot lo dice en vez de fallar en silencio: un mensaje en el canal del ranking por Embed Links, Attach Files o un tier role que no puede asignar, y uno en el canal de logs cuando no llega al ranking en absoluto.
Al crear un ranking con /leaderboard create eliges entre siete tipos:
Classic
Suma o resta puntos a un total acumulado. Ideal para juegos en los que la puntuación se va sumando partida a partida.
Highscore
Guarda solo la mejor marca de cada jugador. Las puntuaciones anteriores más bajas se sustituyen solas.
Time (Speedrun)
Envía tiempos como 00:00:00 (centésimas) o 00:00:000 (milisegundos): el formato de cada ranking se elige en el panel, y los rankings nuevos usan milisegundos por defecto. Ordena de menor a mayor si gana el más rápido, o de mayor a menor si gana el que más aguanta.
ELO - Ranked
Sistema ELO competitivo, en 1v1 o en equipos de 2v2 a 8v8. Envía el resultado del match y el rating de cada participante se actualiza solo.
Rating
Los miembros suben imágenes y la comunidad las vota con estrellas (1–10). La media de los votos es la puntuación. Perfecto para concursos de arte y retos creativos.
League
Ranking por puntos basado en matches, para fútbol, baloncesto o FIFA. Configuras los puntos por victoria, empate y derrota (3/1/0 por defecto) y el marcador de cada match (por ejemplo, 3-1).
Levels (BETA)
Ordena a los miembros por la XP que ganan chateando y pasando tiempo en canales de voz. Incluye niveles, mensajes de subida de nivel y roles por nivel, y nadie tiene que enviar nada.
Gestión de rankings
| Comando | Descripción | Permiso |
|---|---|---|
/leaderboard create | Crea un ranking en un solo formulario —nombre, tipo y canal de logs opcional— y publícalo en el canal; Más opciones fija luego el orden y el formato de partida | Admin / Bot Permission |
/leaderboard show | Muestra el ranking en el canal actual, con botones interactivos | Admin / Bot Permission |
/leaderboard settings | Abre el panel para gestionar los ajustes de este scoreboard (orden, visibilidad, encabezados, modo de vista, configuración de ELO y más) | Admin / Bot Permission |
/leaderboard delete | Borra un ranking y todos sus datos para siempre (pide confirmación) | Admin / Bot Permission |
Envíos de puntuaciones y matches
| Comando | Descripción | Permiso |
|---|---|---|
/score | Establece o ajusta la puntuación, el ELO o el tiempo de un jugador. Elige la clasificación y luego Establecer o Ajustar en el formulario. Las clasificaciones de valoración de imágenes no se incluyen. Un Comentario opcional explica por qué, y aparece en el aviso de tu canal de logs. Elige un rol para dar el mismo cambio a todos los miembros que lo tienen. Para todo el servidor, escribe @everyone en Jugadores de fuera. | Admin / Bot Permission |
Configuración
| Comando | Descripción | Permiso |
|---|---|---|
/help | Consulta la ayuda interactiva con todos los temas disponibles | Todos |
/feedback | Envíanos comentarios con tus propias palabras: ideas, problemas, lo que sea | Todos |
/delete_my_data | Borra de forma permanente tus rankings personales y puntuaciones, y tus datos de moneda en todos los servidores (requiere confirmación) | Todos |
/uninstall | Quita el bot del servidor. Un formulario pregunta por qué no funcionó (opcional); después se borran todos los rankings y puntuaciones del servidor | Admin |
Economía (beta)
La economía no tiene comandos. Los miembros pulsan el botón Shop bajo un leaderboard, o abren la página de la tienda del servidor, para ver su saldo, comprar roles, emojis de tablero y colores de nombre, y desplegar cualquier pago para ver exactamente cómo se calculó. Los admins la configuran, llenan la tienda y dan o quitan moneda en el panel, en Economía.
Hay dos formas de enviar:
- En Discord, pulsa el botón de envío del mensaje del ranking: se llama Submit score en Classic/Highscore/Time, Submit result en ELO y League, y Submit image en Rating. El bot abre el modal que corresponda: entrada de puntuación, selector de jugador y ganador, selector de jugador y marcador, o un nombre junto con la propia imagen. En un ranking por equipos, los selectores te piden la alineación completa de cada bando en vez de un solo jugador, y un ranking free-for-all lleva un botón Report result en su lugar.
- Desde la web, abre el ranking y pulsa Submit para ese mismo flujo: es la única vía que admite un nombre personalizado, para jugadores que no están en tu servidor de Discord.
Proceso de revisión
- El envío se publica en el canal de logs configurado (si lo hay).
- Un validador o administrador pulsa Approve o Reject. En un partido de ELO o League también pueden aprobar los jugadores que participaron: basta con que el rival confirme el resultado, así que un servidor no necesita rol de validador para que los partidos avancen. Quien reportó el partido no puede aprobar su propio reporte, y solo esa persona puede rechazarlo. Si un ranking no tiene canal de logs, los envíos se aprueban al instante; configura un canal de logs para revisarlos antes.
- Si se rechaza, quien lo envió recibe un DM con el motivo.
- Si se aprueba, el ranking se actualiza al instante.
Aprobación automática
Cada ranking puede aprobar los envíos automáticamente pasado el tiempo que elijas: desactivada, al instante, 1 hora, 3 horas, 24 horas, 3 días o 7 días. En los rankings ELO son 24 horas por defecto.
Anular una puntuación
Los admins y los validadores pueden anular una puntuación ya aprobada: haz clic derecho en el mensaje del envío y elige «Cancel Review». Eso revierte el cambio de puntuación y hay que indicar un motivo.
El tipo de ranking ELO - Ranked ordena a los jugadores por nivel con un sistema de rating ELO, en 1v1 o en equipos de hasta ocho por bando.
Cómo funciona
- Cada jugador arranca con un ELO inicial configurable (1200 por defecto).
- Un match puede acabar en victoria, derrota o empate.
- Los ratings se calculan con un factor K de 32.
- El rating de todos los participantes se actualiza a la vez en cuanto se aprueba el resultado.
Matches por equipos (2v2 – 8v8)
Los rankings ELO y League pueden tener un tamaño de equipo fijo: lo eliges al crear el ranking o lo cambias después en Match format, dentro del panel. A partir de ahí, cada match de un ranking 3v3 se juega tres contra tres, y la clasificación sigue siendo individual.
En ELO, el resultado esperado de cada equipo sale de su rating medio, y el cambio se aplica a todos sus integrantes: ganar a un equipo más fuerte da la misma subida a todo el bando vencedor. En League, cada jugador del equipo ganador se lleva los puntos de victoria, y todo el equipo perdedor, los de derrota.
Queue de matchmaking (Beta)
Si el botón de queue está activado en el ranking, los jugadores pueden pulsarlo para entrar en la queue de matchmaking. El sistema junta a jugadores con un ELO parecido usando un algoritmo de ventana que se va ampliando. Cuando hay match se crea un hilo con botones para que la comunidad vote el resultado. Si en 5 minutos no aparece rival, la entrada en la queue caduca.
En un ranking por equipos, la queue espera a que haya gente suficiente para llenar los dos bandos (seis para un 3v3) y luego los reparte en dos equipos con la media de rating lo más pareja posible, de forma que el mejor y el peor acaben enfrentados. Todos tienen que pulsar Ready; quien no lo haga se queda fuera y el resto vuelve a la queue conservando su sitio.
Cada equipo tiene su propio canal de voz para hablar de táctica sin que el rival escuche: solo ves el canal de tu equipo y solo puedes entrar en ese. Los dos canales desaparecen cuando el match se cierra. Un resultado queda fijado cuando lo vota la mayoría de cada equipo (dos de tres en un 3v3), así que ningún equipo puede darse la victoria por su cuenta; cualquier otra cosa abre una disputa para que la resuelva un validador.
La queue ya no es solo para ELO: una clasificación de League también puede activarla. Como los puntos de League son un total acumulado y no una estimación de nivel, los boards de League emparejan por puntos por partida, así que jugar más no te mueve por sí solo en la queue.
Equipos fijos
Un ranking ELO o League con tamaño de equipo puede funcionar además en modo fixed teams (se activa en el panel, junto a Match format). Los equipos con nombre propio se inscriben una sola vez con el botón Team sign-up del ranking: eliges nombre y luego la plantilla, que admite hasta dos reservas por encima del tamaño de equipo. A partir de ahí la clasificación es de equipos: en un ranking ELO cada equipo tiene su propio rating y ganar a uno más fuerte compensa más; en uno League, la tabla ordena a los equipos por puntos, igual que una liga de verdad. Los equipos fijos de League registran sus matches con el botón Submit result del ranking.
Cuando cualquier integrante pulsa Queue, entra el equipo entero y todos reciben un DM. El emparejamiento enfrenta equipo contra equipo por rating, y el ready-check hace también de alineación: juegan los primeros de cada plantilla en pulsar Ready hasta completar el tamaño de equipo, y el resto se queda fuera de ese match. El resultado lo votan quienes jugaron, con la misma regla de mayoría en cada bando. La plantilla de cada equipo se ve en la página del ranking en la web: el número de miembros aparece junto al nombre del equipo, al pasar el ratón se listan los nombres, y al abrir el equipo se muestra la plantilla completa con el capitán marcado.
El tipo de ranking League ordena a los jugadores por los puntos que acumulan match a match. Es el formato que quieres para fútbol, baloncesto, fútbol sala, hockey y cualquier competición 1v1 o por equipos en la que la tabla de la season es la que manda.
Cómo funciona
- Registra un match con el botón Submit result del ranking: el bot te pide los dos bandos y el marcador de cada uno (por ejemplo, 3 y 1).
- Gana quien tenga el marcador más alto; si son iguales, es empate.
- El bando ganador se lleva points_win, el perdedor points_loss y, si hay empate, todos se llevan points_draw. En una liga por equipos, cada jugador recibe los puntos de su bando.
- El ranking ordena a los jugadores por puntos totales, y lleva la cuenta aparte de victorias, empates y derrotas.
Puntos por defecto
Las ligas nuevas usan 3 / 1 / 0 (el estándar FIFA desde 1994). Los tres valores se configuran ranking a ranking desde el panel: 2 / 1 / 0 para hockey, 4 / 2 / 0 para rugby o el reparto que mejor le venga a tu deporte.
Registrar un match
Desde la web, abre el ranking y pulsa Submit: indica los dos bandos y el marcador. En Discord, el botón Submit result del propio ranking abre lo mismo. Los matches de un jugador contra sí mismo y los marcadores negativos se rechazan al enviarlos.
Ligas por equipos
Un ranking League puede tener un tamaño de equipo fijo, de 2v2 hasta 8v8, al crearlo o después desde Match format en el panel. La tabla sigue siendo individual: cada jugador del bando ganador se lleva los puntos de victoria, todo el bando perdedor los de derrota, y el marcador cuenta como goles a favor y en contra para cada uno de ellos.
¿Prefieres una tabla de liga clásica en la que las filas sean los equipos? Activa Fixed teams junto a Match format: los equipos con nombre propio se inscriben con el botón Team sign-up del ranking (las plantillas admiten hasta dos reservas), los matches se registran equipo contra equipo con su marcador, y la tabla ordena a los equipos por puntos. La plantilla de cada equipo se ve en la página del ranking en la web: el número de miembros aparece junto al nombre del equipo, al pasar el ratón se listan los nombres, y al abrir el equipo se muestra la plantilla completa con el capitán marcado.
Revisar y anular
Los matches de League pasan por la misma cola de revisión que los de ELO: un validador aprueba o rechaza cada envío, los puntos se aplican al aprobarlo, y un match aprobado se puede anular después (se devuelven exactamente los puntos que se dieron).
Los rankings ELO y League no tienen por qué ser de dos bandos. En un todos contra todos cada participante juega por su cuenta — de 3 a 8 jugadores — y el resultado es la posición en la que terminó cada uno. Actívalo con la opción ffa_players al crear el ranking, o después en Match format dentro del panel. Sustituye a las partidas por equipos: un ranking todos contra todos no puede tener además un tamaño de equipo ni equipos fijos, y activarlo solo afecta a las partidas nuevas, así que todo lo ya registrado queda exactamente igual.
Los tipos de resultado
| Resultado | ELO | League |
|---|---|---|
| Orden completo de llegada — del 1.º al último | ✓ Sí | ✓ Sí |
| Empate para todos | ✓ Sí | ✓ Sí |
| Un ganador, el resto sin posición | — No disponible | ✓ Sí |
Solo-ganador es un modo de League. Ahí no necesita nada más de lo que dice: el ganador se lleva los puntos de victoria y el resto los de derrota. Un rating no puede permitirse esa relajación: si los perdedores quedan sin clasificar, lo único que puede decir honestamente de ellos es que empataron entre sí, y entonces un jugador con rating bajo gana rating en una partida que su historial cuenta como derrota. Por eso un todos contra todos de ELO pide el orden completo, o un empate general que haya ocurrido de verdad.
Reportar un resultado
Los rankings todos contra todos llevan un botón Report result en lugar de Submit result. Primero elige a todos los que jugaron — exactamente los que diga el tamaño del lobby del ranking, así que uno de 6 jugadores admite 6 y el formulario no se envía con 5. El mismo formulario puede llevar el resultado: indica al ganador y la partida queda reportada al momento; en un ranking con tabla de posiciones ese campo se amplía a todo el orden de llegada — primero el 1.º, luego el 2.º, y así. Si lo dejas vacío, aparece el paso del resultado. Después define el resultado: un ranking de League pregunta quién ganó, con Empate para todos en el mismo menú y Definir el orden completo si prefieres ordenar a todo el grupo; un ranking de ELO pide directamente el orden, una posición por toque, con Deshacer el último para el error y un botón Empate para todos al lado. Enviar sigue desactivado hasta que el resultado sea uno que el ranking pueda puntuar. Ese botón es la única forma de registrar un todos contra todos en Discord: si tu ranking no lo muestra, actívalo en el panel en Apariencia en Discord → Botón de envío, o registra la partida desde la página del ranking en la web.
A partir de ahí, un todos contra todos es un envío normal y corriente. Entra en la cola de revisión, un validador lo aprueba o lo rechaza (o lo hace la aprobación automática tras el retraso configurado), los ratings y los puntos se mueven al aprobarlo, y cancelar una partida aprobada devuelve a cada jugador exactamente lo que le dio.
Cómo funciona el rating
Un todos contra todos de ELO se puntúa como todos sus enfrentamientos directos a la vez. Cada pareja de jugadores se compara — la mejor posición gana a la peor, la misma posición es un empate entre ellos — y cada uno de esos mini-resultados se calcula con la misma matemática de puntuación esperada que un 1v1. Por eso terminar por encima de jugadores con un rating muy superior al tuyo paga mucho más que terminar por encima del fondo del grupo. Después el factor K se divide entre el número de rivales, que es lo que mantiene un todos contra todos en torno al movimiento de rating de una sola partida en lugar de los siete duelos que técnicamente jugaste.
Todo el conjunto es de suma cero exacta: lo que pierde el grupo es lo que ganan los demás, hasta el último punto. Seis jugadores con el mismo rating y K=32 terminan en +16, +10, +3, −3, −10, −16. El historial sigue a la posición: el primer puesto, incluido un empate por él, cuenta como victoria, todo lo que queda por debajo como derrota, y el empate general como empate para todo el grupo.
Puntos por posición en los rankings League
Un todos contra todos de League puede repartir entre todo el grupo con una tabla de puntos por posición, al estilo de la F1: tantos puntos para el primero, tantos para el segundo, y así hasta el final del lobby. La editas en el panel, debajo de los puntos de victoria, empate y derrota, en cualquier ranking League que juegue todos contra todos. Los jugadores que empatan reciben cada uno los puntos del puesto que comparten, y quien termina más allá del final de la tabla sigue puntuando con su última entrada.
La tabla solo se aplica a una clasificación completa. Si alguien queda sin posición — un reporte de solo-ganador, o un orden que dejaste a medias — no se aplica en absoluto: el primer puesto recibe los puntos de victoria del ranking y todos los demás los de derrota. Eso es también lo que obtienes sin ninguna tabla configurada, así que la tabla es opcional. Un empate general paga los puntos de empate a todos, diga lo que diga la tabla.
Todos contra todos en la cola de matchmaking
Con el botón de cola activado, un ranking todos contra todos pone en cola a jugadores individuales y salta en cuanto tiene exactamente el tamaño del lobby: seis jugadores en un ranking de 6, nunca cinco y nunca siete. No hay bandos que equilibrar, así que el lobby es sencillamente el grupo con los ratings más parecidos que la cola puede reunir. Todos tienen que pulsar Ready igualmente, y la partida recibe un único canal de voz compartido: en un todos contra todos no hay compañeros de quienes esconderse.
El resultado se reporta en vez de votarse — tres botones de voto no pueden expresar el orden de llegada de ocho jugadores. Cualquier jugador del lobby define el resultado en el mensaje de la partida y los demás pulsan Confirmar; queda fijado cuando una mayoría del grupo está de acuerdo (dos de tres, cinco de ocho), contando a quien lo reportó como el primero de ellos. Disputar entrega la partida a un validador, que define el resultado correcto y lo confirma él mismo. Una partida de la cola se resuelve en su propio hilo, así que no pasa por la cola de revisión.
El tipo de ranking Rating permite que los miembros de la comunidad suban imágenes y valoren con estrellas las de los demás.
Cómo funciona
- Los usuarios suben imágenes con el botón Submit image del ranking: el formulario pide un nombre, una descripción opcional y la propia imagen.
- Los envíos aparecen en el canal de logs con un desplegable para votar.
- Cualquiera puede puntuar de 1 a 10 estrellas. La media de los votos es la puntuación. Valora debajo de cada entrada o pulsa Rate entries en el ranking para recorrer, una a una, todas las entradas que aún no has valorado.
- El voto se puede cambiar en cualquier momento: un voto por persona y envío.
- El ranking ordena los envíos por valoración media.
Valorar desde la web
En la web, los envíos aparecen en la pestaña Entries. Haz clic en cualquiera para ver la imagen completa y votarla con los botones de estrellas. Tus votos se recuerdan de una sesión a otra.
Un ranking Levels (BETA) ordena a los miembros de tu servidor por XP. Nadie envía nada: los miembros ganan XP escribiendo en el chat y hablando en canales de voz, el bot lo cuenta solo, y el nivel de cada miembro sale de su XP. Un servidor tiene un solo ranking Levels (BETA) a la vez, y siempre es un ranking de servidor: un ranking personal no puede serlo.
Cómo se gana XP
- Mensajes: cada mensaje da entre 15 y 25 XP al azar, pero solo cuenta un mensaje por miembro cada 60 segundos. Diez mensajes rápidos seguidos dan lo mismo que uno.
- Voz: 10 XP por cada minuto en un canal de voz, siempre que el miembro no esté silenciado ni ensordecido, no esté en el canal AFK del servidor y haya al menos otra persona (que no sea un bot) en el canal.
- Los bots, los webhooks y los mensajes de sistema de Discord (entradas al servidor, mejoras, mensajes fijados) nunca dan XP, y los mensajes solo cuentan en canales que el bot puede ver.
Cada uno de estos números es un ajuste de la configuración Levels (BETA) del ranking, en el panel: el rango de XP por mensaje, la espera entre mensajes y la XP por minuto en voz (0 desactiva la XP de voz).
De la XP al nivel
El nivel de un miembro se calcula a partir de su XP cada vez que se muestra, así que nunca se guarda. La curva estándar es la que usan la mayoría de los bots de niveles de Discord: pasar del nivel L al siguiente cuesta 5L² + 50L + 100 XP. La curva lineal cuesta 100L + 75 XP por nivel, así que empieza algo más empinada y llega mucho antes a los niveles altos. La XP total necesaria para llegar a cada nivel:
| Nivel | Estándar | Lineal |
|---|---|---|
| 5 | 1150 | 1375 |
| 10 | 4675 | 5250 |
| 20 | 23.850 | 20.500 |
| 50 | 268.375 | 126.250 |
| 100 | 1.899.250 | 502.500 |
Cambiar de curva mantiene la XP de todos y solo cambia el nivel que le corresponde.
Canales y roles sin XP
Elige canales donde los mensajes y el tiempo en voz no dan nada (los hilos cuentan como parte de su canal) y roles cuyos miembros nunca ganan XP, por ejemplo un rol para miembros silenciados.
Mensajes de subida de nivel
Cuando un miembro llega a un nivel nuevo, el bot publica un mensaje que lo menciona. Por defecto va al canal donde el miembro acaba de escribir; puedes mandarlo a un canal fijo o desactivarlo. Puedes escribir tu propio texto, de hasta 200 caracteres, en el que se rellenan {user}, {level} y {board}. El mensaje solo menciona al miembro que llegó al nivel, aunque el texto diga @everyone, y cuando más de tres miembros llegan a un nivel nuevo en el mismo canal a la vez, comparten un mensaje. El bot necesita permiso para enviar mensajes en ese canal.
Roles por nivel
En un ranking Levels (BETA), los roles por tier tienen un cuarto modo, nivel: un rol desde el nivel 5, otro desde el nivel 10, y así sucesivamente. Con Mantener los roles de tier inferiores activado, los miembros conservan todos los roles que han alcanzado; si lo desactivas, solo conservan el más alto. Los roles cambian poco después de que un miembro llegue a un nivel nuevo.
Moneda por nivel
Si tu servidor usa la economía, puedes pagar moneda por los niveles: una cantidad fija cada vez que un miembro llega a un nivel nuevo, pagada una sola vez por nivel. Cuenta para el mismo tope diario que cualquier otro pago, y se aplica la misma regla de antigüedad de la cuenta. Los mensajes y los minutos en voz por sí solos no pagan moneda.
Temporadas
Al terminar una temporada, el ranking se congela: la XP deja de contar y la clasificación queda tal como acabó. Si lo descongelas, sigue con la misma XP. Para empezar de cero, crea un ranking Levels (BETA) nuevo y deja el congelado como registro: un ranking congelado no cuenta para el límite de uno por servidor.
Importar y fijar XP
¿Vienes de otro bot de niveles? Importa la XP desde un archivo CSV, un name,xp por línea, con Importar desde CSV en el panel, como se explica en Importar y migrar. Usa el id de usuario de Discord de cada miembro como nombre: así la fila queda vinculada al miembro, y la XP que gane después se suma a ella. Una fila con cualquier otro nombre se guarda como entrada personalizada a la que no se suma la actividad de nadie.
Para fijar la XP a mano, usa /score en Discord, o Set XP y Adjust XP en el menú de un jugador en la web. Una importación o un cambio a mano no publica ningún mensaje de subida de nivel ni paga recompensa por nivel; los roles por tier se ponen al día la próxima vez que se redibuja el ranking.
Pasarte desde MEE6 u otro bot de niveles
Scoreboards no importa desde MEE6 automáticamente: los términos de servicio de MEE6 no permiten el acceso automatizado a su servicio, así que el bot nunca lee el ranking de otro bot por ti. Lo que sí puedes hacer es traer tú mismo la XP de tus miembros — son los datos de tu propio servidor — con un archivo CSV:
- Copia la XP total de cada miembro del ranking de tu servidor en MEE6 o en el otro bot. Copia la XP, no el nivel: el nivel sale de la XP. Si MEE6 muestra una cifra redondeada como 12.5k, escribe el número completo (12500); la XP puede quedar ligeramente desviada.
- Copia el id de usuario de Discord de cada miembro: activa Developer Mode en Discord (Settings → Advanced), luego haz clic derecho sobre el miembro y elige Copy User ID.
- Escribe un
name,xppor línea, con el id de usuario como nombre y la XP solo con dígitos:12500, no12,500ni12.500. Una fila escrita así se omite y se muestra con su número de línea, para que la corrijas y vuelvas a importar. - En el panel, abre el ranking Levels (BETA) y usa Importar desde CSV. Cada fila reemplaza la XP del miembro en vez de sumarse, así que importa antes de que los miembros hayan ganado mucho aquí. Puedes volver a importar un archivo corregido cuando quieras, y un archivo admite hasta 500 filas.
name,xp 123456789012345678,4675 234567890123456789,23850
Solo un id de usuario vincula una fila a un miembro: un nombre de 17 a 20 dígitos se lee como id de usuario de Discord, y la XP que ese miembro gane después se le suma. Un nombre de usuario o cualquier otro nombre no se asocia a nadie; se guarda como entrada personalizada a la que no se suma la actividad de nadie.
La curva estándar es la que usa MEE6, así que la misma XP da el mismo nivel: 4.675 XP son el nivel 10 en los dos. La importación no publica mensajes de subida de nivel ni paga recompensas por nivel. Los roles de recompensa no se traspasan: vuelve a configurarlos como roles por tier en modo nivel, y los miembros los recibirán la próxima vez que el ranking se redibuje. Después, desactiva los niveles en el otro bot para que nadie reciba dos mensajes de subida de nivel.
Cada cuánto se actualiza el ranking
El mensaje del ranking en Discord se redibuja cuando alguien llega a un nivel nuevo o cambia el orden de los puestos que muestra, como mucho una vez por minuto, y si no, más o menos cada 15 minutos mientras los miembros ganan XP. Un ranking en el que nadie está activo no se redibuja. La línea Actualizado de debajo indica cuándo se dibujó. Mi puesto y el ranking de la web muestran la XP en segundos.
Privacidad
El bot nunca lee lo que escriben los miembros. No usa el intent Message Content de Discord, y nunca lee ni guarda el texto de un mensaje. Por cada miembro que gana XP guarda su ID de Discord y su nombre visible, la XP total, cuántos de sus mensajes dieron XP, cuántos minutos en voz dieron XP y cuándo ganó XP por última vez, más una instantánea nocturna de su puesto para el gráfico del historial de puestos. No se guarda nada por mensaje. Los datos se borran con el ranking, y con el resto de los datos del servidor cuando se quita el bot. Si la economía del servidor paga moneda por niveles, cada nivel alcanzado añade también una entrada al registro de moneda del miembro, que se conserva con el resto de sus datos de moneda. La Política de privacidad tiene los detalles.
Tú decides quién ve tus rankings en la web de Scoreboards:
Lo ve todo el mundo en la web.
Solo lo ven los miembros de tu server de Discord (hay que iniciar sesión), y en la lista de rankings solo lo ven los admins del server.
Solo lo ven quienes tengan un rol concreto de Discord y los admins del server.
No aparece en la web.
Reparte roles de Discord automáticamente según la posición de cada jugador en el ranking. Por ejemplo: un rol «Campeón» para el top 3, un «Veterano» del puesto 4 al 10, y así con los que quieras.
- Los tiers se configuran desde el panel web, en los ajustes de cada ranking.
- Elige cómo se define un tier: por puesto (del 1 al 3), por percentil (el 10 % de arriba) o por puntuación (todo el que pase de 2000 puntos). Un ranking Levels (BETA) también puede usar nivel (todos los que estén en el nivel 10 o más). Todos los tiers de un ranking comparten el mismo modo.
- A cada tier le asignas cualquier rol que ya exista en tu server.
- Los roles se dan y se quitan solos a medida que cambia la clasificación.
- El rol de Scoreboards tiene que estar por encima de todos los roles que reparte, en Server Settings → Roles. Discord no deja que un bot gestione roles que estén a su altura o por encima, y si se topa con eso, el bot avisa en el canal del ranking.
¿Ya tienes una competición en marcha en otro sitio? Un archivo CSV puede rellenar un ranking entero de una vez, así no tienes que teclear nada otra vez.
Abre el panel, selecciona un ranking y usa Importar desde CSV. Es la misma vía para un ranking de server y para uno personal, que no tiene server de Discord detrás. En ambos casos el archivo es el mismo: un name,score por línea:
name,score Alex,120 "Cooney, EM",95 Sam,88
- Si hay fila de encabezado, se detecta y se salta sola.
- Valen comas, puntos y comas o tabuladores como separador: lo que exporte tu hoja de cálculo.
- Los nombres con coma funcionan si van entre comillas, como
"Cooney, EM". - Si un nombre es un id de usuario de Discord, esa entrada se vincula al miembro y muestra su nombre. Cualquier otra cosa se guarda como entrada personalizada.
- Si un nombre sale dos veces, se queda el último valor, así que puedes volver a importar un archivo corregido.
- Las filas que no se entienden se saltan y se listan por número de línea: el resto entra igual, así que arreglas un par de líneas y lo lanzas otra vez.
Los tiempos admiten mm:ss, hh:mm:ss y una fracción opcional: 1:30, 1:12:44.081. Un número a secas se lee como milisegundos. Ojo: tres números separados por dos puntos significan hours:minutes:seconds, así que la precisión por debajo del segundo va detrás de un punto.
Los rankings Levels (BETA) usan name,xp con el ID de usuario de Discord de cada miembro como nombre: un nombre de usuario se convierte en una entrada aparte que nunca gana XP. El número es la XP total del miembro y sustituye la XP que tenía. Una importación no publica mensajes de subida de nivel ni paga recompensas por nivel.
Límites: 500 filas y 100 KB por archivo; si tu exportación es más grande, pártela e impórtala por partes. Los rankings Image Rating no se pueden importar, porque sus entradas son imágenes subidas, no puntuaciones.
Las temporadas te permiten cerrar una competición sin perder nada. Programa un final (o termínala desde el panel) y el ranking se congela: se publica un podio y la clasificación queda exactamente como acabó.
- Nada se reinicia ni se borra — el ranking congelado es el registro permanente de la temporada, visible para todos.
- Un ranking congelado no acepta envíos, partidas ni votos nuevos; un admin puede descongelarlo en cualquier momento.
- Todos los tipos pueden tener temporadas — incluido Image Rating, donde congelar un ranking con votación a ciegas también revela los resultados.
- ¿Quieres una temporada nueva? Crea un ranking nuevo y deja el congelado como registro.
Los resúmenes semanales publican cada lunes un repaso corto en el canal del ranking: el top 3, quien más ha subido esa semana y cuánto se ha jugado. Solo lo reciben los rankings con al menos tres puntuaciones en los últimos siete días, así que un ranking tranquilo se queda tranquilo. Puedes desactivarlos ranking a ranking desde el panel web.
Una economía convierte los resultados en una moneda que los miembros gastan en la tienda del servidor. Es una beta y está desactivada hasta que un admin la configura y la lanza desde el panel, en Economía; a partir de ahí, cada resultado que apruebe tu servidor paga a los jugadores. Un pago es una base fija más una parte de un bote variable: una parte del bote sigue al resultado y otra a la sorpresa, así que ganar a alguien muy por encima de ti vale más que ganar a alguien por debajo. En un board Classic, Highscore o Time no hay rival, así que ese papel lo hace tu puesto en la clasificación. Es un saldo por miembro para todo el servidor, compartido por todos sus leaderboards.
- Una racha de victorias suma un 2 % por victoria, hasta el tope que pongas.
- Enfrentarse al mismo rival una y otra vez paga menos dentro de una semana móvil: las dos primeras partidas pagan completo, y cada una a partir de ahí paga menos, hasta quedarse en una décima parte.
- Un tope diario limita lo que un miembro se lleva en un día y, por defecto, una cuenta de Discord tiene que tener 7 días de antigüedad antes de ganar nada.
- Cancelar, editar o borrar un resultado devuelve el pago, exactamente como se pagó; si la moneda ya se había gastado, el saldo puede quedar en negativo. Cada línea se ve en la página de la tienda del servidor.
- Los boards de Image Rating no pagan nada: no hay resultado que valorar.
- Los rankings Levels (BETA) pagan por nivel: una cantidad fija cada vez que un miembro llega a un nivel nuevo, fijada en la configuración Levels (BETA) del ranking y contada dentro del tope diario.
Los miembros la gastan en la página de la tienda del servidor. La página es para los miembros del servidor: inician sesión con Discord para ver su saldo, comprar, elegir qué llevar y desplegar cualquier pago para ver exactamente cómo se calculó. El botón Shop bajo un leaderboard en Discord los lleva directamente allí. Al lanzar la economía puedes ponerlo bajo todos los leaderboards a la vez, y cada leaderboard tiene su propio interruptor en Discord → Identidad visual.
Esa página está en scoreboards.dev/shop/tu-servidor, una por servidor, y las páginas de leaderboards del servidor también enlazan a ella. Vende tres tipos de producto. Los roles de Discord se otorgan en el momento de la compra, para siempre o, con el alquiler activado, durante un tiempo fijo, tras el cual el rol se retira y el miembro puede volver a comprarlo. Scoreboards tiene que estar por encima de cada rol que vende en Ajustes del servidor → Roles, y el panel atenúa un rol que no puede otorgar y explica por qué. Los emojis de leaderboard aparecen junto al nombre del comprador en los leaderboards del servidor, en la web y en Discord. Un emoji comprado ocupa el lugar de una medalla, también en el top 3, y si las medallas de un board están desactivadas, se sigue mostrando mientras la economía esté activada. Los nombres en sí se muestran sin emojis en los boards, así que un emoji comprado no se puede falsificar cambiándose el nombre. Los colores de nombre pintan el nombre del comprador en la web y en los leaderboards en imagen de Discord, pero no en los boards publicados como embed de texto. En cuanto alguien compra o equipa algo, los leaderboards de Discord en los que aparece se vuelven a dibujar para mostrarlo.
Un servidor puede tener temporadas de moneda, separadas de las temporadas de sus leaderboards. Cuando una termina — según la duración fijada en el dashboard, o cuando un admin la termina allí — la siguiente empieza enseguida, y con la reducción a la mitad activada, cada saldo de 2 o más se reduce a la mitad antes. Los roles y objetos comprados se conservan. Los miembros ven la fecha de fin en la página de la tienda con antelación, y el final se publica en el canal de logs.
Con el prestigio activado, un miembro cuyo saldo alcance el mínimo que fijó el admin puede quemarlo entero en la página de la tienda por el siguiente nivel de prestigio. El nivel de prestigio aparece como una estrella y un número junto a su nombre en el leaderboard de la web y en la tarjeta de Discord, sobrevive a cada fin de temporada y se anuncia en el canal de logs.
Con el catálogo rotativo activado, cualquier objeto de la tienda puede tener fecha de inicio y de fin, que se fijan al añadir o editar el producto. Antes del inicio la página de la tienda lo muestra como próximo; al llegar el fin sale del escaparate y ya no se puede comprar.
Con las subastas activadas, un admin pone un rol o un cosmético en subasta desde el dashboard y los miembros pujan en la página de la tienda. Una puja se cobra al hacerla y se devuelve en cuanto alguien puja más, y una puja en los últimos cinco minutos retrasa el cierre. Al cerrar, la puja ganadora se destruye, se entrega el premio y el resultado se publica en el canal de logs.
Configurarla lleva cuatro pasos en el panel, en Economía, en el modo Sencillo: ponle nombre a la moneda; elige cómo ganan los miembros entre tres ritmos, cada uno con lo que gana más o menos un miembro activo en una semana; llena la tienda, con un paquete inicial de un clic de seis colores de nombre y seis emojis de leaderboard con precios según ese ritmo (este paso se puede omitir); y lánzala, marcando la casilla de la beta y con un botón Shop bajo cada leaderboard ya marcado por defecto. Los productos se añaden y se editan en Economía → Tienda, en un formulario corto de tres pasos con precios sugeridos y una vista previa. El modo Avanzado añade los valores de pago, quién gana, el canal de logs, las temporadas, los alquileres, el prestigio, el catálogo rotativo y las subastas. Los admins dan y quitan moneda desde la web: en el menú contextual de un jugador en un ranking, o en Economía → Miembros si el miembro no está en ningún board; ambas cosas se anuncian en el canal de logs que elijas, así nadie tiene que fiarse de la palabra de un moderador. La moneda no es dinero: no tiene valor real, no sale del servidor en el que se ganó y se puede reiniciar en cualquier momento.