Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Objets

Équipement unique, propriétés encadrées et inventaire des joueurs du projet sélectionné.

SDK : developSession de joueur requise
Godot
Illustration de Objets
Votre résultat visible

Après enregistrement, le catalogue contient starter_sword. Après l’achat vérifié, l’inventaire actuel contient son instanceId unique.

Vidéo à venir

Cette étape n’a pas encore de vidéo. Le guide et la demande MCP sont utilisables.

Objets

Préparer le même projet

  1. Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

    Objets →
  2. Créez ou réutilisez ces entrées de test dans le formulaire du tableau de bord. Ce sont des exemples, pas les données actuelles.

    Clé
    starter_sword
    Nom
    Quickstart Sword
    Type
    equipment
    Rareté
    common
    Actif
    true
    Propriétés de base
    {"damage":5}
    Règles de propriété
    []

    Les objets ont une identité et des propriétés propres. Les ressources comptables restent dans les valeurs du joueur ; les éléments purement visuels restent dans son profil.

    Préparez coins avec le guide des valeurs. Enregistrez l’offre active starter-sword : coût de 10 coins, récompense de 1 starter_sword.

    Valeurs du joueur →
  3. Enregistrez, rechargez et vérifiez les entrées avant l’exemple. Conservez les autres définitions.

Intégrer cette fonctionnalité

Vous pouvez consulter le guide. Son exécution nécessite une clé de projet active. Préparer le projet

SDK installé, configuration du projet importée et joueur connecté.

Cet exemple du SDK utilise develop. Vérifiez que les API nécessaires existent dans votre SDK installé.

Terminez la connexion du démarrage rapide avec le joueur choisi. Appelez read_catalog_page(), read_inventory() via un bouton ou une action de scène explicite. Ouvrir le fichier seul n’envoie aucune requête.

GDScript
res://scripts/items.gd
Appel 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.
Ouvrir l’exemple SDK complet ↗

Utiliser l’objet enregistré

Importez l’exemple officiel et ses fichiers auxiliaires. Vérifiez l’offre et suivez la séquence avec le joueur actuel. Attendez chaque étape et confirmez l’achat une seule fois. Gardez la requête originale si la réponse est incertaine.

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

Testez votre nouvelle fonctionnalité.

Après enregistrement, le catalogue contient starter_sword. Après l’achat vérifié, l’inventaire actuel contient son instanceId unique.

Sélectionnez dans le tableau de bord le même projet que dans la configuration de votre jeu.

Points de terminaison
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
Tous les points de terminaison dans la référence API
Illustration de Classements
Notre suggestion pour la suite

Donnez un meilleur score à chaque partie.

Enregistrez le score après une partie et montrez qui est en tête. Continuez avec votre connexion et la session du joueur.