Scoreboards Documentation

Scoreboards braucht nur eine Handvoll Discord-Berechtigungen, und ein Server mit Standardeinstellungen hat sie bereits vergeben. Die entscheidenden gelten pro Kanal — ein Bot kann in einem Kanal erlaubt und im nächsten ausgesperrt sein —, also ist das hier der erste Blick, wenn ein Leaderboard nicht mehr aktualisiert.

Im Leaderboard-Kanal

• View Channel und Read Message History — um die eigene Leaderboard-Nachricht zu finden und zu bearbeiten. Ohne sie aktualisiert sich das Board nur, wenn jemand /leaderboard show ausführt: Ein Slash-Befehl wird auch dort beantwortet, wo der Bot nicht lesen darf, eine Bearbeitung nicht.
• Send Messages — um das Leaderboard zu posten und Bescheid zu geben, wenn etwas nicht stimmt.
• Embed Links und Attach Files — das Leaderboard ist ein Bild mit einer Bildunterschrift. Ohne Attach Files fällt das Bild weg, ohne Embed Links die Unterschrift und die Ersatztabelle.
• Create Public Threads und Send Messages in Threads — Match-Threads auf ELO- und League-Leaderboards werden hier geöffnet.

Im Log-Kanal

Dasselbe Set. Einreichungen werden dort zur Prüfung gepostet, und der Bot bearbeitet sie, wenn sie angenommen oder abgelehnt werden; Bildeinträge sind Anhänge. Kann der Leaderboard-Kanal keinen Match-Thread aufnehmen, wird er stattdessen hier geöffnet. Kann der Bot nicht im Log-Kanal schreiben, wird die Prüfanfrage stattdessen im Kanal des Leaderboards gepostet, mit der fehlenden Berechtigung.

Serverweit

• Manage Roles — für Tier Roles und im Shop verkaufte Rollen. Die Scoreboards-Rolle muss außerdem in Server Settings → Roles über jeder Rolle stehen, die sie vergibt.
• Change Nickname — nur, wenn du den Bot unter Branding umbenennst.
• Manage Channels, Connect und Move Members — nur für Matchmaking-Sprachkanäle, und nur in der Kategorie, in der der Log-Kanal liegt.

Der Add to Discord-Link fragt nach View Channel, Send Messages, Embed Links, Attach Files, Read Message History und Send Messages in Threads. Alles andere kommt aus den @everyone-Standards deines Servers oder aus Rollen, die du dem Bot gibst — ein Server, der @everyone eingeschränkt hat, muss dem Bot diese Berechtigungen also selbst geben, pro Kanal oder auf seiner Rolle.

Fehlt eine Berechtigung, sagt der Bot es, statt still zu scheitern: eine Nachricht im Leaderboard-Kanal bei Embed Links, Attach Files und einer Tier-Rolle, die er nicht vergeben kann, und eine im Log-Kanal, wenn er das Leaderboard gar nicht erreicht.

Es gibt zwei Wege:

• Klick in Discord auf den Submit-Button an der geposteten Leaderboard-Nachricht — auf Classic/Highscore/Time heißt er Submit score, auf ELO und League Submit result, auf Rating Submit image. Der Bot öffnet den Ablauf, der zum Typ passt: ein Score-Feld, Spieler- und Siegerauswahl, Spieler- und Score-Auswahl oder ein Name samt dem Bild selbst. Auf einem Team-Leaderboard wählst du statt eines einzelnen Spielers eine komplette Aufstellung für jede Seite, und ein Free-for-all-Leaderboard trägt stattdessen einen Report result-Button.
• Oder öffne das Leaderboard auf der Website und klick auf Submit — derselbe Ablauf, und der einzige Weg, der einen frei gewählten Namen annimmt, für Spieler ohne Discord.

Der Weg durch die Prüfung

1. Die Einreichung wird im eingestellten Log-Kanal gepostet (sofern einer gesetzt ist).
2. Ein Validator oder Admin klickt Approve oder Reject. Bei einem ELO- oder League-Match können auch die beteiligten Spieler bestätigen — dass der Gegner das Ergebnis bestätigt, reicht aus, ein Server braucht also keine Validator-Rolle, damit Matches durchlaufen. Wer das Match gemeldet hat, kann die eigene Meldung nicht bestätigen, und nur diese Person kann sie ablehnen. Hat ein Leaderboard keinen Log-Kanal, werden Einträge sofort freigegeben; setz einen Log-Kanal, um sie vorher zu prüfen.
3. Bei einer Ablehnung bekommt die einreichende Person eine DM mit der Begründung.
4. Bei einer Freigabe aktualisiert sich das Leaderboard sofort.

Automatische Freigabe

Jedes Leaderboard kann Einreichungen nach einer eingestellten Wartezeit von selbst freigeben: Off, Instant, 1 hour, 3 hours, 24 hours, 3 days oder 7 days. Bei ELO-Leaderboards sind 24 Stunden voreingestellt.

Einen Score zurücknehmen

Admins und Validatoren können einen bereits freigegebenen Score rückgängig machen: Rechtsklick auf die Nachricht mit der Einreichung, dann "Cancel Review" wählen. Damit wird die Score-Änderung zurückgedreht, und du musst eine Begründung angeben.

