Ideas y funciones para tu juego

Tu próxima función

Valores del jugador

Monedas, contadores y energía controlados por el servidor. Define saldos, ofertas y cambios verificados por proyecto.

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

Tu juego muestra los saldos y las ofertas configurados. Las compras devuelven el estado actual del jugador.

Vídeo próximamente

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

Valores del jugador

Preparar el mismo proyecto

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

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

    Valores
    coins: initialBalance=100, maxBalance=1000000; energy: initialBalance=10, maxBalance=100
    Permitir cambios directos
    false
    Ofertas
    energy-pack: costs=[{"key":"coins","amount":20}], rewards=[{"key":"energy","amount":5}]

    El saldo inicial se concede una sola vez por clave. Los cambios directos están desactivados inicialmente. Validated Actions conserva sus límites por partida; los límites diarios y de saldo proceden de estas definiciones. Un límite opcional vacío significa sin límite.

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

GDScript
res://scripts/player_values.gd
Llamada a horizOn
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var current: Dictionary = await Horizon.playerValues.getState(user_id)
10 if not current.success:
11 push_error(current.errorCode)
12 return
13 print(current.state.values)
14 # Authoritative balances only; never add a copied historical reward locally.
15 # Purchases and exact original retry use the official player_values_example.gd
16 # and pending_purchase.gd. Persist the original user/offer/operationId before send.
17 # Keep an uncertain or expired original; do not silently create another ID.
Abrir el ejemplo completo del SDK ↗

Prueba tu nueva función.

Tu juego muestra los saldos y las ofertas configurados. Las compras devuelven el estado actual del jugador.

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

Endpoints de la API
  • GET/player-values
  • GET/player-values/offers
  • POST/player-values/purchase
  • POST/player-values/adjust
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.