Scoreboards Documentation

Everything you need to create and manage Discord leaderboards

  1. Añade el bot — Invita a Scoreboards a tu server de Discord con el enlace de invitación de la página principal.
  2. 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.
  3. Asigna los roles — Abre el panel para definir el rol bot permission (quién puede gestionar rankings) y el rol validator (quién puede aprobar envíos).
  4. Añade más rankings — Vuelve a usar /leaderboard create para 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.
  5. Publícalo — Usa /leaderboard show en un canal para colocar el ranking interactivo, con botones de envío y paginación. Un ranking creado en la web también se puede publicar desde el panel: elige su canal del ranking en sus ajustes de Discord, y el bot lo publica allí.

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 Private 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, publica en el canal del ranking un breve aviso que indica el permiso que falta, con un enlace para revisar el envío en el panel.

En todo el servidor

  • Manage Roles — para los Tier Roles, los roles que se venden en la tienda, los roles de rango automáticos de los rankings ELO y el rol de aviso de la cola. 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 Servidor → Identidad del bot.
  • 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, Create Private Threads, Manage Threads, Manage Roles 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

ComandoDescripciónPermiso
/leaderboard createCrea 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 partidaAdmin / Bot Permission
/leaderboard showMuestra el ranking en el canal actual, con botones interactivosAdmin / Bot Permission
/dashboardAbre el panel: la vista general del servidor o, con la opción leaderboard, directamente los ajustes de ese ranking (orden, visibilidad, encabezados, modo de vista, configuración de ELO y más)Admin / Bot Permission
/leaderboard deleteBorra un ranking y todos sus datos para siempre (pide confirmación)Admin / Bot Permission

Envíos de puntuaciones y matches

ComandoDescripciónPermiso
/scoreEstablece 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

ComandoDescripciónPermiso
/helpConsulta la ayuda interactiva con todos los temas disponiblesTodos
/feedbackEnvíanos comentarios con tus propias palabras: ideas, problemas, lo que seaTodos
/delete_my_dataBorra de forma permanente tus rankings personales y puntuaciones, y tus datos de moneda en todos los servidores (requiere confirmación)Todos
/uninstallQuita el bot del servidor. Un formulario pregunta por qué no funcionó (opcional); después se borran todos los rankings y puntuaciones del servidorAdmin

Torneos (Beta)

ComandoDescripciónPermiso
/tournament createCrea un torneo con un formulario corto, publicado en este canalAdmin / Bot Permission
/tournament showMuestra un torneo en este canal: la inscripción o el cuadroTodos
/dashboard tournament:Abre el torneo en el panel: abrir la inscripción, empezar ya, cancelar y todos los ajustesAdmin / Bot Permission / rol organizador

Economía

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, colores de nombre, anillos de posición y estilos de fila, 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

  1. El envío se publica en el canal de logs configurado (si lo hay).
  2. Un validador o administrador pulsa Approve o Reject. En los partidos de ELO y League primero se pregunta al rival: consulta Confirmación del rival más abajo. Cualquier otro ranking sin canal de logs aprueba los envíos al instante; configura un canal de logs para revisarlos antes.
  3. Si se rechaza, quien lo envió recibe un DM con el motivo.
  4. Si se aprueba, el ranking se actualiza al instante.

Confirmación del rival (ELO y League)

Cuando se reporta un partido en un ranking de ELO o League de un servidor, el bot abre un hilo privado del partido con quien lo reportó y el rival, y menciona allí al rival con los botones Confirmar y No estoy de acuerdo: a todos los que no están en el lado de quien lo reportó, o, si lo reportó alguien que no jugó, al lado que perdió (a ambos lados si fue empate). Un compañero de equipo no puede confirmar el resultado de su propio equipo, y quien lo reportó o el staff pueden Retirarlo. Si nadie responde, el partido cuenta solo cuando vence el plazo: 3 horas en los rankings nuevos. El formulario de reporte ya trae a quien reporta como jugador 1.

No estoy de acuerdo envía el partido al staff: un administrador, cualquiera con Manage Server, el rol de validador o el rol de permiso del bot. Todo sigue en el mismo hilo: se añade y se menciona al rol de validador o, si el servidor no tiene, decide un administrador. Si nadie decide en 48 horas, se rechaza. Los partidos de los rankings personales de la web siguen contando al momento.

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 ELO y League es el tiempo que tiene el rival para confirmar o mostrar su desacuerdo. Los rankings nuevos de ELO y League empiezan con 3 horas; los anteriores conservan su ajuste. En un ranking de ELO o League sin canal de logs, desactivada también significa 3 horas, porque no hay canal de staff desde el que aprobar.

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 mueven con un factor K configurable (32 por defecto).
  • El rating de todos los participantes se actualiza a la vez en cuanto el partido cuenta.

