Pomysły i funkcje gry

Twoja następna funkcja

Przedmioty

Unikalne wyposażenie z właściwościami, regułami katalogu i ekwipunkiem w wybranym projekcie.

SDK: developWymagana sesja gracza
Godot
Ilustracja funkcji Przedmioty
Widoczny rezultat

Po zapisaniu katalog zawiera starter_sword. Po sprawdzonym zakupie bieżący ekwipunek zawiera jego unikatowy instanceId.

Wideo pojawi się później

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

Przedmioty

Przygotuj ten sam projekt

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

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

    Klucz
    starter_sword
    Nazwa
    Quickstart Sword
    Typ
    equipment
    Rzadkość
    common
    Aktywny
    true
    Właściwości bazowe
    {"damage":5}
    Reguły właściwości
    []

    Przedmioty mają własną tożsamość i właściwości. Zasoby liczbowe pozostają w Wartościach gracza, a elementy wyłącznie wizualne w Profilu gracza.

    Przygotuj coins według przewodnika wartości. Zapisz aktywną ofertę starter-sword: koszt 10 coins, nagroda przedmiotowa 1 starter_sword.

    Wartości gracza →
  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 read_catalog_page(), read_inventory() jawnym przyciskiem lub akcją sceny. Samo otwarcie pliku nie wysyła żądania.

GDScript
res://scripts/items.gd
Wywołanie horizOn
1extends Node
2​
3# Connect and restore the existing player first. Each function is an explicit action.
4func read_inventory() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.items.getInventory(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 for item in result.data.instances:
13 print(item.instanceId, ": ", item.itemKey)
14 # Keep result.data.revision for a separately reviewed mutation.
15​
16func read_catalog_page() -> void:
17 var user = Horizon.auth.getCurrentUser()
18 if user == null:
19 return
20 var result = await Horizon.items.getCatalog(user.userId, "", 1)
21 if not result.success:
22 push_warning(result.errorCode)
23 return
24 print("Catalog revision: ", result.data.revision)
25 # Explicit Next retains revision and nextAfterKey; no automatic page loop.
26# Durable mutations: addons/horizon_sdk/examples/features/items_example.gd.
27# Preserve original instance/body/revision and the original PV purchase operationId.
28# Initial success may include item references; retained replay may return empty applied/items.
29# Read the current inventory separately; never reconstruct earlier item references.
30# A failed refresh never authorizes another purchase or a local item grant.
Otwórz pełny przykład SDK ↗

Użyj zapisanego przedmiotu

Zaimportuj oficjalny przykład i pliki pomocnicze. Sprawdź ofertę i wykonaj sekwencję z bieżącym graczem. Poczekaj na każdy krok i potwierdź zakup raz. Zachowaj oryginalne żądanie po niepewnej odpowiedzi.

items_example.gd: load_catalog_page() → review_offer("starter-sword") → purchase_reviewed_offer() → refresh_inventory()

Przetestuj nową funkcję.

Po zapisaniu katalog zawiera starter_sword. Po sprawdzonym zakupie bieżący ekwipunek zawiera jego unikatowy instanceId.

Wybierz w panelu ten sam projekt co w konfiguracji gry.

Punkty końcowe
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
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.