Der Leaderboard-Typ ELO - Ranked sortiert die Spieler nach einem ELO-Rating — entweder 1v1 oder in Teams mit bis zu acht Spielern pro Seite.

Team-Matches (2v2 – 8v8)

ELO- und League-Leaderboards lassen sich auf eine feste Teamgröße festlegen — such sie beim Erstellen aus oder änder sie später unter Match format im Dashboard. Auf einem 3v3-Leaderboard stehen dann in jedem Match drei Spieler pro Seite, und das Leaderboard wertet die Spieler trotzdem einzeln.

Bei ELO ergibt sich das erwartete Ergebnis eines Teams aus dessen durchschnittlichem Rating, und die daraus folgende Änderung bekommt jedes Mitglied dieses Teams — schlagt ihr ein stärkeres Team, kassiert jeder auf der Siegerseite denselben Zuwachs. Bei League bekommt jeder im Siegerteam die Siegpunkte, und das ganze Verliererteam bekommt die Niederlagenpunkte.

Matchmaking-Queue (Beta)

Ist der Queue-Button am Leaderboard aktiviert, klicken sich Spieler damit in die Matchmaking-Queue. Das System bringt Spieler mit ähnlichem ELO zusammen und weitet das Suchfenster dabei Schritt für Schritt aus. Kommt ein Match zustande, entsteht dafür ein Thread mit Abstimmungsbuttons für die Community. Findet sich innerhalb von 5 Minuten kein Match, verfällt der Platz in der Queue.

Auf einem Team-Leaderboard wartet die Queue, bis genug Spieler für beide Seiten da sind — sechs für ein 3v3 — und teilt sie dann in zwei Teams mit möglichst gleichem Durchschnitts-Rating, sodass die Stärksten und die Schwächsten auf verschiedenen Seiten landen. Alle müssen auf Ready klicken; wer das nicht tut, fliegt raus, und alle anderen kommen mit ihrem Platz zurück in die Queue.

Jedes Team bekommt seinen eigenen Sprachkanal, damit ihr Taktik besprechen könnt, ohne dass die Gegenseite mithört — du siehst nur den Kanal deines eigenen Teams und kommst auch nur da rein. Beide Kanäle verschwinden, sobald das Match abgeschlossen ist. Ein Ergebnis steht erst fest, wenn in beiden Teams eine Mehrheit dafür stimmt (zwei von drei bei 3v3) — ein Team kann sich also nie selbst zum Sieger erklären. Alles andere wird zum Streitfall, den ein Validator entscheidet.

Die Queue gibt es nicht mehr nur bei ELO: Auch eine League-Bestenliste kann sie aktivieren. Da League-Punkte eine laufende Summe sind und kein Könnensmaß, matchen League-Boards nach Punkten pro Spiel — mehr zu spielen allein bringt dich in der Queue also nicht weiter.

Feste Teams

Ein ELO- oder League-Leaderboard mit fester Teamgröße kann auch im Modus fixed teams laufen (im Dashboard direkt neben Match format). Feste Teams mit Namen melden sich einmalig über den Team sign-up-Button am Leaderboard an — Namen wählen, dann den Kader aufstellen, der bis zu zwei Reservisten über die Teamgröße hinaus fassen darf. Danach werden die Teams selbst gewertet: Auf einem ELO-Board hat jedes Team sein eigenes Rating, und ein stärkeres Team zu schlagen zahlt sich mehr aus; auf einem League-Board sortiert die Tabelle die Teams nach Punkten, genau wie in einer echten Sportliga. Feste Teams in League tragen ihre Matches über den Submit result-Button am Leaderboard ein.

Klickt ein einziges Mitglied auf Queue, steht das ganze Team in der Warteschlange, und alle bekommen eine DM. Gematcht wird Team gegen Team nach Team-Rating, und der Ready-Check ist gleichzeitig die Aufstellung: Es spielen die Mitglieder jedes Kaders, die zuerst auf Ready klicken — so viele, wie die Teamgröße vorgibt; der Rest sitzt dieses Match aus. Über das Ergebnis stimmen die ab, die gespielt haben, nach derselben Mehrheitsregel auf beiden Seiten. Die Aufstellung jedes Teams ist auf der Leaderboard-Seite der Website zu sehen: Die Mitgliederzahl steht neben dem Teamnamen, beim Darüberfahren erscheinen die Namen, und wer das Team öffnet, sieht die volle Aufstellung mit markiertem Kapitän.

Der Leaderboard-Typ League sortiert die Spieler nach Punkten, die sie über mehrere Matches sammeln. Das ist das Format für Fußball, Basketball, Futsal, Hockey und jeden 1v1- oder Team-Wettbewerb, bei dem am Ende die Tabelle zählt.

Standardpunkte

Neue Ligen starten mit 3 / 1 / 0 (FIFA-Standard seit 1994). Alle drei Werte lassen sich pro Leaderboard im Dashboard ändern. Nimm 2 / 1 / 0 für Hockey, 4 / 2 / 0 für Rugby — oder ein eigenes System, das zu deinem Sport passt.

