Nagradzaj graczy za oddane głosy

Trzy sposoby podłączenia CraftRank do serwera. Wybierz ten, który pasuje do Twojej wtyczki: można je również łączyć.

1. Votifier (NuVotifier)

Zainstaluj NuVotifier na swoim serwerze (lub na serwerze proxy BungeeCord / Velocity), a następnie swoją ulubioną wtyczkę do nagród. W formularzu serwera, w sekcji „Nagrody za głosowanie”:

  • Gospodarz : adres publiczny Twojego serwera (bez http://).
  • Port : Port NuVotifier (domyślnie 8192) otwarty na Twoim serwerze.
  • Token : plugins/Votifier/config.yml → tokens: default: (protokół w wersji 2, zalecany).
  • Lub klucz publiczny : plugins/Votifier/rsa/public.key dla starej wersji Votifier lub serwisu przekazującego, który obsługuje wyłącznie protokół w wersji 1.

Protokół jest wybierany automatycznie: v2 z tokenem, jeśli serwer to obsługuje, w przeciwnym razie v1 z kluczem publicznym. Przycisk „Wyślij głos testowy” pozwala sprawdzić wszystko jednym kliknięciem. Gracze korzystający z Bedrock (Geyser / Floodgate) są wysyłani wraz ze swoją nazwą użytkownika, łącznie z kropką.

2. Interfejs API HTTP

Utwórz klucz API na swoim serwerze. Zachowaj go w tajemnicy: używaj go wyłącznie na serwerze, nigdy na stronie internetowej. Klucz można przesłać jako parametr „key” lub w nagłówku „Authorization: Bearer”.

Czy zagłosowali?

GET https://craftrank.fr/api/v1/vote/check?key=VOTRE_CLE&username=Steve

{ "voted": true, "claimed": false, "voted_at": 1759480000000, "next_vote_at": 1759566400000 }

Nagrodę należy przyznać tylko raz

Zgłoszone zwroty: wartość „true” może wystąpić tylko raz na głos: nie można dwukrotnie nagrodzić tego samego głosu.

GET https://craftrank.fr/api/v1/vote/claim?key=VOTRE_CLE&username=Steve

{ "claimed": true }                              ← wręczyć nagrodę
{ "claimed": false, "reason": "already_claimed" } ← już nagrodzony
{ "claimed": false, "reason": "no_vote" }         ← brak głosów w ciągu ostatnich 24 godzin

Najnowsze głosy (w przypadku wtyczki przeprowadzającej ankietę)

GET https://craftrank.fr/api/v1/votes?key=VOTRE_CLE&since=1759480000000

{ "votes": [ { "username": "Steve", "timestamp": 1759480123000, "claimed": false } ], "now": 1759480200000 }

Przykład skryptu

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"

Potrzebujesz dodatku do Skriptu, który umożliwia wysyłanie żądań HTTP: dostosuj wiersz „set {_r}” do składni swojego dodatku.

Limit: 300 żądań na minutę. Głos jest ważny przez 24 godziny, tak jak na stronie.

3. Webhook

Wprowadź adres URL w formularzu serwera: przy każdym głosowaniu CraftRank wywołuje go za pomocą żądania POST, przekazując następującą treść w formacie 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 }

Sprawdź podpis, aby upewnić się, że połączenie pochodzi od CraftRank: jest to HMAC-SHA256 nieprzetworzonej treści wiadomości, wygenerowany przy użyciu Twojego klucza 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; }

Odpowiedz kodem 2xx w ciągu 8 sekund (przeprowadzane są przekierowania). Testowe zgłoszenie w formularzu powoduje również wysłanie żądania z parametrem „event”: „test”. Wynik ostatniego żądania jest wyświetlany pod polem webhooka.

Pokaż głosy na kanale Discorda

Wklej bezpośrednio adres URL webhooka z Discorda (Ustawienia kanału → Integracje → Webhooki → Nowy webhook → Skopiuj adres URL): CraftRank publikuje na kanale wiadomość przy każdym głosowaniu, podając nazwę gracza oraz liczbę głosów w danym miesiącu. Nie trzeba pisać żadnego kodu.

Dodaj mój serwer