Belohnen Sie die Stimmen Ihrer Spieler
Drei Möglichkeiten, CraftRank mit Ihrem Server zu verbinden. Wählen Sie die für Ihr Plugin geeignete Option aus: Die Möglichkeiten lassen sich auch kombinieren.
1. Votifier (NuVotifier)
Installiere NuVotifier auf deinem Server (oder auf deinem BungeeCord-/Velocity-Proxy) und anschließend dein bevorzugtes Belohnungs-Plugin. Im Abschnitt „Vote-Belohnungen“ des Server-Formulars:
- Gastgeber : Die öffentliche Adresse Ihres Servers (ohne http://).
- Hafen : Der Port von NuVotifier (standardmäßig 8192) ist auf Ihrem Host geöffnet.
- Token :
plugins/Votifier/config.yml→tokens: default:(Protokoll v2, empfohlen). - Oder öffentlicher Schlüssel :
plugins/Votifier/rsa/public.keyfür den alten Votifier oder einen Forwarder, der nur Protokoll v1 unterstützt.
Das Protokoll wird automatisch ausgewählt: v2 mit dem Token, sofern Ihr Server dies unterstützt, andernfalls v1 mit dem öffentlichen Schlüssel. Über die Schaltfläche „Teststimme senden“ lassen sich alle Einstellungen mit einem Klick überprüfen. Bedrock-Spieler (Geyser / Floodgate) werden mit ihrem Benutzernamen einschließlich des Punktes gesendet.
2. HTTP-API
Erstellen Sie einen API-Schlüssel in Ihrem Serverformular. Behandeln Sie ihn vertraulich: Verwenden Sie ihn ausschließlich auf Ihrem Server, niemals auf einer Webseite. Der Schlüssel kann als „key“-Parameter oder im „Authorization: Bearer“-Header übermittelt werden.
Haben sie abgestimmt?
GET https://craftrank.fr/api/v1/vote/check?key=VOTRE_CLE&username=Steve
{ "voted": true, "claimed": false, "voted_at": 1759480000000, "next_vote_at": 1759566400000 }
Vergebe die Belohnung nur einmal
Behauptete Rückgaben: „true“ – nur einmal pro Stimme: Dieselbe Stimme kann nicht zweimal belohnt werden.
GET https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=Steve
{ "claimed": true } ← Die Belohnung vergeben
{ "claimed": false, "reason": "already_claimed" } ← bereits belohnt
{ "claimed": false, "reason": "no_vote" } ← Keine Abstimmung in den letzten 24 Stunden
Neueste Abstimmungen (für ein Plugin, das Abstimmungen durchführt)
GET https://craftrank.fr/api/v1/votes?key=VOTRE_CLE&since=1759480000000
{ "votes": [ { "username": "Steve", "timestamp": 1759480123000, "claimed": false } ], "now": 1759480200000 }
Skriptbeispiel
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"
Sie benötigen ein Skript-Add-on, das HTTP-Anfragen stellen kann: Passen Sie die Zeile „set {_r}“ an die Syntax Ihres Add-ons an.
Obergrenze: 300 Anfragen pro Minute. Eine Stimme gilt 24 Stunden lang, genau wie auf der Website.
3. Webhook
Geben Sie eine URL in Ihr Server-Formular ein: Bei jeder Abstimmung ruft CraftRank diese URL mit einem POST-Request und folgendem JSON-Body auf:
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 }
Überprüfen Sie die Signatur, um sicherzustellen, dass der Aufruf von CraftRank stammt: Es handelt sich um den HMAC-SHA256 des Rohtextes, der mit Ihrem API-Schlüssel erstellt wurde.
// 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; }
Antworten Sie innerhalb von 8 Sekunden mit einem 2xx-Code (Weiterleitungen werden berücksichtigt). Die Testabfrage im Formular sendet zudem einen Aufruf mit „event“: „test“. Das Ergebnis des letzten Aufrufs wird unter dem Webhook-Feld angezeigt.
Stimmen in einem Discord-Kanal anzeigen
Füge eine Discord-Webhook-URL direkt ein (Kanaleinstellungen → Integrationen → Webhooks → Neuer Webhook → URL kopieren): CraftRank veröffentlicht für jede Abstimmung eine Nachricht im Kanal, die den Namen des Spielers und die Anzahl der Stimmen in diesem Monat enthält. Es ist keine Programmierung erforderlich.