Ein Match eintragen

Öffne auf der Website das Leaderboard und klick auf Submit — beide Seiten eintragen, Ergebnis dazu. In Discord öffnet der Submit result-Button am Leaderboard genau dasselbe. Matches, bei denen derselbe Spieler auf beiden Seiten steht, und negative Ergebnisse werden schon beim Einreichen abgelehnt.

Team-Ligen

Ein League-Leaderboard lässt sich auf eine feste Teamgröße von 2v2 bis 8v8 festlegen — beim Erstellen oder später unter Match format im Dashboard. Die Tabelle wertet trotzdem die Spieler einzeln: Jeder auf der Siegerseite bekommt die Siegpunkte, die ganze Verliererseite bekommt die Niederlagenpunkte, und das Matchergebnis zählt für jeden von ihnen als erzielte und kassierte Tore.

Lieber eine klassische Ligatabelle, in der die Teams die Zeilen sind? Schalt Fixed teams neben Match format ein: Feste Teams mit Namen melden sich über den Team sign-up-Button am Leaderboard an (die Kader dürfen bis zu zwei Reservisten haben), Matches werden Team gegen Team mit Ergebnis eingetragen, und die Tabelle sortiert die Teams nach Punkten. Die Aufstellung jedes Teams ist auf der Leaderboard-Seite der Website zu sehen: Die Mitgliederzahl steht neben dem Teamnamen, beim Darüberfahren erscheinen die Namen, und wer das Team öffnet, sieht die volle Aufstellung mit markiertem Kapitän.

Prüfen & zurücknehmen

League-Matches laufen durch dieselbe Prüfung wie ELO-Matches: Ein Validator gibt jede Einreichung frei oder lehnt sie ab, die Punkte greifen mit der Freigabe, und ein freigegebenes Match lässt sich später zurücknehmen — dann verschwinden genau die Punkte wieder, die vergeben wurden.

ELO- und League-Leaderboards müssen nicht zweiseitig sein. Bei Jeder gegen jeden spielt jeder im Match für sich — 3 bis 8 Spieler — und das Ergebnis ist die Platzierung jedes Einzelnen. Schalt es beim Anlegen des Leaderboards mit der Option ffa_players ein, oder später unter Match format im Dashboard. Es tritt an die Stelle von Team-Matches: ein Jeder-gegen-jeden-Leaderboard kann nicht zusätzlich eine Teamgröße oder feste Teams haben, und das Einschalten gilt nur für neue Matches — alles bereits Erfasste bleibt genau so, wie es ist.

Die Ergebnisarten

Nur-Sieger ist eine League-Variante. Dort braucht sie nicht mehr, als sie sagt: der Sieger bekommt die Siegpunkte, der Rest die Niederlagenpunkte. So entspannt darf eine Wertung nicht sein — bleiben die Verlierer ohne Platzierung, kann sie ehrlicherweise nur sagen, dass sie alle unentschieden gespielt haben, und dann gewinnt ein schwach bewerteter Spieler Rating aus einem Match, das seine Bilanz als Niederlage zählt. Deshalb verlangt ein ELO-Jeder-gegen-jeden die ganze Reihenfolge, oder ein Unentschieden, das wirklich passiert ist.

Ein Ergebnis melden

Jeder-gegen-jeden-Leaderboards tragen statt Submit result einen Report result-Button. Wähl zuerst alle aus, die mitgespielt haben — genau so viele, wie die Lobbygröße des Leaderboards vorgibt, ein 6-Spieler-Leaderboard nimmt also 6 und lässt sich mit 5 nicht abschicken. Dasselbe Formular kann das Ergebnis gleich mittragen: Wähl den Sieger, und das Match ist sofort gemeldet; auf einem Leaderboard mit Platzierungstabelle wird daraus die ganze Reihenfolge — erst Platz 1, dann 2 und so weiter. Lässt du es leer, kommt stattdessen der Ergebnisschritt. Dann setz das Ergebnis: ein League-Leaderboard fragt nach dem Sieger, mit Unentschieden für alle im selben Menü und Ganze Reihenfolge setzen, wenn du lieber das ganze Feld sortierst; ein ELO-Leaderboard fragt direkt nach der Reihenfolge, ein Platz pro Klick, mit Letzte rückgängig für den Fehlgriff und einem Unentschieden für alle-Button daneben. Absenden bleibt ausgegraut, bis das Ergebnis eines ist, das das Leaderboard werten kann. Der Button ist der einzige Weg, ein Jeder-gegen-jeden-Ergebnis in Discord zu melden — zeigt dein Leaderboard ihn nicht, schalte ihn im Dashboard unter Discord-Anzeige → Submit-Button ein oder melde das Match auf der Leaderboard-Seite der Website.

Danach ist ein Jeder gegen jeden eine ganz normale Einreichung. Sie landet in der Freigabe-Warteschlange, ein Validator gibt sie frei oder lehnt sie ab (oder die Auto-Freigabe tut es nach der eingestellten Verzögerung), Ratings und Punkte bewegen sich bei der Freigabe, und wird ein freigegebenes Match storniert, bekommt jeder Spieler exakt das zurück, was es ihm gegeben hat.

