Zum Inhalt springen
klyogames

Was möchtest du hinzufügen?

Ein Konto für Spieler und Entwickler. Beiträge und Clips landen in der Community, Spiele nach einer Prüfung im Katalog.

Spiel (ZIP-Paket)Eigene Adresse und Statistiken, dazu ein Anteil an den Werbeeinnahmen, sobald wir Werbung einschalten. Online nach der automatischen Prüfung. Clip aus einem SpielNimm im Studio mit einem Klick 15–30 Sekunden aus deinem Spiel auf. Beitrag für die CommunityText, Fotos oder ein Video bis 30 s: eine Frage, ein Aufruf zum Testen, ein Release.

Dein Spiel

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: <script src="https://games.klyo.pl/sdk/klyo-gry-sdk.js"></script>. 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.