Spielideen & Features

Euer nächstes Feature

Spielerwerte

Serverseitige Währungen, Zähler und Energie. Werte, Angebote und geprüfte Änderungen pro Projekt festlegen.

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

Dein Spiel zeigt konfigurierte Werte und Angebote. Käufe liefern den aktuellen Spielerstand zurück.

Video folgt

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

Spielerwerte

Dasselbe Projekt vorbereiten

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

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

    Werte
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    Direkte Änderungen erlauben
    false
    Angebote
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    Startwerte werden je Wertschlüssel einmal vergeben. Direkte Änderungen sind anfangs aus. Validated Actions behält seine Grenzen pro Lauf; Tages- und Standgrenzen kommen aus diesen Definitionen. Leere optionale Grenzen bedeuten unbegrenzt.

  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.

Verbindet zuerst den vorgesehenen Spieler über den Schnellstart. Ruft run_reviewed_action() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

GDScript
res://scripts/player_values.gd
horizOn-Aufruf
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var current: Dictionary = await Horizon.playerValues.getState(user_id)
10 if not current.success:
11 push_error(current.errorCode)
12 return
13 print(current.state.values)
14 # Authoritative balances only; never add a copied historical reward locally.
15 # Purchases and exact original retry use the official player_values_example.gd
16 # and pending_purchase.gd. Persist the original user/offer/operationId before send.
17 # Keep an uncertain or expired original; do not silently create another ID.
Vollständiges SDK-Beispiel öffnen ↗

Testet euer neues Feature.

Dein Spiel zeigt konfigurierte Werte und Angebote. Käufe liefern den aktuellen Spielerstand zurück.

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

Endpunkte
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
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.