Wie die Wertung rechnet

Ein ELO-Jeder-gegen-jeden wird als alle seine Direktvergleiche auf einmal gewertet. Jedes Spielerpaar wird verglichen — die bessere Platzierung schlägt die schlechtere, gleiche Platzierung ist ein Unentschieden zwischen beiden — und jedes dieser Mini-Ergebnisse wird mit derselben Erwartungswert-Rechnung gewertet wie ein 1v1. Vor Spielern zu landen, die weit über dir bewertet sind, zahlt sich also deutlich stärker aus als vor dem Ende des Feldes. Der K-Faktor wird anschließend durch die Zahl der Gegner geteilt, und genau das hält ein Jeder gegen jeden bei etwa einem Match Rating-Bewegung statt bei den sieben Duellen, die du technisch gespielt hast.

Das Ganze ist exakt nullsummig: was das Feld verliert, gewinnen die anderen, bis auf den letzten Punkt. Sechs gleich bewertete Spieler landen bei K=32 auf +16, +10, +3, −3, −10, −16. Die Bilanz folgt der Platzierung — der erste Platz, auch geteilt, zählt als Sieg, alles darunter als Niederlage, und ein Unentschieden für alle als Unentschieden für das ganze Feld.

Platzierungspunkte auf League-Leaderboards

Ein League-Jeder-gegen-jeden kann das ganze Feld über eine Tabelle mit Platzierungspunkten auszahlen, F1-Stil: so viele Punkte für den Ersten, so viele für den Zweiten und so weiter durch die Lobby. Du bearbeitest sie im Dashboard unter den Sieg-, Unentschieden- und Niederlagenpunkten, auf jedem League-Leaderboard, das Jeder gegen jeden spielt. Gleichplatzierte bekommen jeweils die Punkte des Platzes, den sie teilen, und wer hinter dem letzten Tabelleneintrag landet, bekommt weiterhin diesen letzten Wert.

Die Tabelle zählt nur bei einer vollständigen Reihenfolge. Bleibt auch nur einer ohne Platzierung — eine Nur-Sieger-Meldung oder eine Reihenfolge, die du auf halbem Weg abgebrochen hast — greift sie gar nicht: Der erste Platz bekommt die Siegpunkte des Leaderboards und alle anderen die Niederlagenpunkte. Genau das bekommst du auch ganz ohne Tabelle, die Tabelle ist also optional. Ein Unentschieden für alle zahlt allen die Unentschieden-Punkte, was auch immer in der Tabelle steht.

Jeder gegen jeden in der Matchmaking-Warteschlange

Mit aktiviertem Queue-Button stellt ein Jeder-gegen-jeden-Leaderboard Einzelspieler in die Warteschlange und startet in dem Moment, in dem genau die Lobbygröße erreicht ist — sechs Spieler auf einem 6-Spieler-Leaderboard, nie fünf und nie sieben. Es gibt keine Seiten zu balancieren, also ist die Lobby einfach die im Rating engste Gruppe, die die Warteschlange zusammenstellen kann. Alle müssen trotzdem Ready klicken, und das Match bekommt einen gemeinsamen Voice-Raum: bei Jeder gegen jeden gibt es keine Mitspieler, vor denen man sich verstecken müsste.

Das Ergebnis wird gemeldet statt abgestimmt — drei Vote-Buttons können keine Reihenfolge von acht Spielern ausdrücken. Jeder Spieler der Lobby setzt das Ergebnis in der Match-Nachricht, die anderen drücken Bestätigen; es steht fest, sobald eine Mehrheit des Feldes zugestimmt hat (zwei von drei, fünf von acht), wobei der Meldende als Erster davon zählt. Widersprechen übergibt das Match an einen Validator, der das richtige Ergebnis setzt und selbst bestätigt. Ein Warteschlangen-Match wird in seinem eigenen Thread entschieden und läuft deshalb nicht durch die Freigabe-Warteschlange.

Beim Leaderboard-Typ Rating reichen die Mitglieder deiner Community Bilder ein und geben den Beiträgen der anderen Sterne.

Bewerten auf der Website

Auf der Website liegen die Einreichungen im Tab Entries. Klick eine an, um das Bild in voller Größe zu sehen und es direkt mit den Stern-Buttons zu bewerten. Deine Stimmen bleiben auch beim nächsten Besuch gespeichert.

Ein Levels (BETA)-Leaderboard ordnet die Mitglieder deines Servers nach XP. Niemand reicht etwas ein: Mitglieder sammeln XP durchs Schreiben und durchs Reden in Sprachkanälen, der Bot zählt mit, und das Level jedes Mitglieds ergibt sich aus seiner XP. Ein Server hat immer nur ein Levels (BETA)-Leaderboard, und es ist immer ein Server-Leaderboard — ein persönliches Leaderboard kann keins sein.

Jede dieser Zahlen ist eine Einstellung in den Levels (BETA)-Einstellungen des Leaderboards im Dashboard: die XP-Spanne pro Nachricht, die Wartezeit zwischen Nachrichten und die XP pro Minute in Voice (0 schaltet Voice-XP aus).

Von XP zum Level

