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.keypara 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.