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.key fü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.

Meinen Server hinzufügen