Das Level eines Mitglieds wird bei jeder Anzeige aus seiner XP berechnet und deshalb nie gespeichert. Die Standard-Kurve ist die, die die meisten Level-Bots auf Discord nutzen: Von Level L zum nächsten kostet es 5L² + 50L + 100 XP. Die lineare Kurve kostet 100L + 75 XP pro Level — sie startet etwas steiler und erreicht hohe Level viel früher. Die gesamte XP, die man für ein Level braucht:

Wechselst du die Kurve, behält jeder seine XP; nur das Level, das sich daraus ergibt, ändert sich.

Kanäle und Rollen ohne XP

Wähl Kanäle, in denen Nachrichten und Zeit in Voice nichts bringen — Threads gehören zu ihrem Kanal — und Rollen, deren Mitglieder nie XP sammeln, etwa eine Rolle für stummgeschaltete Mitglieder.

Level-up-Nachrichten

Erreicht ein Mitglied ein neues Level, postet der Bot eine Nachricht, die es erwähnt. Standardmäßig landet sie in dem Kanal, in dem das Mitglied gerade geschrieben hat; du kannst sie stattdessen in einen festen Kanal schicken oder ausschalten. Du kannst einen eigenen Text mit bis zu 200 Zeichen schreiben, in dem {user}, {level} und {board} ausgefüllt werden. Die Nachricht pingt nur das Mitglied, das das Level erreicht hat, selbst wenn im Text @everyone steht, und erreichen mehr als drei Mitglieder im selben Kanal gleichzeitig ein neues Level, teilen sie sich eine Nachricht. Der Bot braucht die Berechtigung, in diesem Kanal Nachrichten zu senden.

Rollen pro Level

Auf einem Levels (BETA)-Leaderboard haben Tier-Rollen eine vierte Methode, Level: eine Rolle ab Level 5, eine weitere ab Level 10 und so weiter. Ist Niedrigere Tier-Rollen behalten an, behalten Mitglieder jede Rolle, die sie erreicht haben; schaltest du es aus, behalten sie nur die höchste. Die Rollen ändern sich kurz nachdem ein Mitglied ein neues Level erreicht hat.

Währung pro Level

Läuft auf deinem Server die Währung, kannst du für Level bezahlen: einen festen Betrag jedes Mal, wenn ein Mitglied ein neues Level erreicht, einmal pro Level. Das zählt zum selben Tageslimit wie jede andere Auszahlung, und dieselbe Regel zum Account-Alter gilt. Nachrichten und Minuten in Voice allein bringen keine Währung.

Seasons

Endet eine Season, friert das Leaderboard ein: XP zählt nicht mehr, und der Stand bleibt so, wie er endete. Taust du es wieder auf, geht es mit derselben XP weiter. Für einen Neuanfang legst du ein neues Levels (BETA)-Leaderboard an und lässt das eingefrorene als Rekord stehen — ein eingefrorenes Leaderboard zählt nicht zur Grenze von einem pro Server.

XP importieren und von Hand setzen

Du kommst von einem anderen Level-Bot? Importier XP aus einer CSV-Datei mit einem name,xp pro Zeile über Aus CSV importieren im Dashboard, wie unter Import & Umzug beschrieben. Nimm die Discord-User-ID jedes Mitglieds als Namen: Dann wird die Zeile mit dem Mitglied verknüpft, und die XP, die es danach sammelt, kommt obendrauf. Eine Zeile mit irgendeinem anderen Namen wird ein normaler Texteintrag, zu dem keine Aktivität etwas hinzufügt.

Um XP von Hand zu setzen, nutz /score in Discord oder Set XP und Adjust XP im Menü eines Spielers auf der Website. Ein Import oder eine Änderung von Hand postet keine Level-up-Nachricht und zahlt keine Level-Belohnung aus; Tier-Rollen ziehen nach, sobald das Leaderboard das nächste Mal neu gezeichnet wird.

Umzug von MEE6 oder einem anderen Level-Bot

Scoreboards importiert nicht automatisch aus MEE6: Die Nutzungsbedingungen von MEE6 erlauben keinen automatisierten Zugriff auf ihren Dienst, also liest der Bot nie das Leaderboard eines anderen Bots für dich aus. Stattdessen kannst du die XP deiner Mitglieder selbst mitnehmen — es sind die Daten deines eigenen Servers — mit einer CSV-Datei:

1. Kopier die gesamten XP jedes Mitglieds aus dem Leaderboard deines Servers bei MEE6 oder dem anderen Bot. Kopier die XP, nicht das Level: Das Level ergibt sich aus den XP. Zeigt MEE6 eine gerundete Zahl wie 12.5k, schreib die volle Zahl (12500); die XP kann dann leicht abweichen.
2. Kopier die Discord-User-ID jedes Mitglieds: Schalte in Discord den Developer Mode ein (Settings → Advanced), klick dann mit rechts auf das Mitglied und wähl Copy User ID.
3. Schreib ein name,xp pro Zeile, mit der User-ID als Namen und den XP nur als Ziffern: 12500, nicht 12,500 oder 12.500. Eine so geschriebene Zeile wird übersprungen und mit ihrer Zeilennummer angezeigt, damit du sie korrigieren und erneut importieren kannst.
4. Öffne im Dashboard das Levels (BETA)-Leaderboard und nutze Aus CSV importieren. Jede Zeile ersetzt die XP des Mitglieds, statt etwas dazuzuzählen, also importier, bevor die Mitglieder hier viel gesammelt haben. Eine korrigierte Datei kannst du jederzeit neu importieren, und eine Datei fasst bis zu 500 Zeilen.

