Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Actions validées

Faites valider les actions de jeu par le serveur.

SDK : developSession de joueur requise
Godot
Illustration de Actions validées
Votre résultat visible

Une action valide est acceptée et une action invalide est rejetée.

Valider les actions du jeu3:12

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗

Préparer le même projet

  1. Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

    Actions validées →
  2. Créez ou réutilisez ces entrées de test dans le formulaire du tableau de bord. Ce sont des exemples, pas les données actuelles.

    Clé (slug)
    weekly
    N'accepter que les scores des parties validées
    true
    Score maximal
    20000
    Durée minimale (secondes)
    0
    Étape obligatoire
    false

    Enregistrez ces règles dans un projet de test sans autres limites. Les octets fixes quickstart testent le protocole. Le score 18250 doit être accepté. Lancez une nouvelle partie avec 20001 pour vérifier le refus. En jeu, enregistrez les véritables entrées.

    Classement →
  3. Enregistrez, rechargez et vérifiez les entrées avant l’exemple. Conservez les autres définitions.

Intégrer cette fonctionnalité

Vous pouvez consulter le guide. Son exécution nécessite une clé de projet active. Préparer le projet

SDK installé, configuration du projet importée et joueur connecté.

Cet exemple du SDK utilise develop. Vérifiez que les API nécessaires existent dans votre SDK installé.

Enregistrez le GDScript, attachez-le à un nœud de la scène principale et lancez-la. Vérifiez Output.

GDScript
res://scripts/validated_actions.gd
Appel horizOnMise en place
1# Attache ce script à un nœud de ta scène principale.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Mise en place : initialiser, se connecter et connecter un joueur.
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 : démarrer une partie, enregistrer les entrées, envoyer le
23 # score validé.
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"))
Ouvrir l’exemple SDK complet ↗

Testez votre nouvelle fonctionnalité.

Une action valide est acceptée et une action invalide est rejetée.

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

Points de terminaison
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Tous les points de terminaison dans la référence API
Illustration de Classements
Notre suggestion pour la suite

Donnez un meilleur score à chaque partie.

Enregistrez le score après une partie et montrez qui est en tête. Continuez avec votre connexion et la session du joueur.

Vidéo tutoriel

Actions validéesGodot6:05

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗
Valeurs gérées par le serveurGodot4:58

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗
Journal d'entréesGodot5:45

Ce tutoriel est diffusé en anglais.

Ouvrir la vidéo séparément ↗