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.key voor 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.

Mijn server toevoegen