Scoreboards Documentation

Everything you need to create and manage Discord leaderboards

  1. Tilføj botten — Inviter Scoreboards ind på din Discord-server med invite-linket på forsiden.
  2. Kør opsætningsguiden — Brug /get started til at vælge en leaderboard-type, give den et navn og lægge den op i en kanal. Point-, Highscore- og Time-boards starter med et par eksempler, så du kan se boardet i aktion; de forsvinder i samme øjeblik den første rigtige score lander.
  3. Sæt rollerne — Åbn dashboardet og vælg rollen <arg>bot permission</arg> (dem der må styre leaderboards) og rollen <arg>validator</arg> (dem der må godkende indsendelser).
  4. Lav dit første leaderboard — Brug /scoreboard create. Du vælger navn, type og sorteringsrækkefølge.
  5. Vis det frem — Kør /scoreboard show i en kanal, så bliver leaderboardet lagt op med knapper til indsendelse og bladring.

Når du laver et leaderboard med /scoreboard create, vælger du en af seks typer:

Classic

Lægger point til eller trækker fra en løbende total. Bedst til spil, hvor pointene hober sig op over tid.

Highscore

Gemmer kun hver spillers personlige rekord. Lavere scores bliver automatisk skiftet ud.

Time (Speedrun)

Indsend tider som 00:00:00 (hundrededele) eller 00:00:000 (millisekunder) — visningsformatet vælger du i dashboardet, og nye boards står som standard til millisekunder. Sortér stigende, hvis hurtigst vinder, faldende hvis længst vinder.

ELO - Ranked

Konkurrencepræget ELO-rating, 1v1 eller på hold fra 2v2 til 8v8. Indsend resultatet af et match, og alle deltageres rating bliver rettet automatisk.

Rating

Indsend billeder og lad dit community give stjerner (1–10). Stemmerne bliver til et gennemsnit. Perfekt til kunstkonkurrencer og kreative udfordringer.

League

Point efter matches — til fodbold, basket, FIFA og alt derimellem. Du bestemmer selv point for sejr/uafgjort/nederlag (3/1/0 som standard) og noterer matchens cifre (fx 3-1).

Styring af leaderboards

KommandoBeskrivelseRettighed
/scoreboard createLav et nyt leaderboard med navn, type, sortering og valgfrie indstillingerAdmin / bot permission
/scoreboard showLæg leaderboardet op i kanalen med interaktive knapperAdmin / bot permission
/scoreboard settingsÅbner dashboardet, hvor du styrer boardets indstillinger (sortering, synlighed, kolonnenavne, visning, ELO-opsætning med mere)Admin / bot permission
/scoreboard deleteSletter et leaderboard og alle dets data permanent (kræver bekræftelse)Admin / bot permission
/scoreboard season endArkiverer slutstillingen, lægger en podieplacering op og nulstiller boardet til næste season (kræver bekræftelse)Admin / bot permission
/importHent scores ind i et leaderboard fra en CSV-fil (fra en anden bot eller et regneark)Admin / bot permission

Scores & matchresultater

KommandoBeskrivelseRettighed
/submitIndsend til et hvilket som helst leaderboard. Botten åbner det næste skridt, der passer til typen — et scorefelt (Classic/Highscore/Time), vælg spillere + vinder (ELO), vælg spillere + score (League) eller et navnefelt (Rating, med billedet vedhæftet slash-kommandoen). På et holdboard beder den om en fuld opstilling til hver side.Alle
/setSæt en spillers score eller ELO-rating til en bestemt værdiAdmin / bot permission
/adjustLæg til eller træk fra en spillers score (brug negative tal for at trække fra)Admin / bot permission
/player removeFjern en spiller fra et leaderboardAdmin / bot permission

Opsætning

KommandoBeskrivelseRettighed
/get startedStart opsætningsguiden til den allerførste opsætningAdmin
/helpÅbn den interaktive hjælp med alle emnerAlle

