Idee e funzionalità per il gioco

La tua prossima funzionalità

Oggetti

Equipaggiamento unico con proprietà, regole di catalogo e inventario del progetto selezionato.

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

Dopo il salvataggio, il catalogo contiene starter_sword. Dopo l’acquisto verificato, l’inventario attuale contiene il suo instanceId univoco.

Video in arrivo

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

Oggetti

Preparare lo stesso progetto

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

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

    Chiave
    starter_sword
    Nome
    Quickstart Sword
    Tipo
    equipment
    Rarità
    common
    Attivo
    true
    Proprietà di base
    {"damage":5}
    Regole delle proprietà
    []

    Gli oggetti hanno identità e proprietà individuali. Le risorse contabili restano nei Valori giocatore; gli elementi solo cosmetici restano nel Profilo giocatore.

    Preparate coins con la guida ai valori. Salvate l’offerta attiva starter-sword: costo 10 coins, premio 1 starter_sword.

    Valori del giocatore →
  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 read_catalog_page(), read_inventory() tramite un pulsante o un’azione esplicita della scena. Aprire il file non invia richieste.

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

Usare l’oggetto salvato

Importate l’esempio ufficiale e i relativi file di supporto. Verificate l’offerta ed eseguite la sequenza con il giocatore attuale. Attendete ogni passaggio e confermate l’acquisto una sola volta. Conservate la richiesta originale dopo una risposta incerta.

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

Prova la tua nuova funzionalità.

Dopo il salvataggio, il catalogo contiene starter_sword. Dopo l’acquisto verificato, l’inventario attuale contiene il suo instanceId univoco.

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

Endpoint dell'API
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
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.