Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Classificação

Guarda a pontuação depois de cada partida e mostra quem está à frente.

Requer uma sessão de jogador
Godot
Ilustração de Classificação
O resultado visível

A tua pontuação de teste aparece na classificação depois de uma partida.

Ver a classificação do placar3:54

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗

Preparar o mesmo projeto

  1. Seleciona no painel o mesmo projeto que na configuração do teu jogo.

    Classificação →
  2. Criem ou reutilizem estas entradas de teste no formulário do painel. São valores de exemplo, não dados atuais.

    Chave (slug)
    weekly
    Ordem de classificação
    DESC
    Aceitar pontuações apenas de partidas validadas
    false
  3. Guardem, recarreguem e verifiquem as entradas antes do exemplo. Preservem as restantes definições.

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

Guardem o GDScript, associem-no a um nó da cena principal e executem-na. Verifiquem Output.

GDScript
res://scripts/leaderboard.gd
Chamada ao horizOnPreparação
1# Adiciona este script a um nó da tua cena principal.
2extends Node
3​
4​
5func _ready() -> void:
6 # Preparação: inicializar, conectar e iniciar a sessão de um jogador.
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 uma pontuação, ler a classificação e a própria
21 # posição.
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 o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

A tua pontuação de teste aparece na classificação depois de uma partida.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Endpoints da API
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
Todos os endpoints na referência da API