Todo lo que hace un ranking ELO

  • Una cola de matchmaking con ready-check, un hilo privado por partido y un botón Join Voice.
  • Confirmación del rival: el otro lado confirma o muestra su desacuerdo, y el partido cuenta solo a las 3 horas.
  • Reta directamente a un jugador, con un botón de revancha en el hilo del partido después de cada 1v1.
  • Equipos de 2v2 a 8v8, equipos fijos y todos contra todos de 3 a 8 jugadores con posiciones.
  • Factor K y rating inicial configurables, decay opcional y temporadas.
  • Roles de rango automáticos de Bronce a Diamante, y cada ascenso se avisa al jugador por DM.
  • Una línea de resultado en el hilo del partido tras cada partido, con el cambio de rating y el nuevo puesto.
  • Un panel web y una página por ranking con estadísticas de cada jugador e historial de posiciones.
  • Torneos cuyos partidos cuentan en el ranking.

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 cola está activado en el ranking, los jugadores pueden pulsarlo para entrar en la cola de matchmaking. El sistema agrupa a jugadores con un ELO parecido mediante una ventana de búsqueda que se va ampliando. Cuando hay emparejamiento, todos pulsan Ready y el partido recibe su propio hilo con botones de votación. Si no se encuentra partido en 5 minutos, la entrada en la cola caduca. La votación se cierra a las 3 horas y el partido se resuelve con los votos emitidos: la respuesta de un lado o el resultado más votado. Un empate pasa al staff, que tiene 48 horas antes de que el partido se cancele, y un partido sin votos se cancela. No puedes volver a la cola hasta que hayas votado tu último partido.

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 administrador o un validador.

El botón de cola muestra cuántos jugadores esperan, por ejemplo Queue · 2. Pulsa 🔔 Avísame cuando alguien entre en la cola en el mensaje de la cola para recibir el rol de aviso del ranking: el bot lo menciona cuando alguien entra en una cola vacía, como mucho cada 15 minutos. Vuelve a pulsarlo para dejar de recibir avisos.

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.

Retos y revancha

En un ranking 1v1 de ELO o League con la cola activada, el botón Challenge te deja elegir a un jugador. Recibe el reto por DM con Aceptar y Rechazar, y caduca a los 30 minutos; si tiene los DM cerrados, solo te avisamos a ti. Un reto aceptado se convierte en un hilo de partido exactamente igual que uno de la cola. Cuando se resuelve un partido 1v1, su hilo recibe un botón Rematch que envía el mismo reto otra vez.

Roles de rango

Un ranking ELO nuevo crea cinco roles de rango en su primer partido aprobado (Bronce, Plata, Oro, Platino y Diamante) si el bot tiene Manage Roles. Con el inicio por defecto de 1200, los tramos son: Bronce por debajo de 1100, Plata 1100–1199, Oro 1200–1299, Platino 1300–1399 y Diamante desde 1400; se desplazan con el rating inicial del ranking. Cada ascenso se le avisa al jugador por DM. Edita los roles como cualquier tier role en el panel; borrar el ranking con /leaderboard delete también los borra.

Línea de resultado

Cuando cuenta un partido reportado, de la cola o de un reto, el bot publica una línea en el hilo del partido, como «✅ A venció a B · A 1216 (+16) · ahora #3 (↑2) · B 1184 (−16)». No se menciona a nadie. En un partido reportado, el aviso de confirmación se convierte en esa línea, y en un 1v1 de la cola o de un reto el botón Rematch queda debajo. Un partido registrado al instante, sin paso de confirmación, no recibe línea. Desactívala con Línea de resultado tras cada partida en el panel.

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 partidos de League siguen el mismo proceso que los de ELO: el rival confirma o muestra su desacuerdo en un hilo privado del partido, el partido cuenta solo al vencer su plazo (3 horas en los rankings nuevos), el staff decide los desacuerdos, los puntos se aplican cuando cuenta, y los partidos aprobados se pueden anular más tarde (lo que revierte exactamente los puntos otorgados).

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

ResultadoELOLeague
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, activa Botón de envío en la pestaña Discord del ranking, en el panel, o registra la partida desde la página del ranking en la web.

