Nagrody za głosy

Gdy gracz zagłosuje na Twój serwer, MCLista wyśle zapytanie HTTP (webhook) do Twojego serwera. Możesz wtedy automatycznie nagrodzić gracza — diamentami, kasą, rangą, cokolwiek chcesz.

1. Konfiguracja w panelu

  1. 1.Zaloguj się i przejdź do Panelu właściciela.
  2. 2.Wybierz swój serwer → "Nagrody za głosy".
  3. 3.Podaj URL webhooka na Twoim serwerze webowym (np. https://twojserwer.pl/vote).
  4. 4.Wygeneruj lub wpisz własny sekret — będzie w każdym żądaniu w headerze X-Secret.
  5. 5.Zapisz. Od teraz po każdym głosie wyślemy POST do Twojego URL.

2. Format żądania

Wysyłamy POST z nagłówkiem X-Secret i body JSON:

{
  "player": "NazwaGracza",
  "server": "mc.twojserwer.pl",
  "timestamp": "2026-04-11T18:32:00.000Z"
}

3. Przykłady implementacji

Skript (plugin Minecraft)

on vote receive from "mclista.pl":
    give 1 diamond to player
    send "&aOtrzymałeś nagrodę za głosowanie!" to player

PHP (webhook endpoint)

<?php
$secret  = getenv('VOTE_SECRET');
$payload = json_decode(file_get_contents('php://input'), true);

// Weryfikacja sekretu
if ($_SERVER['HTTP_X_SECRET'] !== $secret) {
    http_response_code(403);
    exit;
}

$player = $payload['player'];
// np. wyślij komendę przez RCON:
// rcon_exec("give $player diamond 1");

http_response_code(200);

💡 Wskazówki

  • • Webhook wysyłamy maksymalnie 3 razy jeśli endpoint zwróci błąd (retry z opóźnieniem 30s).
  • • Odpowiedz kodem 200 — inaczej uznamy wysyłkę za nieudaną.
  • • Zawsze weryfikuj sekret z headera X-Secret.
  • • Webhook trafia do Ciebie w ciągu kilku sekund od głosu gracza.