name,xp
123456789012345678,4675
234567890123456789,23850

Nur eine User-ID verknüpft eine Zeile mit einem Mitglied: Ein Name aus 17 bis 20 Ziffern wird als Discord-User-ID gelesen, und die XP, die das Mitglied danach sammelt, kommen obendrauf. Ein Benutzername oder jeder andere Name wird niemandem zugeordnet; er wird ein normaler Texteintrag, zu dem keine Aktivität etwas hinzufügt.

Die Standard-Kurve ist die von MEE6, also ergeben dieselben XP dasselbe Level: 4.675 XP sind in beiden Level 10. Der Import postet keine Level-up-Nachrichten und zahlt keine Level-Belohnungen aus. Rollen als Belohnung kommen nicht mit: Richte sie als Tier-Rollen mit der Methode Level neu ein, dann bekommen die Mitglieder sie, sobald das Leaderboard das nächste Mal neu gezeichnet wird. Schalte danach die Levels im anderen Bot ab, damit niemand doppelte Level-up-Nachrichten bekommt.

Wie oft das Leaderboard aktualisiert wird

Die Leaderboard-Nachricht in Discord wird neu gezeichnet, wenn jemand ein neues Level erreicht oder sich die Reihenfolge der angezeigten Plätze ändert — höchstens einmal pro Minute — und sonst etwa alle 15 Minuten, solange Mitglieder XP sammeln. Ein Leaderboard, auf dem niemand aktiv ist, wird nicht neu gezeichnet. Die Zeile Zuletzt aktualisiert darunter zeigt, wann es gezeichnet wurde. Mein Rank und das Leaderboard auf der Website zeigen XP innerhalb von Sekunden.

Datenschutz

Der Bot liest nie, was Mitglieder schreiben. Er nutzt Discords Message-Content-Intent nicht und liest oder speichert nie den Text einer Nachricht. Für jedes Mitglied, das XP sammelt, speichert er Discord-ID und Anzeigenamen, die gesamte XP, wie viele seiner Nachrichten XP gebracht haben, wie viele Minuten in Voice XP gebracht haben und wann zuletzt XP gesammelt wurde, dazu einen nächtlichen Snapshot seines Rangs für das Rangverlauf-Diagramm. Pro Nachricht wird nichts gespeichert. Die Daten werden mit dem Leaderboard gelöscht und mit den übrigen Daten des Servers, wenn der Bot entfernt wird. Wenn die Währung des Servers Level bezahlt, kommt für jedes erreichte Level ein Eintrag im Währungsverlauf des Mitglieds dazu, der mit seinen übrigen Währungsdaten aufbewahrt wird. Details stehen in der Datenschutzerklärung.

Du bestimmst, wer deine Leaderboards auf der Scoreboards-Website sehen kann:

Vergib Discord-Rollen automatisch nach der Platzierung auf dem Leaderboard. Die Top 3 bekommen zum Beispiel die Rolle "Champion", die Plätze 4–10 die Rolle "Veteran" und so weiter.

• Tiers richtest du im Web-Dashboard in den Einstellungen des jeweiligen Leaderboards ein.
• Leg fest, wie ein Tier abgegrenzt wird: nach Rank (Plätze 1–3), nach Perzentil (die besten 10 % der Spieler) oder nach Score (alle mit 2000+ Punkten). Ein Levels (BETA)-Leaderboard kann auch nach Level gehen (alle ab Level 10). Alle Tiers eines Leaderboards nutzen dieselbe Methode.
• Häng an jeden Tier eine beliebige vorhandene Discord-Rolle.
• Die Rollen werden automatisch vergeben und wieder entzogen, sobald sich die Platzierungen ändern.
• Die Scoreboards-Rolle muss in Server Settings → Roles über jeder Rolle stehen, die sie vergeben soll. Discord lässt Bots keine Rollen auf oder über ihrer eigenen Ebene anfassen — stößt der Bot darauf, schreibt er eine Warnung in den Kanal des Leaderboards.

Läuft euer Wettbewerb schon woanders? Eine CSV-Datei füllt ein ganzes Leaderboard auf einmal, sodass du nichts abtippen musst.

Öffne das Dashboard, wähl ein Leaderboard und nutz Aus CSV importieren. Für ein Server-Leaderboard und für ein persönliches, das zu keinem Discord-Server gehört, ist es derselbe Weg. Die Datei ist in beiden Fällen dieselbe — ein name,score pro Zeile:

name,score
Alex,120
"Cooney, EM",95
Sam,88

