Ideas y funciones para tu juego

Tu próxima función

Mercado

Intercambia un objeto original entre dos jugadores.

SDK: developRequiere una sesión de jugador
Godot
Ilustración de Mercado
El resultado visible

El comprador recibe el mismo objeto y el vendedor recibe el precio acordado menos la comisión configurada.

Vídeo próximamente

Este paso aún no tiene vídeo. La guía y la solicitud MCP ya se pueden utilizar.

Mercado

Preparar el mismo proyecto

  1. Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

    Mercado →
  2. La primera petición no necesita otra definición. Un resultado vacío es válido mientras no existan datos del juego.

    Configurad una moneda, una comisión y al menos una regla de precio activa.

    Usa dos jugadores con sesión iniciada en el mismo proyecto. Configura la moneda, la comisión y la regla de precios, publica un objeto sin equipar y confirma expresamente su compra.

    Objetos →Valores del jugador →

Implementa esta función

Puedes consultar la guía. Para ejecutarla necesitas una clave de proyecto activa. Preparar el proyecto

SDK instalado, configuración del proyecto importada y jugador conectado.

Este ejemplo del SDK usa develop. Comprueba si las API necesarias están disponibles en el SDK instalado.

Completad la conexión de inicio rápido con el jugador elegido. Llamad a read_listing(listing_id) mediante un botón o acción de escena explícita. Abrir el archivo no envía peticiones.

GDScript
res://scripts/marketplace.gd
Llamada a 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.
Abrir el ejemplo completo del SDK ↗

Probar con dos jugadores

Usa dos jugadores con sesión iniciada en el mismo proyecto. Configura la moneda, la comisión y la regla de precios, publica un objeto sin equipar y confirma expresamente su compra.

Usa la sesión iniciada existente. Tras una compra sin confirmar, conserva y reintenta la misma solicitud original y actualiza después el inventario y los saldos.

La cancelación protege el objeto original hasta que su propietario lo recoja. La recuperación solo está disponible si se eliminó al propietario anterior.

Los anuncios y la protección contra repeticiones se almacenan una sola vez en el proyecto. Los jugadores conservan referencias y datos de estado limitados.

Prueba tu nueva función.

El comprador recibe el mismo objeto y el vendedor recibe el precio acordado menos la comisión configurada.

Selecciona en el panel el mismo proyecto que en la configuración de tu juego.

Endpoints de la API
  • 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
Todos los endpoints en la referencia de la API
Ilustración de Tablas de clasificación
Nuestra sugerencia para el siguiente paso

Dale una puntuación máxima a cada partida.

Guarda la puntuación después de una partida y muestra quién va primero. Sigue usando tu conexión y la sesión del jugador.