Ideas y funciones para tu juego

Tu próxima función

Tabla de Clasificación

Guarda la puntuación después de cada partida y muestra quién va primero.

Requiere una sesión de jugador
Godot
Ilustración de Tabla de Clasificación
El resultado visible

Tu puntuación de prueba aparece en la clasificación después de una partida.

Ver las clasificaciones3:54

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗

Preparar el mismo proyecto

  1. Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

    Tabla de Clasificación →
  2. Cread o reutilizad estas entradas de prueba en el formulario del panel. Son valores de ejemplo, no datos actuales.

    Clave (slug)
    weekly
    Orden de clasificación
    DESC
    Aceptar puntuaciones solo de partidas validadas
    false
  3. Guardad, recargad y verificad las entradas antes del ejemplo. Conservad las demás definiciones.

Implementa esta función

Puedes consultar la guía. Para ejecutarla necesitas una clave de proyecto activa. Preparar el proyecto

SDK instalado, configuración del proyecto importada y jugador conectado.

Guardad el GDScript, añadidlo a un nodo de la escena principal y ejecutadla. Revisad Output.

GDScript
res://scripts/leaderboard.gd
Llamada a horizOnPreparación
1# Añade este script a un nodo de tu escena principal.
2extends Node
3​
4​
5func _ready() -> void:
6 # Preparación: inicializar, conectar e iniciar la sesión de un jugador.
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: enviar una puntuación, leer la clasificación y el propio
21 # puesto.
22 var submitted: bool = await Horizon.leaderboard.submitScore(12500, "weekly")
23 if not submitted:
24 push_warning(Horizon.leaderboard.getLastErrorCode())
25 return
26 var top = await Horizon.leaderboard.getTop(10, false, "weekly")
27 for entry in top:
28 print("#%d %s: %d" % [entry.position, entry.username, entry.score])
29 var rank = await Horizon.leaderboard.getRank("weekly")
30 if rank != null:
31 print("Your rank: ", rank.position)
Abrir el ejemplo completo del SDK ↗

Prueba tu nueva función.

Tu puntuación de prueba aparece en la clasificación después de una partida.

Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

Endpoints de la API
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Todos los endpoints en la referencia de la API