• Eine Kopfzeile wird erkannt und automatisch übersprungen.
• Komma, Semikolon und Tabulator funktionieren alle als Trennzeichen — nimm einfach das, was deine Tabelle ausspuckt.
• Namen mit Komma funktionieren, wenn sie in Anführungszeichen stehen, etwa "Cooney, EM".
• Ist der Name eine Discord-User-ID, wird der Eintrag mit dem Mitglied verknüpft und zeigt dessen Anzeigenamen. Alles andere wird ein normaler Texteintrag.
• Steht derselbe Name zweimal drin, zählt der letzte Wert — so kannst du eine korrigierte Datei einfach nochmal einlesen.
• Zeilen, die sich nicht lesen lassen, werden übersprungen und mit Zeilennummer aufgelistet — der Rest kommt trotzdem rein, du korrigierst also ein paar Zeilen und lädst die Datei erneut hoch.

Zeiten versteht er als mm:ss, hh:mm:ss und optional mit Nachkommastellen: 1:30, 1:12:44.081. Eine reine Zahl liest er als Millisekunden. Achtung: Drei durch Doppelpunkt getrennte Zahlen bedeuten Stunden:Minuten:Sekunden — was unter einer Sekunde liegt, schreibst du hinter einen Punkt.

Levels (BETA)-Leaderboards nehmen name,xp mit der Discord-User-ID jedes Mitglieds als Namen — ein Benutzername wird ein eigener Eintrag, der nie XP sammelt. Die Zahl ist die gesamte XP des Mitglieds und ersetzt die XP, die es vorher hatte. Ein Import postet keine Level-up-Nachrichten und zahlt keine Level-Belohnungen aus.

Grenzen: 500 Zeilen und 100 KB pro Datei — größere Exporte teilst du auf und importierst sie in Etappen. Leaderboards vom Typ Image Rating lassen sich nicht importieren, weil ihre Einträge hochgeladene Bilder sind und keine Scores.

Seasons ziehen einen Schlussstrich unter einen Wettbewerb, ohne dass etwas verloren geht. Setz eine Endzeit (oder beende im Dashboard) und das Board friert ein: Ein Podium wird gepostet und der Stand bleibt genau so stehen.

• Nichts wird zurückgesetzt oder gelöscht — das eingefrorene Board ist der bleibende Saisonrekord, für alle sichtbar.
• Ein eingefrorenes Board nimmt keine neuen Einsendungen, Matches oder Stimmen an; ein Admin kann es jederzeit wieder freigeben.
• Jeder Board-Typ kann Seasons haben — auch Image Rating, wo das Einfrieren eines Blind-Voting-Boards zugleich das Ergebnis aufdeckt.
• Lust auf eine neue Season? Leg ein neues Board an und lass das eingefrorene als Rekord stehen.

Wochenrückblicke posten jeden Montag eine kurze Zusammenfassung in den Kanal des Leaderboards: die Top drei, den größten Aufsteiger der Woche und wie viel gespielt wurde. Nur Boards mit mindestens drei Scores in der vergangenen Woche bekommen einen — ein ruhiges Leaderboard bleibt also ruhig. Abschalten kannst du sie pro Leaderboard im Dashboard auf der Website.

Eine Währung macht aus Ergebnissen etwas, das Mitglieder im Shop des Servers ausgeben. Sie ist eine Beta und bleibt aus, bis ein Admin sie im Dashboard unter Währung einrichtet und startet — danach zahlt jedes freigegebene Ergebnis an die Spieler aus. Eine Auszahlung besteht aus einem festen Sockel und einem Anteil an einem variablen Topf: ein Teil des Topfes folgt dem Ergebnis, ein Teil der Überraschung, jemanden deutlich höher Eingestuften zu schlagen ist also mehr wert als ein Sieg gegen jemanden darunter. Auf einem Classic-, Highscore- oder Time-Board gibt es keinen Gegner, dort übernimmt dein Platz auf dem Board diese Rolle. Es ist ein Guthaben pro Mitglied für den ganzen Server, geteilt von allen Leaderboards darauf.

• Eine Siegesserie legt 2 % pro Sieg drauf, bis zu dem Limit, das du setzt.
• Immer wieder gegen denselben Gegner zu spielen zahlt innerhalb einer laufenden Woche weniger: die ersten zwei Matches zahlen voll, jedes weitere weniger, bis hinunter auf ein Zehntel.
• Ein Tageslimit begrenzt, was ein Mitglied an einem Tag mitnimmt, und standardmäßig muss ein Discord-Account 7 Tage alt sein, bevor er überhaupt etwas verdient.
• Wird ein Ergebnis storniert, bearbeitet oder gelöscht, wird die Auszahlung zurückgenommen, genau so, wie sie gezahlt wurde — war die Währung schon ausgegeben, kann ein Guthaben ins Minus rutschen. Jede einzelne Zeile davon steht auf der Shop-Seite des Servers.
• Image Rating-Boards zahlen nichts aus — es gibt kein Ergebnis, das sich bepreisen ließe.
• Levels (BETA)-Leaderboards zahlen stattdessen pro Level: einen festen Betrag jedes Mal, wenn ein Mitglied ein neues Level erreicht, eingestellt in den Levels (BETA)-Einstellungen des Leaderboards und aufs Tageslimit angerechnet.

