Recompense os votos dos seus jogadores

Três formas de ligar o CraftRank ao teu servidor. Escolhe a que melhor se adequa ao teu plugin: também é possível combiná-las.

1. Votifier (NuVotifier)

Instale o NuVotifier no seu servidor (ou no seu proxy BungeeCord / Velocity) e, em seguida, o seu plugin de recompensas preferido. No formulário do servidor, na secção «Recompensas de voto»:

  • Anfitrião : o endereço público do seu servidor (sem http://).
  • Porto : A porta do NuVotifier (8192 por predefinição), aberta no seu servidor.
  • Token : plugins/Votifier/config.yml → tokens: default: (protocolo v2, recomendado).
  • Ou chave pública : plugins/Votifier/rsa/public.key para o antigo Votifier ou para um encaminhador que apenas suporte o protocolo v1.

O protocolo é selecionado automaticamente: v2 com o token, se o teu servidor o disponibilizar; caso contrário, v1 com a chave pública. O botão «Enviar um voto de teste» verifica tudo com um único clique. Aos jogadores do Bedrock (Geyser / Floodgate) é enviado o seu nome de utilizador, incluindo o ponto.

2. API HTTP

Crie uma chave API no seu servidor. Mantenha-a em segredo: utilize-a apenas a partir do seu servidor, nunca numa página web. A chave pode ser enviada como o parâmetro «key» ou no cabeçalho «Authorization: Bearer».

Eles votaram?

GET https://craftrank.fr/api/v1/vote/check?key=VOTRE_CLE&username=Steve

{ "voted": true, "claimed": false, "voted_at": 1759480000000, "next_vote_at": 1759566400000 }

Dá a recompensa apenas uma vez

Votos reclamados: «true» apenas uma vez por voto: não é possível recompensar o mesmo voto duas vezes.

GET https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=Steve

{ "claimed": true }                              ← entregar a recompensa
{ "claimed": false, "reason": "already_claimed" } ← já recompensado
{ "claimed": false, "reason": "no_vote" }         ← sem votos nas últimas 24 horas

Últimos votos (para um plugin que realiza sondagens)

GET https://craftrank.fr/api/v1/votes?key=VOTRE_CLE&since=1759480000000

{ "votes": [ { "username": "Steve", "timestamp": 1759480123000, "claimed": false } ], "now": 1759480200000 }

Exemplo de script

command /voterecompense:
  trigger:
    set {_r} to text from "https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=%player%"
    if {_r} contains """claimed"":true":
      give player 1 diamond
      send "&aMerci pour ton vote !"
    else if {_r} contains "already_claimed":
      send "&eRécompense déjà récupérée, reviens demain !"
    else:
      send "&cVote sur craftrank.fr puis refais /voterecompense"

Precisas de um add-on do Skript capaz de efetuar pedidos HTTP: adapta a linha «set {_r}» à sintaxe do teu add-on.

Limite: 300 pedidos por minuto. Um voto é válido durante 24 horas, tal como no site.

3. Webhook

Introduza um URL no formulário do seu servidor: a cada voto, o CraftRank envia-lhe uma chamada POST com este corpo JSON:

POST https://monserveur.fr/craftrank-vote
Content-Type: application/json
X-CraftRank-Signature: sha256=…

{ "event": "vote", "server": { "id": 12, "slug": "mon-serveur", "name": "Mon serveur" }, "username": "Steve", "timestamp": 1759480123000 }

Verifique a assinatura para se certificar de que a chamada provém do CraftRank: trata-se do HMAC-SHA256 do corpo da mensagem em formato bruto, com a sua chave API.

// Node.js
const sig = 'sha256=' + crypto.createHmac('sha256', CLE_API).update(rawBody).digest('hex');
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.get('X-CraftRank-Signature') || ''))) return res.sendStatus(401);

// PHP
$sig = 'sha256=' . hash_hmac('sha256', file_get_contents('php://input'), CLE_API);
if (!hash_equals($sig, $_SERVER['HTTP_X_CRAFTRANK_SIGNATURE'] ?? '')) { http_response_code(401); exit; }

Responda com um código 2xx no prazo de 8 segundos (os redirecionamentos são tidos em conta). O voto de teste no formulário também envia uma chamada com «event»: «test». O resultado da última chamada é apresentado no campo do webhook.

Mostrar votos num canal do Discord

Cole diretamente o URL de um webhook do Discord (Definições do canal → Integrações → Webhooks → Novo webhook → Copiar URL): o CraftRank publica uma mensagem no canal por cada voto, com o nome do jogador e a contagem de votos do mês. Não é preciso programar nada.

Adicionar o meu servidor