Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Ações validadas

Faz o servidor validar as ações do jogo.

SDK: developRequer uma sessão de jogador
Godot
Ilustração de Ações validadas
O resultado visível

Uma ação válida é aceite e uma ação inválida é rejeitada.

Validar ações do jogo3:12

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.

    Ações validadas →
  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
    Aceitar pontuações apenas de partidas validadas
    true
    Pontuação máxima
    20000
    Duração mínima (segundos)
    0
    Fase obrigatória
    false

    Guardem estas regras num projeto de teste sem outros limites. Os bytes fixos quickstart testam o protocolo. A pontuação 18250 deve passar. Iniciem outra partida com 20001 para testar a rejeição. No jogo, registem entradas reais.

    Classificação →
  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.

Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

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

GDScript
res://scripts/validated_actions.gd
Chamada ao horizOnPreparação
1# Adiciona este script a um nó da tua cena principal.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Preparação: inicializar, conectar e iniciar a sessão de um jogador.
9 var connected = await Horizon.connect_to_server()
10 if not connected:
11 print("Failed to connect to horizOn server")
12 return
13 if not Horizon.auth.isSignedIn():
14 var signed_in: bool
15 if Horizon.auth.hasCachedAnonymousToken():
16 signed_in = await Horizon.auth.restoreAnonymousSession()
17 else:
18 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
19 if not signed_in:
20 return
21​
22 # horizOn: iniciar uma partida, gravar os inputs, enviar a pontuação
23 # validada.
24 # 1. Dashboard: turn on "Validated submissions only" for the board "weekly"
25​
26 # 2. Round start: single-use ticket plus server seed
27 var run: Dictionary = await Horizon.validatedActions.startRun("weekly")
28 if run.is_empty():
29 print(Horizon.validatedActions.getLastErrorCode()) # e.g. RUN_RATE_LIMITED
30 return
31 var rng := RandomNumberGenerator.new()
32 rng.seed = run["seed"]
33​
34 # Protocol test input only. Replace it with actual recorded game inputs in your game.
35​
36 # 3. Round end: score plus input log (the SDK sends its SHA-256 hash)
37 var result: Dictionary = await Horizon.validatedActions.submitValidated(18250, input_log)
38 if result.is_empty():
39 print(Horizon.validatedActions.getLastErrorCode())
40 return
41 print("Accepted score=", result.get("score"), ", rank=", result.get("rank"))
Abrir o exemplo SDK completo ↗

Testa a tua nova funcionalidade.

Uma ação válida é aceite e uma ação inválida é rejeitada.

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

Endpoints da API
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Todos os endpoints na referência da API
Ilustração de Tabelas de classificação
A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.

Vídeo tutorial

Ações validadasGodot6:05

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗
Valores controlados pelo servidorGodot4:58

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗
Log de entradasGodot5:45

Este tutorial é reproduzido em inglês.

Abrir vídeo separadamente ↗