Ideas y funciones para tu juego

Tu próxima función

Acciones validadas

Haz que el servidor valide las acciones de juego.

SDK: developRequiere una sesión de jugador
Godot
Ilustración de Acciones validadas
El resultado visible

Se acepta una acción válida y se rechaza una acción inválida.

Validar acciones del juego3:12

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.

    Acciones validadas →
  2. Cread o reutilizad estas entradas de prueba en el formulario del panel. Son valores de ejemplo, no datos actuales.

    Clave (slug)
    weekly
    Aceptar puntuaciones solo de partidas validadas
    true
    Puntuación máxima
    20000
    Duración mínima (segundos)
    0
    Fase obligatoria
    false

    Guardad estas reglas en un proyecto de prueba sin otros límites. Los bytes fijos quickstart prueban el protocolo. La puntuación 18250 debe aceptarse. Iniciad otra partida con 20001 para comprobar el rechazo. En el juego, registrad entradas reales.

    Tabla de Clasificación →
  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.

Este ejemplo del SDK usa develop. Comprueba si las API necesarias están disponibles en el SDK instalado.

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

GDScript
res://scripts/validated_actions.gd
Llamada a horizOnPreparación
1# Añade este script a un nodo de tu escena principal.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Preparación: inicializar, conectar e iniciar la sesión de un jugador.
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 una partida, grabar las entradas y enviar la
23 # puntuación 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 el ejemplo completo del SDK ↗

Prueba tu nueva función.

Se acepta una acción válida y se rechaza una acción inválida.

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

Endpoints de la API
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Todos los endpoints en la referencia de la API
Ilustración de Tablas de clasificación
Nuestra sugerencia para el siguiente paso

Dale una puntuación máxima a cada partida.

Guarda la puntuación después de una partida y muestra quién va primero. Sigue usando tu conexión y la sesión del jugador.

Vídeo tutorial

Acciones validadasGodot6:05

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗
Valores gestionados por el servidorGodot4:58

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗
Registro de entradasGodot5:45

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