Ranking no jogo: classificação, rodadas e recompensas

O que o jogador vê

• Placares em abas: cada um com um cartão mostrando a pontuação do jogador, a posição e a contagem até o fim da rodada.
• Os melhores jogadores, com o jogador destacado e medalhas para os três primeiros.
• Recompensas por posição e recompensas por pontos em janelas; as por pontos são recolhidas ali mesmo.
• Uma janela com a recompensa da última rodada: ela aparece sozinha quando uma rodada termina, com um botão "Pegar".
• Um botão "Jogar" no cartão se o jogo tiver um modo em que se ganham pontos.
• Um selo na aba quando há uma recompensa à espera.

Como um placar é montado

• Rodadas. Um placar se repete em ciclos (por exemplo toda semana), corre por um cronograma ou como uma sequência de rodadas.
• Como a pontuação é contada. A soma de todos os resultados, o melhor resultado, o melhor tempo ou o último valor.
• Recompensas por posição: por faixas de posição no fim de uma rodada: 1º lugar, 2º a 3º, 4º a 10º e assim por diante.
• Recompensas por pontos: marcos dentro de uma rodada: "faça 1000 pontos nesta semana".

De onde vêm os pontos

Os pontos vêm das fontes definidas no placar:

• Um resultado vindo do jogo (ClientScore). O jogo envia um número, por exemplo a pontuação de uma corrida. ⚠ Defina limites na fonte: um máximo por envio, um máximo por dia e uma pausa entre envios. Sem essa fonte o placar não aceita nenhum número do jogo.
• Eventos que o servidor conta sozinho, por exemplo compras ou missões concluídas. Esses não podem ser falsificados pelo jogo.

Para desenvolvedores

O ranking funciona por meio de client.leaderboard no @idosgames/core.

// Enviar um resultado: o servidor aplica a regra de contagem e os limites
const sub = await client.leaderboard.submitScore('weekly_score', 150)
if (!sub.ok) return showError(sub.error)
sub.data.NewScore // a pontuação depois da contagem

// Uma tela com vários placares: listas do topo e o progresso do jogador em uma requisição
const overview = await client.leaderboard.getOverviewBatch(['weekly_score', 'season_pvp'])

// Recolher tudo o que está à espera: recompensas por posição e por pontos
await client.leaderboard.claimAllRewardsBatch(['weekly_score', 'season_pvp'])

• O SDK recusa sozinho uma pontuação zero ou negativa, sem fazer requisição.
• Pegue a nova pontuação em NewScore na resposta: com "melhor resultado", um resultado pior não muda a pontuação.
• O ranking de amigos é getFriendsLeaderboard(leaderboardID).

Todos os campos estão descritos na habilidade leaderboard-system, servida pelo servidor MCP do SDK.