Ideias e funcionalidades do jogo

A tua próxima funcionalidade

Partidas

Jogos por turnos com revisões explícitas, estado opaco e relatórios de resultados separados.

SDK: developRequer uma sessão de jogador
Godot
Ilustração de Partidas
O resultado visível

Coordene uma sala, turnos alternados e relatórios finais independentes com duas sessões de jogador.

Vídeo em breve

Este passo ainda não tem vídeo. O guia e o pedido MCP já podem ser usados.

Partidas por turnos

Preparar o mesmo projeto

  1. Seleciona no painel o mesmo projeto que na configuração do teu jogo.

    Partidas →
  2. O primeiro pedido não exige outra definição. Um resultado vazio é válido enquanto faltarem dados do jogo.

    Use duas sessões distintas: crie uma sala, entre, inicie com ordem explícita, alterne estados em bytes e relate independentemente o mesmo resultado final.

    Este primeiro exemplo lê dados. Não cria grupos, partidas nem objetos. Uma lista vazia é uma primeira resposta válida.

Integra esta funcionalidade

Podes consultar o guia. Para o executar, precisas de uma chave de projeto ativa. Preparar o projeto

SDK instalado, configuração do projeto importada e jogador com sessão iniciada.

Este exemplo do SDK usa develop. Verifica se as API necessárias existem no SDK instalado.

Concluam a ligação do início rápido com o jogador escolhido. Chamem read_my_matches() através de um botão ou ação explícita da cena. Abrir o ficheiro não envia pedidos.

GDScript
res://scripts/matches.gd
Chamada ao 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 o exemplo SDK completo ↗

Dois jogadores, um turno original

Use duas sessões distintas: crie uma sala, entre, inicie com ordem explícita, alterne estados em bytes e relate independentemente o mesmo resultado final.

Guarde o pedido exato antes de enviar. Após expiração, leia o estado e reconcilie. Nunca substitua silenciosamente a revisão ou intenção original.

Os relatórios usam a revisão final imutável. A concordância não prova uma vitória fiável; divergências e relatórios ausentes não determinam vencedores.

As rondas classificadas requerem uma partida classificada confirmada e o fluxo Validated Actions existente. Relatórios comuns não atribuem recompensas.

PHP suporta as rotas REST comuns. Validação classificada e tempo real estão indisponíveis e devolvem FEATURE_NOT_SUPPORTED quando necessário.

Testa a tua nova funcionalidade.

Coordene uma sala, turnos alternados e relatórios finais independentes com duas sessões de jogador.

Seleciona no painel o mesmo projeto que na configuração do teu jogo.

Endpoints da 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 os endpoints na referência da API
Ilustração de Tabelas de classificação
A nossa sugestão para o próximo passo

Dá uma pontuação máxima a cada partida.

Guarda a pontuação depois de uma partida e mostra quem está à frente. Continua a usar a ligação e a sessão do jogador.