Spielideen & Features

Euer nächstes Feature

Geschenkcodes

Spieler Gift Codes eingeben und einlösen lassen.

Spielersession erforderlich
Godot
Illustration für Geschenkcodes
Euer sichtbares Ergebnis

Ein Testcode wird eingelöst. Erneutes Einlösen folgt euren Regeln.

Gift Code erstellen1:36
Video separat öffnen ↗
Video folgt

Für diesen Schritt fehlt noch das Video. Die Anleitung und der MCP-Auftrag sind bereits nutzbar.

Serverseitige Spielerwerte

Dasselbe Projekt vorbereiten

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

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

    Code
    WELCOME
    Geschenkdaten (JSON)
    {}
    Max. pro Benutzer
    1

    Bis zu acht konfigurierte Werte schreibt der Server beim Einlösen gut. giftData bleibt eine getrennte Spielnutzlast. Zeige den zurückgegebenen Stand an; addiere die Belohnung nicht erneut lokal.

    Spielerwerte →
  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.

Bis zu acht konfigurierte Werte schreibt der Server beim Einlösen gut. giftData bleibt eine getrennte Spielnutzlast. Zeige den zurückgegebenen Stand an; addiere die Belohnung nicht erneut lokal. 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/gift_codes.gd
horizOn-AufrufEinrichtung
1# Hängt dieses Skript an einen Node in eurer Hauptszene.
2extends Node
3​
4​
5func _ready() -> void:
6 # Einrichtung: initialisieren, verbinden und einen Spieler anmelden.
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: Geschenkcode prüfen und einlösen.
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Ein Testcode wird eingelöst. Erneutes Einlösen folgt euren Regeln.

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

Endpunkte
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
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.