Beloon de stemmen van je spelers
Drie manieren om CraftRank aan je server te koppelen. Kies de methode die bij je plug-in past: je kunt ze ook combineren.
1. Votifier (NuVotifier)
Installeer NuVotifier op je server (of op je BungeeCord-/Velocity-proxy) en vervolgens je favoriete beloningsplugin. In het serverformulier, onder het kopje ‘Stembeloningen’:
- Gastheer : het openbare adres van je server (zonder http://).
- Haven : De poort van NuVotifier (standaard 8192) moet op uw host openstaan.
- Token :
plugins/Votifier/config.yml→tokens: default:(protocol v2, aanbevolen). - Of openbare sleutel :
plugins/Votifier/rsa/public.keyvoor de oude Votifier of een forwarder die alleen protocol v1 ondersteunt.
Het protocol wordt automatisch gekozen: v2 met het token als je server dit ondersteunt, anders v1 met de openbare sleutel. Met de knop ‘Een teststem verzenden’ kun je alles in één klik controleren. Bedrock-spelers (Geyser / Floodgate) worden met hun gebruikersnaam verzonden, inclusief de punt.
2. HTTP-API
Maak een API-sleutel aan via je serverformulier. Houd deze geheim: gebruik hem alleen vanaf je server, nooit op een webpagina. De sleutel kan worden verzonden als de parameter ‘key’ of in de header ‘Authorization: Bearer’.
Hebben ze gestemd?
GET https://craftrank.fr/api/v1/vote/check?key=VOTRE_CLE&username=Steve
{ "voted": true, "claimed": false, "voted_at": 1759480000000, "next_vote_at": 1759566400000 }
Geef de beloning maar één keer
Aangevraagde beloningen: true, slechts één keer per stem: je kunt dezelfde stem niet twee keer belonen.
GET https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=Steve
{ "claimed": true } ← de beloning uitreiken
{ "claimed": false, "reason": "already_claimed" } ← al beloond
{ "claimed": false, "reason": "no_vote" } ← geen stemmen in de afgelopen 24 uur
Laatste stemmen (voor een plug-in die stemmen telt)
GET https://craftrank.fr/api/v1/votes?key=VOTRE_CLE&since=1759480000000
{ "votes": [ { "username": "Steve", "timestamp": 1759480123000, "claimed": false } ], "now": 1759480200000 }
Voorbeeld van een 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"
Je hebt een Skript-add-on nodig waarmee je HTTP-verzoeken kunt versturen: pas de regel “set {_r}” aan de syntaxis van je add-on aan.
Limiet: 300 verzoeken per minuut. Een stem blijft 24 uur geldig, net als op de website.
3. Webhook
Voer een URL in op je serverformulier: bij elke stem roept CraftRank deze aan met een POST-verzoek en deze JSON-body:
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 }
Controleer de handtekening om er zeker van te zijn dat het verzoek afkomstig is van CraftRank: dit is de HMAC-SHA256 van de onbewerkte inhoud, met jouw API-sleutel.
// 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; }
Reageer binnen 8 seconden met een 2xx-code (omleidingen worden gevolgd). De testverzoek in het formulier verstuurt ook een oproep met "event": "test". Het resultaat van de laatste oproep wordt weergegeven onder het webhook-veld.
Stemmen weergeven in een Discord-kanaal
Plak de URL van een Discord-webhook rechtstreeks (Kanaalinstellingen → Integraties → Webhooks → Nieuwe webhook → URL kopiëren): CraftRank plaatst bij elke stem een bericht in het kanaal, met de naam van de speler en het aantal stemmen van die maand. Je hoeft niets te programmeren.