Ícone do site dfilitto

Adicione Rankings Online ao seu Jogo em Minutos com o ScoreHub

Danilo Filitto
ScoreHub

Olá, comunidade de desenvolvedores!

Quantas vezes você já criou um jogo incrível, seja para uma game jam ou como um projeto pessoal, e pensou: “Isso seria perfeito com um leaderboard online”? E quantas vezes você desistiu dessa ideia ao perceber a montanha de trabalho que isso exigiria: construir uma API, configurar um banco de dados, programar a autenticação, criar um painel para jogadores…

A verdade é que nós, desenvolvedores de jogos, queremos focar no que fazemos de melhor: criar jogos. A infraestrutura de backend é, muitas vezes, uma barreira que suga nosso tempo e energia.

E se tivéssemos uma ferramenta que fizesse todo esse trabalho pesado por nós, de graça e pronta para usar?

Foi exatamente por isso que eu criei o ScoreHub.

🚀 O que é o Ecossistema ScoreHub?

O ScoreHub não é apenas uma API; é um ecossistema completo de serviços projetado para adicionar funcionalidades online aos seus jogos de forma quase instantânea. Ele é composto por várias aplicações independentes que trabalham juntas:

✨ Por que usar o ScoreHub?

A resposta é simples: foco.

🕹️ Guia Rápido: Seu Leaderboard em 3 Passos

Ok, vamos ao que interessa. Veja como é rápido integrar seu jogo (feito em qualquer engine, como Unity, Godot, ou até JavaScript puro) com o ScoreHub.

Passo 1: Crie sua Conta de Desenvolvedor

A primeira etapa acontece fora do seu jogo.

  1. Acesse o CMS do Desenvolvedor: https://dev-scorehub.dfilitto.com.br/
  2. Cadastre-se: Crie sua conta. Você receberá um email de verificação (graças ao nosso fluxo de status 'pendente').
  3. Verifique seu Email: Clique no link do email para ativar sua conta.
  4. Faça o Login: Volte ao CMS e faça o login.

Passo 2: Cadastre seu Jogo e Pegue suas Chaves

Agora que você está no seu dashboard, vamos registrar seu jogo.

  1. Clique no botão “+ Cadastrar Jogo”.
  2. Preencha as informações (nome do jogo, foto, links, etc.) e salve.
  3. O jogo aparecerá no seu dashboard. Agora, você verá as duas chaves essenciais:
    • API Key: A sua identidade pública (Ex: abc-123).
    • API Secret: A sua senha privada. (Clique em “Mostrar” para vê-la. Guarde-a com segurança!).

Passo 3: Integre com a API (Exemplos de Código)

Com as chaves em mãos, abra seu projeto de jogo. Você só precisa de duas ou três chamadas de API para ter tudo funcionando.

(Aqui estão exemplos em JavaScript fetch por serem universais, mas a lógica é a mesma para C# na Unity).

A. (Opcional) Cadastrar Jogadores de Dentro do Jogo

Permita que seus jogadores criem uma conta ScoreHub sem sair do seu jogo.

Rota: POST /api/jogadores

JavaScript

// O jogador preenche username, email e senha no seu jogo
const novoJogador = {
    username: "Player123",
    email: "player@exemplo.com",
    senha: "senhaSegura"
};

fetch('https://apiscore.dfilitto.com.br/api/jogadores', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify(novoJogador)
})
.then(res => res.json())
.then(data => {
    console.log(data.message); // Ex: "Cadastro quase completo! Verifique seu email..."
});

B. Enviar o Score do Jogador (A Mágica!)

Esta é a chamada principal. Ela usa as chaves do seu jogo para se autenticar.

Rota: POST /api/scores

JavaScript

const JOGO_API_KEY = "sua_api_key_copiada_do_painel";
const JOGO_API_SECRET = "seu_api_secret_copiado_do_painel";

const scoreData = {
    username: "Player123", // O username do jogador que acabou de jogar
    pontuacao: 15000
};

fetch('https://apiscore.dfilitto.com.br/api/scores', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Api-Key': JOGO_API_KEY,
        'X-Api-Secret': JOGO_API_SECRET
    },
    body: JSON.stringify(scoreData)
})
.then(res => res.json())
.then(data => {
    console.log(data.message); // Ex: "Score registrado."
});

C. Exibir o Ranking no seu Jogo

Após o jogador enviar o score, que tal mostrar o ranking atualizado?

Rota: GET /api/jogos/{id}/scores

JavaScript

const ID_DO_SEU_JOGO = 1; // Você pode ver o ID no seu CMS

fetch(`https://apiscore.dfilitto.com.br/api/jogos/${ID_DO_SEU_JOGO}/scores`)
    .then(res => res.json())
    .then(ranking => {
        console.log("Ranking atual:", ranking);
        // Agora é só usar esse array 'ranking' para popular
        // a sua tabela de UI dentro do jogo!
    });

🚀 Conheça o Ecossistema Completo

Conclusão

O ScoreHub foi construído por um desenvolvedor (eu!) para desenvolvedores (você!). Meu objetivo é remover a fricção da criação de backends e permitir que nossa comunidade foque no que importa: fazer jogos divertidos.

A plataforma é sua para usar. Comece a integrar seus projetos hoje mesmo, e por favor, me envie seu feedback!

Estou ansioso para ver o seu jogo no topo dos rankings!

Abraço, Danilo Filitto

Sair da versão mobile