Idee e funzionalità per il gioco

La tua prossima funzionalità

Partite

Giochi a turni con revisioni esplicite, stato opaco e rapporti dei risultati separati.

SDK: developSessione del giocatore richiesta
Godot
Illustrazione di Partite
Il risultato visibile

Coordina una sala, turni alternati e rapporti finali indipendenti con due sessioni giocatore.

Video in arrivo

Questo passaggio non ha ancora un video. La guida e la richiesta MCP sono già utilizzabili.

Partite a turni

Preparare lo stesso progetto

  1. Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

    Partite →
  2. La prima richiesta non richiede altre definizioni. Un risultato vuoto è valido finché mancano i dati del gioco.

    Usa due sessioni distinte: crea una sala, unisciti, avvia con ordine esplicito, alterna stati in byte e comunica indipendentemente lo stesso risultato finale.

    Questo primo esempio legge dati. Non crea gruppi, partite o oggetti. Un elenco vuoto è una prima risposta valida.

Integra questa funzionalità

Puoi consultare la guida. Per eseguirla serve una chiave di progetto attiva. Prepara il progetto

SDK installato, configurazione del progetto importata e giocatore connesso.

Questo esempio del SDK usa develop. Verifica che le API necessarie siano disponibili nel SDK installato.

Completate la connessione rapida con il giocatore scelto. Chiamate read_my_matches() tramite un pulsante o un’azione esplicita della scena. Aprire il file non invia richieste.

GDScript
res://scripts/matches.gd
Chiamata 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.
Aprire l’esempio SDK completo ↗

Due giocatori, un turno originale

Usa due sessioni distinte: crea una sala, unisciti, avvia con ordine esplicito, alterna stati in byte e comunica indipendentemente lo stesso risultato finale.

Salva la richiesta esatta prima dell’invio. Dopo una scadenza, leggi lo stato e riconcilia. Non sostituire silenziosamente revisione o intenzione originale.

I rapporti usano la revisione finale immutabile. La concordanza non prova una vittoria attendibile; divergenze e rapporti mancanti non determinano un vincitore.

Le sessioni classificate richiedono una partita classificata confermata e il flusso Validated Actions esistente. I rapporti normali non assegnano premi.

PHP supporta le rotte REST ordinarie. Validazione classificata e tempo reale non sono disponibili e restituiscono FEATURE_NOT_SUPPORTED ove necessario.

Prova la tua nuova funzionalità.

Coordina una sala, turni alternati e rapporti finali indipendenti con due sessioni giocatore.

Seleziona nella dashboard lo stesso progetto presente nella configurazione del gioco.

Endpoint dell'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
Tutti gli endpoint nel riferimento API
Illustrazione di Classifiche
Il nostro suggerimento per il prossimo passo

Dai un record a ogni partita.

Salva il punteggio dopo una partita e mostra chi è in testa. Continua a usare la connessione e la sessione del giocatore.