Bestenliste im Spiel: Ranking, Runden und Belohnungen

Was der Spieler sieht

• Listen als Tabs: jede mit einer Karte, die Punktestand, Platz und den Countdown bis zum Rundenende des Spielers zeigt.
• Die besten Spieler, der Spieler selbst hervorgehoben, Medaillen für die ersten drei.
• Platzbelohnungen und Punktebelohnungen in Fenstern; Punktebelohnungen werden direkt dort abgeholt.
• Ein Fenster mit der Belohnung der letzten Runde: Es erscheint von selbst, wenn eine Runde endet, mit dem Knopf „Abholen“.
• Ein Knopf „Spielen“ auf der Karte, wenn das Spiel einen Modus hat, in dem man Punkte verdient.
• Ein Abzeichen am Tab, wenn eine Belohnung wartet.

Wie eine Liste aufgebaut ist

• Runden. Eine Liste wiederholt sich in Zyklen (zum Beispiel jede Woche), läuft nach Zeitplan oder als Kette von Runden.
• Wie gezählt wird. Die Summe aller Ergebnisse, das beste Ergebnis, die beste Zeit oder der letzte Wert.
• Platzbelohnungen: nach Platzbereichen am Ende einer Runde: 1. Platz, 2. bis 3., 4. bis 10. und so weiter.
• Punktebelohnungen: Meilensteine innerhalb einer Runde: „Verdiene diese Woche 1000 Punkte“.

Woher die Punkte kommen

Punkte kommen aus den Quellen, die an der Liste eingestellt sind:

• Ein Ergebnis aus dem Spiel (ClientScore). Das Spiel schickt eine Zahl, zum Beispiel die Punkte eines Laufs. ⚠ Setze Limits an der Quelle: ein Maximum pro Meldung, pro Tag und eine Pause zwischen Meldungen. Ohne diese Quelle nimmt die Liste überhaupt keine Zahl aus dem Spiel an.
• Ereignisse, die der Server selbst zählt, zum Beispiel Käufe oder erledigte Quests. Diese lassen sich aus dem Spiel nicht fälschen.

Für Entwickler

Die Bestenliste arbeitet über client.leaderboard in @idosgames/core.

// Ein Ergebnis melden: Der Server wendet Zählregel und Limits an
const sub = await client.leaderboard.submitScore('weekly_score', 150)
if (!sub.ok) return showError(sub.error)
sub.data.NewScore // der Punktestand nach dem Zählen

// Ein Bildschirm mit mehreren Listen: Top-Listen und Fortschritt des Spielers in einer Anfrage
const overview = await client.leaderboard.getOverviewBatch(['weekly_score', 'season_pvp'])

// Alles Wartende abholen: Platzbelohnungen und Punktebelohnungen
await client.leaderboard.claimAllRewardsBatch(['weekly_score', 'season_pvp'])

• Einen Punktestand von null oder weniger lehnt das SDK selbst ab, ohne Anfrage.
• Nimm den neuen Punktestand aus NewScore in der Antwort: Bei „bestes Ergebnis“ ändert ein schlechteres Ergebnis den Stand nicht.
• Das Ranking unter Freunden ist getFriendsLeaderboard(leaderboardID).

Jedes Feld ist im Skill leaderboard-system beschrieben, den der MCP-Server des SDK bereitstellt.