Der er to veje ind:

  • Kør /submit og vælg et leaderboard. Botten åbner det flow, der passer til typen — et scorefelt til Classic/Highscore/Time, vælg spillere + vinder til ELO, vælg spillere + score til League, eller et navnefelt til Rating (med billedet vedhæftet slash-kommandoen). På et holdleaderboard skal du vælge en fuld opstilling til hver side i stedet for én spiller.
  • Eller klik på Submit-knappen på det opslåede leaderboard — det åbner præcis det samme flow.

Godkendelsen

  1. Indsendelsen bliver lagt op i den kanal, du har valgt til gennemsyn (hvis du har sat en).
  2. En validator eller admin klikker Approve eller Reject.
  3. Bliver den afvist, får afsenderen en DM med begrundelsen.
  4. Bliver den godkendt, opdaterer leaderboardet sig med det samme.

Automatisk godkendelse

Hvert leaderboard kan sættes til at godkende indsendelser af sig selv efter et stykke tid: Off, Instant, 1 hour, 3 hours, 24 hours, 3 days eller 7 days. ELO-leaderboards står som standard til 24 timer.

Annullér en score

Admins og validatorer kan fortryde en allerede godkendt score: højreklik på beskeden med indsendelsen og vælg "Cancel Score/Match". Så rulles scoren tilbage, og du skal angive en begrundelse.

Leaderboard-typen ELO - Ranked rangerer spillerne efter en ELO-rating — enten 1v1 eller på hold med op til otte på hver side.

Sådan virker det

  • Alle starter på den samme start-ELO, som du selv bestemmer (standard: 1200).
  • Et match kan ende med sejr, nederlag eller uafgjort.
  • Ratings beregnes med en K-faktor på 32.
  • Alle deltageres rating rykker sig samtidig, når matchet er godkendt.

Holdmatches (2v2 – 8v8)

ELO- og League-leaderboards kan låses til en fast holdstørrelse — vælg den, når du opretter leaderboardet, eller skift den senere under Match format i dashboardet. På et 3v3-leaderboard er der så tre spillere på hver side i hvert eneste match, og leaderboardet rangerer stadig spillerne enkeltvis.

På ELO regnes hvert holds forventede resultat ud fra holdets gennemsnitlige rating, og ændringen gives til alle på holdet — slår I et stærkere hold, får hver eneste spiller på vinderholdet den samme gevinst. På League får alle på vinderholdet sejrspointene, og hele taberholdet får nederlagspointene.

Matchmaking-queue (beta)

Er queue-knappen slået til på leaderboardet, kan spillerne klikke sig ind i køen. Systemet samler spillere med nogenlunde samme ELO ved at udvide søgevinduet lidt efter lidt. Når to bliver matchet, oprettes der en tråd til matchet med afstemningsknapper. Er der ikke fundet et match inden for 5 minutter, udløber pladsen i køen.

På et holdleaderboard venter køen, til der er spillere nok til begge sider — seks til et 3v3 — og deler dem så op i to hold med så tæt på samme gennemsnitsrating som muligt, så de stærkeste og de svageste ender på hver sin side. Alle skal klikke Ready; gør en det ikke, ryger vedkommende ud, og resten kommer tilbage i køen med deres plads i behold.

Hvert hold får sin egen talekanal, så I kan lægge taktik uden at modstanderne hører med — du kan kun se og gå ind i dit eget holds kanal. Begge kanaler forsvinder, når matchet er afgjort. Et resultat står først fast, når et flertal på begge hold har stemt på det (to ud af tre i et 3v3), så ét hold kan aldrig udråbe sig selv til vinder. Alt andet ender som en tvist, som en validator afgør.

Faste hold

Et ELO- eller League-leaderboard med holdstørrelse kan også køre med fixed teams (slås til i dashboardet ved siden af Match format). Faste hold med navn melder sig til én gang via leaderboardets Team sign-up-knap — vælg et navn, og sæt truppen, som må have op til to reserver ud over holdstørrelsen. Derefter er det holdene selv, der rangeres: på et ELO-board har hvert hold sin egen rating, og det betaler sig at slå et stærkere hold; på et League-board rangeres holdene efter point, præcis som i en rigtig sportsliga. Faste hold i League registrerer deres matches med /submit — matchmaking-køen nedenfor findes kun på ELO.

