Spielideen & Features

Euer nächstes Feature

Items

Einzelne Ausrüstung mit Eigenschaften, Katalogregeln und übersichtlichem Spielerinventar.

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

Nach dem Speichern enthält der Katalog starter_sword. Nach dem geprüften Beispielkauf enthält das aktuelle Inventar dessen eindeutige instanceId.

Video folgt

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

Items

Dasselbe Projekt vorbereiten

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

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

    Schlüssel
    starter_sword
    Name
    Quickstart Sword
    Typ
    equipment
    Seltenheit
    common
    Aktiv
    true
    Basiseigenschaften
    {"damage":5}
    Eigenschaftsregeln
    []

    Items sind Einzelstücke mit eigener ID und Eigenschaften. Zählbare Ressourcen gehören in Spielerwerte, reine Kosmetik ins Spielerprofil.

    Bereitet coins mit der Spielerwerte-Anleitung vor. Speichert danach das aktive Angebot starter-sword: Kosten 10 coins, Item-Belohnung 1 starter_sword.

    Spielerwerte →
  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 read_catalog_page(), read_inventory() ausdrücklich über einen Button oder eine Szenenaktion auf. Allein das Öffnen der Datei sendet keine Anfrage.

GDScript
res://scripts/items.gd
horizOn-Aufruf
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.
Vollständiges SDK-Beispiel öffnen ↗

Das gespeicherte Item nutzen

Importiert das offizielle Beispiel samt Hilfsdateien. Prüft das Angebot und führt die folgende Reihenfolge mit dem bestehenden Spieler aus. Wartet auf jeden Schritt und bestätigt den Kauf einmal. Erhaltet nach unklarer Antwort die Originalanfrage.

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

Testet euer neues Feature.

Nach dem Speichern enthält der Katalog starter_sword. Nach dem geprüften Beispielkauf enthält das aktuelle Inventar dessen eindeutige instanceId.

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

Endpunkte
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
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.