Ideas y funciones para tu juego

Tu próxima función

Códigos de Regalo

Permite que los jugadores introduzcan y canjeen códigos de regalo.

Requiere una sesión de jugador
Godot
Ilustración de Códigos de Regalo
El resultado visible

Se canjea un código de prueba. Los canjes repetidos siguen tus reglas.

Crear un código de regalo1:42

Este tutorial se reproduce en inglés.

Abrir vídeo por separado ↗
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 en el servidor

Preparar el mismo proyecto

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

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

    Código
    WELCOME
    Datos del Regalo (JSON)
    {}
    Máximo por Usuario
    1

    El servidor acredita hasta ocho valores configurados al canjear. giftData sigue siendo una carga del juego independiente. Muestra el saldo recibido sin sumar otra vez la recompensa localmente.

    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.

El servidor acredita hasta ocho valores configurados al canjear. giftData sigue siendo una carga del juego independiente. Muestra el saldo recibido sin sumar otra vez la recompensa localmente. Este ejemplo del SDK usa develop. Comprueba si las API necesarias están disponibles en el SDK instalado.

Guardad el GDScript, añadidlo a un nodo de la escena principal y ejecutadla. Revisad Output.

GDScript
res://scripts/gift_codes.gd
Llamada a horizOnPreparación
1# Añade este script a un nodo de tu escena principal.
2extends Node
3​
4​
5func _ready() -> void:
6 # Preparación: inicializar, conectar e iniciar la sesión de un jugador.
7 var connected = await Horizon.connect_to_server()
8 if not connected:
9 print("Failed to connect to horizOn server")
10 return
11 if not Horizon.auth.isSignedIn():
12 var signed_in: bool
13 if Horizon.auth.hasCachedAnonymousToken():
14 signed_in = await Horizon.auth.restoreAnonymousSession()
15 else:
16 signed_in = await Horizon.auth.signUpAnonymous("StatisticsPlayer")
17 if not signed_in:
18 return
19​
20 # horizOn: validar un código de regalo y canjearlo.
21 # Run from one explicit player action; serialize this handler until it completes.
22 var user_id: String = Horizon.auth.getCurrentUser().userId
23 var project: String = Horizon.getConfig().api_key
24 var scope: String = project + "|" + user_id
25 var path: String = "user://gift_pending_" + scope.sha256_text() + ".bin"
26 var pending: Dictionary
27 if FileAccess.file_exists(path):
28 var file := FileAccess.open(path, FileAccess.READ)
29 if file == null: return
30 var saved: Variant = file.get_var(false)
31 file.close()
32 if not HorizonGiftCodes.validIntent(saved, project, user_id): return
33 pending = saved # Invalid/V1 records stay untouched for reconciliation.
34 else:
35 pending = await Horizon.giftCodes.prepareRedemption("WELCOME")
36 if not HorizonGiftCodes.validIntent(pending, project, user_id) or FileAccess.file_exists(path): return
37 var file := FileAccess.open(path, FileAccess.WRITE)
38 if file == null: return
39 file.store_var(pending, false)
40 file.flush()
41 var saved_ok: bool = file.get_error() == OK
42 file.close()
43 if not saved_ok: return
44 var verify := FileAccess.open(path, FileAccess.READ)
45 if verify == null: return
46 var original: Variant = verify.get_var(false)
47 verify.close()
48 if original != pending: return
49 var result: Dictionary = await Horizon.giftCodes.redeemPrepared(pending)
50 if not result.get("success", false): return # Keep all seven original fields for retry.
51 verify = FileAccess.open(path, FileAccess.READ)
52 if verify == null: return
53 original = verify.get_var(false)
54 verify.close()
55 if original == pending: DirAccess.remove_absolute(ProjectSettings.globalize_path(path))
56 if result.get("playerValues") is Dictionary:
57 print(result.playerValues.values) # Current balances, never add grantedValues locally.
58 # Replay has alreadyApplied=true, giftData=null and empty grantedValues/grantedUnlocks.
Abrir el ejemplo completo del SDK ↗

Prueba tu nueva función.

Se canjea un código de prueba. Los canjes repetidos siguen tus reglas.

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

Endpoints de la API
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
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.