Recompensa los votos de tus jugadores

Tres formas de conectar CraftRank a tu servidor. Elige la que mejor se adapte a tu complemento: también se pueden combinar.

1. Votifier (NuVotifier)

Instala NuVotifier en tu servidor (o en tu proxy de BungeeCord / Velocity) y, a continuación, tu complemento de recompensas favorito. En el formulario de tu servidor, en la sección «Recompensas por votar»:

  • Anfitrión : la dirección pública de tu servidor (sin http://).
  • Puerto : El puerto de NuVotifier (8192 por defecto) está abierto en tu servidor.
  • Token : plugins/Votifier/config.yml → tokens: default: (protocolo v2, recomendado).
  • O clave pública : plugins/Votifier/rsa/public.key para el antiguo Votifier o un reenviador que solo admita el protocolo v1.

El protocolo se selecciona automáticamente: v2 con el token si tu servidor lo ofrece; de lo contrario, v1 con la clave pública. El botón «Enviar un voto de prueba» comprueba todo con un solo clic. A los jugadores de Bedrock (Geyser / Floodgate) se les envía con su nombre de usuario, punto incluido.

2. API HTTP

Crea una clave API en tu servidor. Manténla en secreto: utilízala únicamente desde tu servidor, nunca en una página web. La clave se puede enviar como parámetro «key» o en el encabezado «Authorization: Bearer».

¿Han votado?

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

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

Otorga la recompensa solo una vez

Votos reclamados: «true» solo una vez por voto: no se puede recompensar el mismo voto dos veces.

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

{ "claimed": true }                              ← entregar la recompensa
{ "claimed": false, "reason": "already_claimed" } ← ya recompensado
{ "claimed": false, "reason": "no_vote" }         ← No se ha votado en las últimas 24 horas

Últimos votos (para un complemento que realiza encuestas)

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

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

Ejemplo 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"

Necesitas un complemento de Skript que pueda realizar solicitudes HTTP: adapta la línea «set {_r}» a la sintaxis de tu complemento.

Límite: 300 solicitudes por minuto. Un voto tiene validez durante 24 horas, igual que en la página web.

3. Webhook

Introduce una URL en el formulario de tu servidor: cada vez que se emita un voto, CraftRank la llamará mediante un método POST con este cuerpo 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 }

Comprueba la firma para asegurarte de que la llamada procede de CraftRank: se trata del HMAC-SHA256 del cuerpo sin procesar, con tu clave de 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; }

Responde con un código 2xx en un plazo de 8 segundos (se tienen en cuenta las redirecciones). La votación de prueba del formulario también envía una llamada con «event»: «test». El resultado de la última llamada se muestra debajo del campo «webhook».

Mostrar votos en un canal de Discord

Pega directamente la URL del webhook de Discord (Configuración del canal → Integraciones → Webhooks → Nuevo webhook → Copiar URL): CraftRank publica un mensaje en el canal cada vez que se realiza un voto, con el nombre del jugador y el recuento de votos de ese mes. No hace falta programar nada.

Añadir mi servidor