Når bare ét medlem klikker Queue, ryger hele holdet i kø, og alle får en DM. Systemet matcher hold mod hold efter holdrating, og ready-checket fungerer samtidig som holdudtagelse: de første på hver trup, der klikker Ready, kommer på banen, indtil holdet er fuldt — resten sidder over den kamp. Resultatet stemmes igennem af dem, der spillede, efter samme regel om flertal på begge sider.

Leaderboard-typen League rangerer spillerne efter point samlet over en række matches. Det er formatet til fodbold, basket, futsal, hockey og enhver 1v1- eller holdturnering, hvor tabellen er sandheden.

Sådan virker det

  • Indsend et match med /submit — botten spørger efter begge sider og et cifferresultat til hver (fx 3 og 1).
  • Det højeste tal vinder; står det lige, er matchet uafgjort.
  • Vinderen får points_win, taberen points_loss, og ved uafgjort får begge points_draw. I en holdliga får hver spiller på en side sidens point.
  • Leaderboardet rangerer efter samlede point, mens sejre, uafgjorte og nederlag tælles ved siden af.

Standardpoint

Nye ligaer starter på 3 / 1 / 0 (FIFA-standarden siden 1994). Alle tre tal kan ændres per leaderboard i dashboardet. Brug 2 / 1 / 0 til hockey, 4 / 2 / 0 til rugby — eller find på jeres eget system, der passer til sporten.

Indsend et match

På hjemmesiden åbner du leaderboardet og klikker Submit — indtast begge sider og resultatet. /submit åbner nøjagtig det samme i Discord. Matches, hvor den samme spiller står på begge sider, og negative resultater bliver afvist med det samme.

Holdligaer

Et League-leaderboard kan låses til en fast holdstørrelse fra 2v2 op til 8v8 — enten når du opretter det, eller senere under Match format i dashboardet. Tabellen rangerer stadig spillerne enkeltvis: alle på vinderholdet får sejrspointene, hele taberholdet får nederlagspointene, og matchens cifre tæller som scorede og indkasserede mål for hver enkelt.

Vil du hellere have en klassisk ligatabel, hvor holdene er rækkerne? Slå Fixed teams til ved siden af Match format: faste hold med navn melder sig til via leaderboardets Team sign-up-knap (trupperne må have op til to reserver), matches indsendes hold mod hold med et resultat, og tabellen rangerer holdene efter point.

Godkendelse & annullering

League-matches går gennem den samme godkendelse som ELO-matches: en validator godkender eller afviser hver indsendelse, pointene tildeles ved godkendelse, og et godkendt match kan annulleres bagefter — så ryger præcis de point, der blev givet.

Leaderboard-typen Rating lader medlemmerne indsende billeder og give hinandens bidrag stjerner.

Sådan virker det

  • Man indsender billeder med /submit — vedhæft billedet til slash-kommandoen, og skriv et navn i feltet, der dukker op.
  • Indsendelserne lander i den kanal, du har valgt, med en rating-dropdown.
  • Alle kan give fra 1 til 10 stjerner. Stemmerne bliver til et gennemsnit.
  • Man kan altid ændre sin stemme — men kun én stemme per person per indsendelse.
  • Leaderboardet rangerer indsendelserne efter gennemsnitlig rating.

Rating på hjemmesiden

På hjemmesiden ligger indsendelserne under fanen Entries. Klik på en af dem for at se billedet i fuld størrelse og give stjerner direkte. Dine stemmer bliver husket, også næste gang du kommer forbi.

Du bestemmer selv, hvem der kan se dine leaderboards på Scoreboards-hjemmesiden:

Public

Alle på hjemmesiden kan se det.

Hidden

Kun medlemmer af din Discord-server kan se det (kræver login).

Private

Kun medlemmer med en bestemt Discord-rolle kan se det.

