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.keydla 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.