Ideas y funciones para tu juego

Tu próxima función

Objetos

Equipo único con propiedades, reglas de catálogo e inventario del proyecto seleccionado.

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

Al guardar, el catálogo contiene starter_sword. Tras la compra revisada, el inventario actual contiene su instanceId único.

Vídeo próximamente

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

Objetos

Preparar el mismo proyecto

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

    Objetos →
  2. Cread o reutilizad estas entradas de prueba en el formulario del panel. Son valores de ejemplo, no datos actuales.

    Clave
    starter_sword
    Nombre
    Quickstart Sword
    Tipo
    equipment
    Rareza
    common
    Activo
    true
    Propiedades base
    {"damage":5}
    Reglas de propiedades
    []

    Los objetos tienen identidad y propiedades propias. Los recursos contables pertenecen a Valores del jugador y los cosméticos visuales al Perfil del jugador.

    Preparad coins con la guía de valores. Guardad la oferta activa starter-sword: coste de 10 coins y recompensa de 1 starter_sword.

    Valores del jugador →
  3. Guardad, recargad y verificad las entradas antes del ejemplo. Conservad las demás definiciones.

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_catalog_page(), read_inventory() mediante un botón o acción de escena explícita. Abrir el archivo no envía peticiones.

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

Usar el objeto guardado

Importad el ejemplo oficial y sus archivos auxiliares. Revisad la oferta y ejecutad la secuencia con el jugador actual. Esperad cada paso y confirmad la compra una vez. Conservad la petición original si la respuesta es incierta.

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

Prueba tu nueva función.

Al guardar, el catálogo contiene starter_sword. Tras la compra revisada, el inventario actual contiene su instanceId único.

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

Endpoints de la API
  • GET/items
  • GET/items/catalog
  • POST/items/adjust
  • POST/items/equip
  • POST/items/discard
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.