Idées et fonctionnalités de jeu

Votre prochaine fonctionnalité

Marché

Échanger un objet original entre deux joueurs.

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

L’acheteur reçoit le même objet et le vendeur reçoit le prix convenu, moins les frais configurés.

Vidéo à venir

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

Marché

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.

    Marché →
  2. Aucune définition supplémentaire pour la première requête. Un résultat vide est valide tant que les données du jeu manquent.

    Définissez une monnaie, des frais et au moins une règle de prix active.

    Utilisez deux joueurs connectés au même projet. Configurez la monnaie, les frais et la règle de prix, puis proposez un objet non équipé et confirmez explicitement son achat.

    Objets →Valeurs du joueur →

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_listing(listing_id) via un bouton ou une action de scène explicite. Ouvrir le fichier seul n’envoie aucune requête.

GDScript
res://scripts/marketplace.gd
Appel horizOn
1extends Node
2​
3const MarketStart = preload("res://addons/horizon_sdk/examples/features/marketplace_quickstart.gd")
4# Attach marketplace_example.gd to this screen, set its stable project_id,
5# and use the existing authenticated Horizon session for this project.
6@export var screen: Node
7​
8func read_listing(listing_id: String) -> Dictionary:
9 return await MarketStart.read_one_listing(screen, listing_id)
10​
11# Wire only to explicit Buy confirmation after displaying a successful read.
12func confirm_purchase(listing_id: String) -> Dictionary:
13 return await MarketStart.buy_reviewed_listing(screen, listing_id)
14​
15# Unknown outcome: await screen.retry_pending() or recover_original_operation().
16# Keep the original until Inventory, Values and Marketplace have refreshed.
17# Never delete a pending operation or unknown send-owner lock to buy again.
Ouvrir l’exemple SDK complet ↗

Tester avec deux joueurs

Utilisez deux joueurs connectés au même projet. Configurez la monnaie, les frais et la règle de prix, puis proposez un objet non équipé et confirmez explicitement son achat.

Utilisez la session déjà connectée. Après un achat non confirmé, conservez et renvoyez la même demande initiale, puis actualisez l’inventaire et les soldes.

L’annulation protège l’objet original jusqu’à sa récupération par son propriétaire. La réattribution n’est possible que si le propriétaire précédent a été supprimé.

Les annonces et la protection contre les répétitions sont stockées une seule fois dans le projet. Les joueurs conservent des références et des données d’état limitées.

Testez votre nouvelle fonctionnalité.

L’acheteur reçoit le même objet et le vendeur reçoit le prix convenu, moins les frais configurés.

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

Points de terminaison
  • GET/marketplace/limits
  • GET/marketplace/rules
  • GET/marketplace
  • GET/marketplace/listings
  • GET/marketplace/listings/{listingId}
  • POST/marketplace/listings
  • POST/marketplace/listings/{listingId}/buy
  • POST/marketplace/listings/{listingId}/cancel
  • GET/marketplace/operations/{operationId}
  • POST/marketplace/listings/{listingId}/retry-return
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.