---
title: "So fügst du einem HTML5-Spiel eine Bestenliste hinzu"
description: "Bestenliste für dein Browserspiel mit dem klyo SDK: eine Skriptzeile, drei Aufrufe. Für Tag, Woche und alle Zeiten, dazu ein Platz im Rekord-Center."
url: https://games.klyo.pl/de/support/add-leaderboard/
canonical: https://games.klyo.pl/de/support/add-leaderboard/
type: instrukcja
language: de
author: klyo
organization: Klyo Illia Krasnopolskyi (NIP 7822656871), Łódź, Polska
contact: kontakt@klyo.pl
updated: 2026-10-20
llms: https://games.klyo.pl/llms.txt
---

# So fügst du einem HTML5-Spiel eine Bestenliste hinzu

Füge das Skript des klyo SDK in die index.html ein, ruf klyo.ready() auf, sobald das Spiel spielbar ist, klyo.progress() während der Partie und klyo.score() am Ende. Leg im Studio die höchstmögliche Punktzahl fest, dann bekommt dein Spiel Bestenlisten für den Tag, die Woche und alle Zeiten.

## Bevor du loslegst

- Ein Spiel, das auf klyo games veröffentlicht ist oder bereit zum Hochladen.
- Zugriff auf die index.html des Spiels. Auf deiner Seite brauchst du keinen Server, keine Datenbank und keine Konten.
- Oder ein KI-Assistent, der über MCP verbunden ist: Sag ihm, dass er dem Spiel die Bestenliste von klyo hinzufügen soll.

## Schritt für Schritt

1. **SDK einbinden**: Setz diese Zeile vor dein eigenes Skript in die index.html: ``. Außerhalb von klyo läuft das Spiel weiter, die Ergebnisse bleiben dann einfach im Browser.
2. **Der Seite sagen, dass das Spiel bereit ist**: Ruf `klyo.ready()` auf, sobald das Spiel geladen und spielbar ist. Die Seite blendet dann den Ladebildschirm aus.
3. **Fortschritt während der Partie melden**: Ruf `klyo.progress(points)` bei jeder Änderung des Punktestands auf. Das SDK sendet höchstens vier Updates pro Sekunde, und die Seite zeigt dem Spieler unter dem Spiel ein Ziel, zum Beispiel Platz 14 und wie viele Punkte ihm zum nächsten Spieler fehlen.
4. **Endergebnis senden**: Ruf am Ende der Partie `klyo.score(points, callback)` auf. Die Antwort enthält die Platzierung des Tages, der Woche und aller Zeiten sowie den Spieler direkt vor dir, fertig für deinen Endbildschirm. Es zählt ein bestes Ergebnis pro Gerät und Tag.
5. **Obergrenze für Punkte festlegen**: Füll im Studio bei der Beschreibung des Spiels das Feld „Höchstmögliche Punktzahl in einer Partie“ aus. Ergebnisse darüber werden sofort verworfen, und die Kachel des Spiels im Rekord-Center bekommt ein Zeichen für die Obergrenze. Ohne Obergrenze wird ein Ergebnis, das zehnmal höher ist als das nächste, erst geprüft.
6. **Bestenliste im Spiel anzeigen (optional)**: `klyo.leaderboard.get("day", callback)` liefert die 20 besten Ergebnisse des Tages, der Woche oder aller Zeiten, mit denselben Spielernamen wie in der Community.

## Wenn etwas nicht klappt

### Ergebnisse erscheinen nicht

Ein Ergebnis zählt erst nach einer Partie von mindestens 3 Sekunden und nur, wenn das Spiel auf klyo läuft. Prüfe, ob das SDK vor deinem eigenen Skript geladen wird und ob du klyo.ready() aufrufst.

### Ein Ergebnis wird abgelehnt

Es liegt über deinem festgelegten Limit oder kam zu schnell nach dem vorigen Ergebnis vom selben Gerät.

### Spieler fragen, wo die Bestenliste ist

Sie erscheint automatisch auf der Spielseite und in der Rekord-Übersicht. Im Spiel selbst zeigst du sie nur an, wenn du klyo.leaderboard.get aufrufst.

## Häufige Fragen

### Brauchen Spieler ein Konto für die Bestenliste?

Nein. Ein Ergebnis gehört zum Gerät. Mit Konto steht der Name des Spielers in der Bestenliste, und das Ergebnis begleitet ihn auf seine anderen Geräte.

### Kann man die Bestenliste über die Browserkonsole austricksen?

Nein. Ein Ergebnis wird nur mit einem Token angenommen, das der Server beim Start der Partie signiert, nach mindestens 3 Sekunden Spielzeit und unter deinem Limit. Eine Zahl in die Konsole zu tippen bringt also nichts.

## Passende Anleitungen

- [So veröffentlichst du ein HTML5-Spiel auf klyo games](https://games.klyo.pl/de/support/publish-html5-game/)
- [Neue Spielversion veröffentlichen, alte wiederherstellen](https://games.klyo.pl/de/support/release-new-version/)
- [Spiel zeigt einen weißen Bildschirm: so behebst du es](https://games.klyo.pl/de/support/white-screen/)
- [Alle Anleitungen](https://games.klyo.pl/de/support/)

Klappt es immer noch nicht? Schreib an [kontakt@klyo.pl](mailto:kontakt@klyo.pl) und gib die Adresse des Spiels an. Ein Mensch antwortet dir innerhalb von zwei Werktagen.

---

Źródło: https://games.klyo.pl/de/support/add-leaderboard/ · Autor: klyo, polska firma technologiczna (Łódź, klienci w całej Polsce) · Kontakt: kontakt@klyo.pl · Indeks dla modeli językowych: https://games.klyo.pl/llms.txt