Adicione Rankings Online ao seu Jogo em Minutos com o 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:

• A API (apiscore...): O cérebro de tudo. Uma API RESTful robusta, construída em PHP, que lida com toda a lógica de segurança (JWT e API Keys), cadastro de usuários, gerenciamento de jogos e, o mais importante, o processamento e ranqueamento de scores.
• O CMS do Desenvolvedor (dev-scorehub...): O seu painel de controle. Um portal em React onde você se cadastra, gerencia seus jogos, e obtém suas credenciais de API (Api-Key e Api-Secret) para conectar ao seu jogo.
• O Portal do Jogador (player-scorehub...): Uma aplicação React separada para os seus jogadores! Eles podem se cadastrar, editar seus perfis, ver seu histórico de scores, e até um “Hall de Troféus” com os jogos onde eles são o número 1.
• A Vitrine (scorehub...): O “rosto” público do projeto, que exibe os jogos e jogadores em destaque na plataforma.
• O Painel de Admin (admin-scorehub...): A minha sala de controle, que me permite gerenciar a plataforma, aprovar novos desenvolvedores e garantir a segurança do sistema.

✨ Por que usar o ScoreHub?

A resposta é simples: foco.

• Foco no seu Jogo: Pare de se preocupar em como criptografar senhas ou estruturar um banco de dados. Gaste seu tempo polindo a física do seu jogo, criando arte ou balanceando a dificuldade. O ScoreHub cuida do resto.
• Segurança Integrada: O ecossistema já lida com verificação de email, recuperação de senha, tokens JWT para usuários e um sistema de Api-Key + Api-Secret para autenticar seu jogo.
• Gratuito e Pronto para Usar: Você pode se cadastrar agora, pegar suas chaves e ter um ranking funcionando no seu jogo em menos de 10 minutos.
• Completo: Você não oferece apenas um ranking; você oferece uma comunidade. Seus jogadores ganham um perfil persistente em toda a plataforma ScoreHub.

🕹️ 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

• Vitrine Oficial: https://scorehub.dfilitto.com.br/
• Painel do Desenvolvedor: https://dev-scorehub.dfilitto.com.br/
• Portal do Jogador: https://player-scorehub.dfilitto.com.br/
• Documentação da API: https://apiscore.dfilitto.com.br/

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