Ausgegeben wird sie auf der Shop-Seite des Servers. Die Seite ist für die Mitglieder des Servers da: sie melden sich mit Discord an, sehen ihr Guthaben, kaufen, wählen, was sie tragen, und können jede Auszahlung aufklappen, um genau zu sehen, wie sie zustande kam. Der Shop-Button unter einem Leaderboard in Discord bringt sie direkt dorthin. Beim Start der Währung lässt er sich unter allen Leaderboards auf einmal einblenden, und jedes Leaderboard hat unter Discord → Branding & Personalisierung einen eigenen Schalter dafür.

Diese Seite liegt unter scoreboards.dev/shop/dein-server, eine pro Server, und auch die Leaderboard-Seiten des Servers verlinken darauf. Sie verkauft drei Arten von Artikeln. Discord-Rollen werden im Moment des Kaufs vergeben, dauerhaft oder — mit eingeschalteten Mieten — für eine feste Zeit, nach der die Rolle wieder entfernt wird und das Mitglied sie erneut kaufen kann. Scoreboards muss in den Servereinstellungen → Rollen über jeder Rolle stehen, die es verkauft, und das Dashboard graut eine Rolle aus, die es nicht vergeben kann, und sagt, warum. Leaderboard-Emojis stehen neben dem Namen des Käufers auf den Leaderboards des Servers, auf der Website und in Discord. Ein gekauftes Emoji nimmt den Platz einer Medaille ein, auch in den Top 3, und sind die Medaillen eines Boards ausgeschaltet, erscheint es trotzdem, solange die Währung läuft. Die Namen selbst werden auf den Boards von Emojis bereinigt, ein gekauftes Emoji lässt sich also nicht durch Umbenennen fälschen. Namensfarben färben den Namen des Käufers auf der Website und auf Bild-Leaderboards in Discord, aber nicht auf Boards, die als Text-Embed gepostet werden. Sobald jemand etwas kauft oder anlegt, werden die Discord-Leaderboards, auf denen er steht, neu gezeichnet und zeigen es.

Ein Server kann Währungs-Saisons laufen lassen, getrennt von seinen Leaderboard-Saisons. Endet eine — nach der im Dashboard eingestellten Länge oder wenn ein Admin sie dort beendet —, beginnt die nächste sofort, und mit eingeschalteter Halbierung wird vorher jedes Guthaben ab 2 halbiert. Gekaufte Rollen und Items bleiben. Mitglieder sehen das Enddatum vorher auf der Shop-Seite, und das Ende wird im Log-Kanal gepostet.

Mit eingeschaltetem Prestige kann ein Mitglied, dessen Guthaben die vom Admin gesetzte Grenze erreicht, auf der Shop-Seite alles für die nächste Prestige-Stufe verbrennen. Die Prestige-Stufe erscheint als Stern mit Zahl neben dem Namen auf dem Website-Leaderboard und der Discord-Karte, übersteht jedes Saisonende und wird im Log-Kanal angekündigt.

Mit wechselndem Sortiment kann jedes Shop-Item ein Start- und ein Enddatum haben, das du beim Hinzufügen oder Bearbeiten des Artikels festlegst. Vor dem Start zeigt die Shop-Seite es als bald verfügbar; am Ende verlässt es das Regal und kann nicht mehr gekauft werden.

Mit eingeschalteten Auktionen stellt ein Admin im Dashboard eine Rolle oder ein Kosmetik-Item ein, und Mitglieder bieten auf der Shop-Seite. Ein Gebot wird beim Bieten abgebucht und zurückgegeben, sobald jemand höher bietet, und ein Gebot in den letzten fünf Minuten schiebt das Ende nach hinten. Beim Schluss wird das Siegergebot vernichtet, der Preis übergeben und das Ergebnis im Log-Kanal gepostet.

Die Einrichtung dauert vier Schritte im Dashboard unter Währung, im Modus Einfach: gib der Währung einen Namen; wähle aus drei Tempos, wie Mitglieder verdienen, jedes mit einer Schätzung, was ein aktives Mitglied pro Woche bekommt; füll den Shop, mit einem Starter-Set per Klick aus sechs Namensfarben und sechs Leaderboard-Emojis, passend zu diesem Tempo bepreist (dieser Schritt lässt sich überspringen); und starte, mit dem Beta-Häkchen und einem Shop-Button unter jedem Leaderboard, der schon angehakt ist. Artikel werden unter Währung → Shop in einem kurzen Ablauf mit drei Schritten, Preisvorschlägen und einer Vorschau angelegt und bearbeitet. Der Modus Erweitert ergänzt die Auszahlungswerte, wer verdient, den Log-Kanal, Saisons, Mieten, Prestige, wechselndes Sortiment und Auktionen. Admins vergeben Währung und holen sie zurück — über das Kontextmenü eines Spielers auf einem Leaderboard oder unter Währung → Mitglieder, wenn das Mitglied auf keinem Board steht; beides landet im Log-Kanal, den du festlegst, damit niemand einem Moderator einfach glauben muss. Die Währung ist kein Geld: sie hat keinen Gegenwert, sie verlässt den Server nicht, auf dem sie verdient wurde, und sie kann jederzeit zurückgesetzt werden.