Ideas y funciones para tu juego

Tu próxima función

Partidas

Juegos por turnos con revisiones explícitas, estado opaco e informes de resultados separados.

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

Coordina una sala, turnos alternos e informes finales independientes con dos sesiones de jugador.

Vídeo próximamente

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

Partidas por turnos

Preparar el mismo proyecto

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

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

    Usa dos sesiones de jugador distintas: crea una sala, únete, inicia con orden explícito, alterna estados de bytes e informa del mismo resultado final de forma independiente.

    Este primer ejemplo lee datos. No crea grupos, partidas ni objetos. Una lista vacía es una primera respuesta válida.

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

GDScript
res://scripts/matches.gd
Llamada a horizOn
1extends Node
2​
3# Explicit action after restoring the SAME existing player identity.
4func read_my_matches() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.matches.getMatches(user.userId)
9 if not result.success:
10 push_warning(result.errorCode)
11 return
12 print("Ledger revision: ", result.data.revision)
13 for row in result.data.recent:
14 print(row.id, " ", row.status) # May still be active after this player's forfeit.
15 # Respect result.data.pollAfterSeconds. No background poll.
16# Full two-player, durable-original example in the verified SDK:
17# addons/horizon_sdk/examples/features/matches_example.gd
18# read_matches()/create_reviewed(options), read_match(id), perform_reviewed(kind, body).
19# Each is an explicit player action. Original project+player intent survives host changes.
20# SDK methods: joinMatch(userId,id,originalRevision), startMatch(userId,id,originalRevision,order),
21# submitTurn(userId,id,originalRevision,PackedByteArray,finish),
22# reportResult(userId,id,originalFinalRevision,PackedByteArray,sortedWinnerIds).
23# Unknown create: recovery reads and explicit reconciliation, never a replacement create.
24# Report agreement is ordinary consensus, not validated combat or an automatic reward.
Abrir el ejemplo completo del SDK ↗

Dos jugadores, un turno original

Usa dos sesiones de jugador distintas: crea una sala, únete, inicia con orden explícito, alterna estados de bytes e informa del mismo resultado final de forma independiente.

Guarda la solicitud exacta antes de enviarla. Tras un tiempo agotado, lee el estado y concilia. Nunca sustituyas silenciosamente la revisión ni la intención original.

Los informes usan la revisión final inmutable. Coincidir no demuestra una victoria fiable; las discrepancias y los informes ausentes no determinan un ganador.

Las rondas clasificadas requieren una partida clasificada confirmada y el flujo existente de Validated Actions. Los informes normales no conceden premios.

PHP admite las rutas REST de partidas normales. La validación clasificada y el tiempo real no están disponibles; se devuelve FEATURE_NOT_SUPPORTED cuando corresponde.

Prueba tu nueva función.

Coordina una sala, turnos alternos e informes finales independientes con dos sesiones de jugador.

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

Endpoints de la API
  • GET/matches
  • GET/matches/limits
  • GET/matches/open
  • GET/matches/{matchId}
  • POST/matches
  • POST/matches/{matchId}/join
  • POST/matches/{matchId}/decline
  • POST/matches/{matchId}/start
  • POST/matches/{matchId}/turn
  • POST/matches/{matchId}/timeout
  • POST/matches/{matchId}/leave
  • POST/matches/{matchId}/cancel
  • POST/matches/{matchId}/result
  • POST/matches/{matchId}/ranked-run
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.