Spielideen & Features

Euer nächstes Feature

Validierte Aktionen

Spielaktionen serverseitig prüfen lassen.

SDK: developSpielersession erforderlich
Godot
Illustration für Validierte Aktionen
Euer sichtbares Ergebnis

Eine gültige Aktion wird angenommen und eine ungültige abgewiesen.

Spielaktionen validieren3:08
Video separat öffnen ↗

Dasselbe Projekt vorbereiten

  1. Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

    Validierte Aktionen →
  2. Erstellt diese Testeinträge im Dashboard-Formular oder verwendet passende vorhandene Einträge. Die Werte sind Beispieldaten, kein aktueller Projektstand.

    Key (Slug)
    weekly
    Punkte nur aus validierten Runs annehmen
    true
    Höchster Punktestand
    20000
    Mindestdauer (Sekunden)
    0
    Abschnitt erforderlich
    false

    Speichert diese Regeln in einem Testprojekt ohne weitere Grenzen. Die festen quickstart-Bytes prüfen das Anfrageprotokoll. Score 18250 sollte angenommen werden. Startet einen neuen Lauf mit 20001 für die Ablehnung. Zeichnet im Spiel echte Eingaben auf.

    Leaderboard →
  3. Speichert die Einträge, ladet sie neu und prüft sie vor dem Beispiel. Erhaltet andere vorhandene Definitionen.

Feature einbauen

Ihr könnt die Anleitung vorab ansehen. Zum Ausführen braucht ihr einen aktiven Projekt-Key. Projekt vorbereiten

SDK installiert, Projekt-Konfiguration importiert und Spieler angemeldet.

Dieses SDK-Beispiel nutzt develop. Prüft, ob die nötigen APIs in eurem installierten SDK verfügbar sind.

Speichert das GDScript, hängt es an einen Knoten der Hauptszene und startet die Szene. Prüft Output.

GDScript
res://scripts/validated_actions.gd
horizOn-AufrufEinrichtung
1# Hängt dieses Skript an einen Node in eurer Hauptszene.
2extends Node
3​
4var input_log: PackedByteArray = "quickstart".to_utf8_buffer()
5​
6​
7func _ready() -> void:
8 # Einrichtung: initialisieren, verbinden und einen Spieler anmelden.
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: Run starten, Eingaben aufzeichnen, geprüfte Punktzahl
23 # einreichen.
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"))
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Eine gültige Aktion wird angenommen und eine ungültige abgewiesen.

Wählt im Dashboard dasselbe Projekt wie in eurer Spielkonfiguration.

Endpunkte
  • POST/validated-actions/runs
  • POST/validated-actions/submit
Alle Endpunkte in der API-Referenz
Illustration für Bestenlisten
Unser Vorschlag für den nächsten Schritt

Gebt jeder Runde einen Highscore.

Speichert den Score nach dem Spiel und zeigt, wer vorne liegt. Eure Verbindung und Spielersession nutzt ihr weiter.

Tutorial-Video

Validierte AktionenGodot5:34
Video separat öffnen ↗
Servereigene WerteGodot4:52
Video separat öffnen ↗
EingabeprotokollGodot5:19
Video separat öffnen ↗