A partir de ahí, un todos contra todos es un partido reportado como cualquier otro. Se pide a los demás jugadores que confirmen o muestren su desacuerdo en un hilo privado del partido, cuenta solo al vencer su plazo (o cuando el staff lo aprueba), los ratings y los puntos se mueven cuando cuenta, 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 administrador o un validador, que define el resultado correcto y lo confirma él mismo. A las 3 horas, un resultado reportado queda fijado, y una partida sin nada reportado se cancela. 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, o solo quien tenga un rol, como un jurado, si el panel limita la votación a ese rol; el envío se puede limitar a un rol de la misma forma. 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, el ranking muestra las entradas como una galería de sus imágenes, cada una con su puesto, su media, sus votos, quién la subió y tu propio voto; las imágenes las ven los miembros del servidor que han iniciado sesión. El interruptor junto al buscador (en el móvil, junto al título) convierte la galería en una lista, y la web recuerda tu elección. Haz clic en cualquier entrada para abrir su imagen con su media, el número de votos, el puesto, quién la subió y cuándo, y puntuarla con los botones de estrellas; las flechas recorren las entradas en el orden del ranking. Tus votos se recuerdan de una sesión a otra. La Recent Activity del ranking muestra las nuevas entradas y los votos. Por defecto, un voto aparece sin el nombre de quien vota ("Someone rated Sunset 8/10"); con Votos anónimos desactivado en el panel, los votos emitidos a partir de entonces muestran el nombre de quien vota, y se avisa antes de votar. En un ranking con voto ciego, la puntuación nunca se muestra.

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:

NivelEstándarLineal
511501375
1046755250
2023.85020.500
50268.375126.250
1001.899.250502.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:

  1. 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.
  2. 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.
  3. Escribe un name,xp por línea, con el id de usuario como nombre y la XP solo con dígitos: 12500, no 12,500 ni 12.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.
  4. 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:

Público

Lo ve todo el mundo en la web.

Oculto

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.

Privado

Solo lo ven quienes tengan un rol concreto de Discord y los admins del server.

Desactivado

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 cada 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). Cada tier tiene su propio modo, así que un mismo ranking puede combinarlos.
  • 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 bot los cambia poco a poco, al ritmo que Discord permite, así que en un servidor grande un cambio puede tardar unos minutos en llegar a todos.
  • 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. 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 su pestaña Discord del panel.

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 cinco 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. 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. Los anillos de posición — dieciséis diseños, del fuego a la galaxia — se dibujan alrededor del número de posición del comprador, y los estilos de fila, que el admin diseña con un color, un borde y un relleno, van detrás de toda la fila del comprador; ambos se ven donde se ven los colores de nombre. Un miembro puede llevar a la vez un emoji, un color, un anillo y un estilo de fila. Otros cuatro anillos son de temporada: calabazas para Halloween, escarcha para Navidad, confeti para Año Nuevo y huevos para Pascua. Un admin puede ponerlos en la tienda cuando quiera, pero los miembros solo pueden comprarlos en su fiesta (según la fecha UTC, el mismo día en todas partes); el resto del año la tienda los muestra como limitados, y quien compró uno lo sigue llevando todo el año. 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, 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 → Saldos 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.

Un espacio personal también puede tener economía. Sus miembros ganan con sus resultados y con los premios de torneos, y lo gastan en la página de la tienda del espacio — solo en colores de nombre, emojis de tabla, anillos de posición y estilos de fila, porque un espacio no tiene roles de Discord. Los invitados añadidos por nombre no tienen cartera. Sirve cualquier inicio de sesión, y quien entra con Discord y con Google es una sola cuenta en cuanto conecta los dos en Cuenta.

Un torneo lleva un cuadro completo en tu servidor: eliminación directa (con byes y partido por el tercer puesto opcional), grupos + eliminación o doble eliminación con gran final y reinicio del cuadro opcional, para jugadores o equipos. El bot publica un mensaje por torneo en su canal, con los botones de inscripción y check-in, y el cuadro en vivo tiene su propia página en la web.

  • La inscripción es por orden de llegada con un límite y lista de espera, o automática: el cuadro se ajusta a quienes se inscribieron al cerrar la inscripción. Un check-in opcional deja fuera al empezar a quien no lo haya hecho.
  • Cada partido tiene un hilo privado en cuanto se conocen los dos lados. Ambos lados reportan el resultado; si no coinciden, se avisa a los organizadores y ellos deciden. Los organizadores pueden decidir cualquier partido en cualquier momento, desde el hilo, el panel o /tournament report.
  • Los partidos tienen un plazo. Un partido sin jugar se resuelve con la regla del torneo: vale un único reporte, avanza el mejor cabeza de serie, o quedan fuera los dos lados.
  • Opcionalmente, vincula un ranking para sembrar según sus ratings y que los partidos cuenten en él, y —con la economía activada— paga moneda por partido ganado (más cada ronda) y por puestos finales, fuera del límite diario.
  • Los jugadores también pueden reportar en la página del torneo en la web: eliges el resultado y el otro lado lo confirma o lo disputa allí o en el hilo. Es el mismo reporte en los dos sitios.

Los torneos también funcionan en un espacio personal, sin Discord. Los miembros entran con un enlace y se inscriben con cualquier inicio de sesión, Discord o Google. El organizador puede añadir invitados por nombre para quien nunca inicia sesión, y decide sus partidas. No hay canales, hilos ni roles: todo pasa en la web, y organizan el dueño y los admins del espacio.

Configura uno en el panel, en Torneos (Beta), o crea un borrador rápido con /tournament create en Discord.