Spelideeën en functies

Je volgende functie

Cadeaucodes

Laat spelers cadeaucodes invoeren en inwisselen.

Spelerssessie vereist
Godot
Illustratie van Cadeaucodes
Je zichtbare resultaat

Een testcode wordt ingewisseld. Opnieuw inwisselen volgt je regels.

Een cadeaucode aanmaken1:42

Deze tutorial wordt in het Engels afgespeeld.

Video apart openen ↗
Video volgt

Voor deze stap is nog geen video. De handleiding en MCP-opdracht zijn al bruikbaar.

Spelerwaarden op de server

Hetzelfde project voorbereiden

  1. Kies in het dashboard hetzelfde project als in de configuratie van je spel.

    Cadeaucodes →
  2. Maak of hergebruik deze testgegevens in het dashboardformulier. Dit zijn voorbeeldwaarden, geen huidige projectgegevens.

    Code
    WELCOME
    Cadeaugegevens (JSON)
    {}
    Max. per Gebruiker
    1

    De server kent bij inwisseling maximaal acht ingestelde waarden toe. giftData blijft aparte speldata. Toon het ontvangen saldo en tel de beloning niet opnieuw lokaal op.

    Spelerwaarden →
  3. Sla de gegevens op, laad ze opnieuw en controleer ze vóór het voorbeeld. Behoud andere definities.

Bouw deze functie

Je kunt de handleiding bekijken. Voor uitvoering heb je een actieve projectsleutel nodig. Project voorbereiden

SDK geïnstalleerd, projectconfiguratie geïmporteerd en speler aangemeld.

De server kent bij inwisseling maximaal acht ingestelde waarden toe. giftData blijft aparte speldata. Toon het ontvangen saldo en tel de beloning niet opnieuw lokaal op. Dit SDK-voorbeeld gebruikt develop. Controleer of de benodigde API's in je geïnstalleerde SDK bestaan.

Sla het GDScript op, koppel het aan een knooppunt in de hoofdscène en voer die uit. Controleer Output.

GDScript
res://scripts/gift_codes.gd
horizOn-aanroepVoorbereiding
1# Koppel dit script aan een node in je hoofdscène.
2extends Node
3​
4​
5func _ready() -> void:
6 # Voorbereiding: initialiseren, verbinden en een speler aanmelden.
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: een cadeaucode controleren en inwisselen.
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.
Volledig SDK-voorbeeld openen ↗

Test je nieuwe functie.

Een testcode wordt ingewisseld. Opnieuw inwisselen volgt je regels.

Kies in het dashboard hetzelfde project als in de configuratie van je spel.

Eindpunten
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
Alle eindpunten in de API-referentie
Illustratie van Leaderboards
Onze suggestie voor je volgende stap

Geef elke ronde een topscore.

Sla de score na een ronde op en laat zien wie vooropstaat. Blijf je verbinding en de sessie van de speler gebruiken.