Idee e funzionalità per il gioco

La tua prossima funzionalità

Valori del giocatore

Valute, contatori ed energia gestiti dal server. Definisci saldi, offerte e modifiche verificate per ogni progetto.

SDK: developSessione del giocatore richiesta
Godot
Illustrazione di Valori del giocatore
Il risultato visibile

Il gioco mostra i saldi e le offerte configurati. Gli acquisti restituiscono lo stato attuale del giocatore.

Video in arrivo

Questo passaggio non ha ancora un video. La guida e la richiesta MCP sono già utilizzabili.

Valori del giocatore

Preparare lo stesso progetto

  1. Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

    Valori del giocatore →
  2. Create o riutilizzate queste voci di prova nel modulo del pannello. Sono valori di esempio, non dati attuali.

    Valori
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    Consenti modifiche dirette
    false
    Offerte
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    Il saldo iniziale viene assegnato una sola volta per chiave. Le modifiche dirette sono inizialmente disattivate. Validated Actions mantiene i limiti per partita; i limiti giornalieri e di saldo provengono da queste definizioni. Un limite facoltativo vuoto significa nessun limite.

  3. Salvate, ricaricate e verificate le voci prima dell’esempio. Conservate le altre definizioni.

Integra questa funzionalità

Puoi consultare la guida. Per eseguirla serve una chiave di progetto attiva. Prepara il progetto

SDK installato, configurazione del progetto importata e giocatore connesso.

Questo esempio del SDK usa develop. Verifica che le API necessarie siano disponibili nel SDK installato.

Completate la connessione rapida con il giocatore scelto. Chiamate run_reviewed_action() tramite un pulsante o un’azione esplicita della scena. Aprire il file non invia richieste.

GDScript
res://scripts/player_values.gd
Chiamata horizOn
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.
Aprire l’esempio SDK completo ↗

Prova la tua nuova funzionalità.

Il gioco mostra i saldi e le offerte configurati. Gli acquisti restituiscono lo stato attuale del giocatore.

Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

Endpoint dell'API
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
Tutti gli endpoint nel riferimento API
Illustrazione di Classifiche
Il nostro suggerimento per il prossimo passo

Dai un record a ogni partita.

Salva il punteggio dopo una partita e mostra chi è in testa. Continua a usare la connessione e la sessione del giocatore.