Pomysły i funkcje gry

Twoja następna funkcja

Wartości gracza

Waluty, liczniki i energia zarządzane przez serwer. Definiuj salda, oferty i sprawdzane zmiany dla każdego projektu.

SDK: developWymagana sesja gracza
Godot
Ilustracja funkcji Wartości gracza
Widoczny rezultat

Gra pokazuje skonfigurowane salda i oferty. Zakupy zwracają aktualny stan gracza.

Wideo pojawi się później

Ten krok nie ma jeszcze wideo. Instrukcja i polecenie MCP są już dostępne.

Wartości gracza

Przygotuj ten sam projekt

  1. Wybierz w panelu ten sam projekt co w konfiguracji gry.

    Wartości gracza →
  2. Utwórz lub wykorzystaj te wpisy testowe w formularzu panelu. To wartości przykładowe, nie aktualne dane projektu.

    Wartości
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    Zezwalaj na bezpośrednie zmiany
    false
    Oferty
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    Saldo początkowe jest przyznawane raz dla danego klucza. Bezpośrednie zmiany są domyślnie wyłączone. Validated Actions zachowuje limity na rozgrywkę; limity dzienne i salda pochodzą z tych definicji. Puste opcjonalne limity oznaczają brak ograniczenia.

  3. Zapisz, wczytaj ponownie i sprawdź wpisy przed uruchomieniem przykładu. Zachowaj pozostałe definicje.

Dodaj tę funkcję

Możesz przeglądać poradnik. Uruchomienie wymaga aktywnego klucza projektu. Przygotuj projekt

Zainstalowany SDK, zaimportowana konfiguracja projektu i zalogowany gracz.

Ten przykład SDK korzysta z develop. Sprawdź, czy wymagane API istnieją w zainstalowanym SDK.

Połącz wybranego gracza zgodnie z szybkim startem. Wywołaj run_reviewed_action() jawnym przyciskiem lub akcją sceny. Samo otwarcie pliku nie wysyła żądania.

GDScript
res://scripts/player_values.gd
Wywołanie 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.
Otwórz pełny przykład SDK ↗

Przetestuj nową funkcję.

Gra pokazuje skonfigurowane salda i oferty. Zakupy zwracają aktualny stan gracza.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
Wszystkie punkty końcowe w dokumentacji API
Ilustracja funkcji Rankingi
Nasza propozycja następnego kroku

Daj każdej rundzie najlepszy wynik.

Zapisz wynik po rundzie i pokaż, kto prowadzi. Nadal korzystaj z połączenia i sesji gracza.