Disabled

Vises slet ikke på hjemmesiden.

Giv automatisk Discord-roller efter placeringen på leaderboardet. Du kan for eksempel give top 3 rollen "Champion", plads 4–10 rollen "Veteran" og så videre.

  • Tiers sætter du op i web-dashboardet under det enkelte leaderboards indstillinger.
  • Vælg, hvordan en tier afgrænses: efter placering (plads 1–3), efter percentil (de øverste 10 % af spillerne) eller efter score (alle med 2000+ point). Alle tiers på et leaderboard bruger den samme metode.
  • Knyt en hvilken som helst eksisterende Discord-rolle til hver tier.
  • Rollerne bliver givet og fjernet automatisk, efterhånden som placeringerne ændrer sig.
  • Scoreboards-rollen skal ligge over alle de roller, den skal uddele, i Server Settings → Roles. Discord lader ikke bots røre roller på eller over deres eget niveau, og støder botten på det, skriver den en advarsel i leaderboardets kanal.

Kører I allerede en konkurrence et andet sted? /import tager en CSV-fil og fylder leaderboardet ud fra den, så du slipper for at taste det hele forfra.

Der er to veje: i Discord kører du /import, vælger leaderboardet og vedhæfter filen — eller på hjemmesiden åbner du dashboardet, vælger et leaderboard og bruger Import from CSV. Personlige leaderboards hører ikke til nogen Discord-server, så dér er dashboardet vejen ind. Filen er den samme uanset hvad — én <arg>name,score</arg> per linje:

name,score
Alex,120
"Cooney, EM",95
Sam,88
  • En overskriftsrække bliver genkendt og sprunget over.
  • Komma, semikolon og tabulator virker alle som skilletegn — brug det, dit regneark nu engang spytter ud.
  • Navne med komma i virker, hvis de står i anførselstegn, fx <arg>"Cooney, EM"</arg>.
  • Er navnet et Discord-bruger-id, bliver linjen koblet til medlemmet og viser vedkommendes viste navn. Alt andet bliver til en almindelig tekstpost.
  • Står det samme navn to gange, gælder den sidste værdi — så du kan lægge en rettet fil ind ovenpå.
  • Linjer, der ikke kan læses, springes over og listes med linjenummer — resten kommer ind, så du kan rette et par linjer og køre filen igen.

Tider forstås som <arg>mm:ss</arg>, <arg>hh:mm:ss</arg> og eventuelt en brøkdel: <arg>1:30</arg>, <arg>1:12:44.081</arg>. Et rent tal læses som millisekunder. Bemærk, at tre tal adskilt af kolon betyder <arg>timer:minutter:sekunder</arg> — skal du under sekundet, skriver du det efter et punktum.

Grænser: 500 linjer og 100 KB per fil — del større eksporter op, og tag dem i bidder. Image Rating-leaderboards kan ikke importeres, fordi deres bidrag er uploadede billeder og ikke scores.

Seasons er måden at sætte punktum for en konkurrence og starte forfra uden at miste det, der er sket. Kør /scoreboard season end og bekræft — så arkiveres slutstillingen, der lægges en podieplacering op i leaderboardets kanal, og boardet nulstilles til næste season.

  • ELO-boards beholder spillerne og sætter alle ratings tilbage til startværdien — en ladder uden nogen på er ikke en ladder.
  • Classic-, Highscore-, Time- og League-boards tømmes, for en score på nul er ikke en rigtig placering.
  • Image Rating-boards har ikke seasons — en nulstilling ville slette de indsendte billeder.
  • Arkiverede slutstillinger bliver liggende for altid, også selvom boardet bliver nulstillet igen senere.

Ugentlige recaps lægger hver mandag et kort overblik i leaderboardets kanal: top tre, ugens største klatrer, og hvor meget der er blevet spillet. Kun boards med mindst tre scores i den forgangne uge får et, så et stille leaderboard får lov at være stille. Du kan slå recaps fra per leaderboard i /scoreboard settings eller i dashboardet på hjemmesiden.