Spelideeën en functies

Je volgende functie

Leaderboard

Sla de score na elke ronde op en laat zien wie vooropstaat.

Spelerssessie vereist
Godot
Illustratie van Leaderboard
Je zichtbare resultaat

Je testscore verschijnt na een ronde in de ranglijst.

Scorebordstanden bekijken3:54

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Leaderboard →
  2. Maak of hergebruik deze testgegevens in het dashboardformulier. Dit zijn voorbeeldwaarden, geen huidige projectgegevens.

    Sleutel (slug)
    weekly
    Sortering
    DESC
    Alleen scores van gevalideerde runs accepteren
    false
  3. Sla de gegevens op, laad ze opnieuw en controleer ze vóór het voorbeeld. Behoud andere definities.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

Sla het GDScript op, koppel het aan een knooppunt in de hoofdscène en voer die uit. Controleer Output.

GDScript
res://scripts/leaderboard.gd
horizOn-aanroepVoorbereiding
1# Koppel dit script aan een node in je hoofdscène.
2extends Node
3​
4​
5func _ready() -> void:
6 # Voorbereiding: initialiseren, verbinden en een speler aanmelden.
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn: een score indienen, de ranglijst en je eigen positie lezen.
21 var submitted: bool = await Horizon.leaderboard.submitScore(12500, "weekly")
22 if not submitted:
23 push_warning(Horizon.leaderboard.getLastErrorCode())
24 return
25 var top = await Horizon.leaderboard.getTop(10, false, "weekly")
26 for entry in top:
27 print("#%d %s: %d" % [entry.position, entry.username, entry.score])
28 var rank = await Horizon.leaderboard.getRank("weekly")
29 if rank != null:
30 print("Your rank: ", rank.position)
Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Je testscore verschijnt na een ronde in de ranglijst.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Alle eindpunten in de API-referentie