Przejdź do treści
Dodaj serwerPanel
Dodaj serwer

Dla administratorów serwerów

Plugin ListaOneBlock — nagrody za głosy

Gracz głosuje na serwer na lista-oneblock.pl, a plugin sam wydaje mu nagrodę w grze — bez otwierania portów, bez dodatkowych pluginów i bez wpisywania komend. Do tego klikalne /glosuj, statystyki serwera na liście i potwierdzenie, że serwer należy do ciebie.

Co daje plugin

  • Bez otwierania portów

    Plugin sam pyta listę o nowe głosy przez HTTPS (połączenie wychodzące). Nie wystawiasz portu 8192 jak przy Votifierze i nie konfigurujesz zapory.

  • Paper, Folia i Spigot 1.18+

    Jeden plik dla Spigota, Papera i Purpura od 1.18.2 do 26.3 oraz dla Folii i Canvasa. Wymaga Javy 17 lub nowszej.

  • Kolejka offline

    Gracz głosuje na stronie i nie musi być na serwerze. Nagroda czeka na niego do wejścia (domyślnie 7 dni) — bez wpisywania komend.

  • Most Votifier

    Masz VotingPlugin albo SuperbVote? Plugin może wywołać VotifierEvent, więc nagrody wyda twój dotychczasowy system głosów.

  • Bez podwójnych nagród

    Każdy głos ma numer. Plugin zapisuje go na dysku, zanim potwierdzi odbiór, i nie wyda nagrody drugi raz, nawet po awarii sieci.

  • Bezpieczny i lekki

    Zero zależności, brak automatycznych aktualizacji, nicki sprawdzane przed wstawieniem do komend. Do listy trafiają tylko liczby: gracze, TPS, wersja.

Instalacja krok po kroku

  1. Dodaj serwer do listy

    Jeśli twojego serwera jeszcze nie ma na liście, dodaj serwer. Gdy jest, ale został dodany automatycznie, zaloguj się do panelu i przejmij go.

  2. Wygeneruj klucz pluginu

    W panelu wejdź w swój serwer i otwórz zakładkę Klucz pluginu. Skopiuj klucz od razu — pokazujemy go tylko raz. Zaczyna się od lob_srv_.

  3. Wgraj plik do folderu plugins

    Pobierz ListaOneBlock-1.0.0.jar i wrzuć go do folderu plugins/ serwera. Usuń starszą wersję, jeśli ją masz.

  4. Uruchom serwer ponownie

    Zrestartuj serwer (nie używaj /reload). Plugin utworzy plik plugins/ListaOneBlock/config.yml.

  5. Wklej klucz i ustaw nagrody

    W config.yml wpisz klucz w api-key, a w rewards.commands komendy nagród. Zapisz plik i wpisz /listaoneblock reload.

  6. Sprawdź połączenie

    Wpisz /listaoneblock status. Po kilku sekundach zobaczysz „Klucz API: przyjęty” i godzinę ostatniego heartbeatu. Jeśli serwer czeka na potwierdzenie własności, plugin na kilka minut dopisze na końcu MOTD kod lob-…. Gdy plugin łączy się z listą z tego samego adresu IP, na który wskazuje domena serwera (rekord A/AAAA lub SRV), lista odczyta kod pingiem i potwierdzi, że serwer należy do ciebie — w konsoli pojawi się komunikat „Lista potwierdziła, że serwer należy do Ciebie”, a kod zniknie z MOTD. Za proxy (Velocity, BungeeCord, TCPShield, NeoProtect) albo z innym adresem wychodzącym potwierdź własność w panelu kodem w MOTD lub rekordem DNS TXT.

  7. Przetestuj nagrodę

    Wpisz /listaoneblock test TwójNick. Plugin wyda nagrodę dokładnie tak jak za prawdziwy głos — to najszybszy sposób, żeby sprawdzić komendy i wiadomości.

Przykładowy config.yml

Plugin tworzy pełny plik z komentarzami po polsku przy pierwszym starcie. Najważniejsze ustawienia wyglądają tak:

# plugins/ListaOneBlock/config.yml
api-key: "lob_srv_…"        # klucz z panelu (Twój serwer → Klucz pluginu)
api-url: "https://lista-oneblock.pl/api/plugin/v1"
heartbeat-seconds: 60       # min. 30
poll-seconds: 30            # min. 15
vote-url: ""                # pusty = link do głosowania pobierany z listy

votes:
  enabled: true             # w sieci serwerów: true tylko na JEDNYM serwerze

rewards:
  # Komendy z konsoli. Placeholdery: %player% %service% %vote_id% %timestamp%
  commands:
    - "give %player% minecraft:diamond 2"
    - "eco give %player% 500"
  player-message: "&aDzięki za głos na &elista-oneblock.pl&a! Nagroda trafiła do Ciebie."
  broadcast: "&e%player% &azagłosował(a) na serwer na &elista-oneblock.pl&a! &7Zagłosuj i Ty: &f/glosuj"
  offline-queue:
    enabled: true           # nagroda czeka, aż gracz wejdzie na serwer
    expire-days: 7
    join-delay-seconds: 2

votifier-bridge:
  enabled: false            # true = VotifierEvent dla VotingPlugin/SuperbVote
  service-name: "lista-oneblock.pl"

messages:
  vote-link: "&aZagłosuj na serwer i odbierz nagrodę: &e&n%url%"

Placeholdery w komendach nagród

  • %player% — nick gracza (sprawdzony: tylko litery, cyfry i podkreślenia, opcjonalnie prefiks Bedrocka);
  • %service% — nazwa listy, czyli lista-oneblock.pl;
  • %vote_id% — numer głosu;
  • %timestamp% — czas oddania głosu (unix, sekundy).

Kolory w wiadomościach zapisujesz kodami &a, &e, &l albo &#RRGGBB. Pusty tekst ("") wyłącza daną wiadomość.

Komendy i uprawnienia

KomendaCo robiUprawnienie
/glosujKlikalny link do głosowania z nickiem gracza w adresie. Aliasy: /glosowanie, /glos, /vote.listaoneblock.glosuj (wszyscy)
/listaoneblock statusStan klucza, ostatni heartbeat i pobranie głosów, kolejka nagród, ostatni błąd. Skrót: /lob.listaoneblock.admin (OP)
/listaoneblock reloadPonowne wczytanie config.yml bez restartu serwera.listaoneblock.admin (OP)
/listaoneblock test <nick>Lokalny głos testowy — sprawdza komendy nagród i wiadomości, nie liczy się w rankingu.listaoneblock.admin (OP)
/listaoneblock glosujTo samo co /glosuj — gdy tę nazwę zajął już inny plugin.wszyscy

Skąd wziąć klucz pluginu?

Klucz generujesz w panelu właściciela: wybierz swój serwer, otwórz Klucz pluginu i kliknij „Wygeneruj klucz”. Każdy serwer ma własny klucz, a lista przechowuje tylko jego skrót.

Traktuj klucz jak hasło: nie wklejaj go na Discordzie ani w zgłoszeniach. Jeśli wycieknie, wygeneruj nowy — stary przestaje działać od razu, a plugin pokaże to w /listaoneblock status.

Wolisz Votifier?

Lista wysyła głosy także przez NuVotifier (protokół v2 z tokenem albo v1 z kluczem RSA). Wymaga to otwartego portu Votifiera i ustawienia adresu w panelu. Instrukcję znajdziesz na stronie dla administratorów.

Gdy plugin ListaOneBlock jest aktywny, lista domyślnie nie wysyła głosów Votifierem, więc gracze nie dostaną nagrody podwójnie. Jeśli masz VotingPlugin, ustaw votifier-bridge.enabled: true i rewards.commands: [] — nagrody wyda VotingPlugin, a port nadal może pozostać zamknięty.

Najczęstsze pytania

Czy plugin jest darmowy?

Tak. Plugin i dodanie serwera do listy są bezpłatne. Plugin nie wyświetla reklam i nie zbiera danych graczy.

Czy muszę otwierać port albo instalować Votifier?

Nie. Plugin co 30 sekund sam pobiera nowe głosy z listy przez HTTPS. Votifier jest potrzebny tylko wtedy, gdy chcesz korzystać z mostu VotifierEvent dla VotingPlugin lub SuperbVote — i nawet wtedy jego port nie musi być otwarty.

Co się dzieje, gdy gracz zagłosuje, będąc offline?

Głos trafia do kolejki zapisanej w pliku votes.json. Gdy gracz wejdzie na serwer, po 2 sekundach dostaje nagrodę. Nieodebrana nagroda wygasa po liczbie dni ustawionej w expire-days (domyślnie 7). Jeśli wolisz wydawać nagrody od razu, ustaw offline-queue.enabled: false.

Mam sieć serwerów na Velocity lub BungeeCord. Gdzie zainstalować plugin?

Na serwerach backendowych (Paper/Spigot/Folia), nie na proxy. Głosy włącz tylko na jednym z nich (votes.enabled: true), na pozostałych ustaw false — wtedy wysyłają tylko statystyki i obsługują /glosuj. Klucz może być ten sam.

Jakie dane plugin wysyła do listy?

Tylko liczby i wersje: wersję pluginu, platformę (Paper, Folia, Spigot), wersję Minecrafta, liczbę graczy online i sloty, TPS oraz informację, czy odbierasz głosy. Plugin nie wysyła nicków, UUID ani adresów IP graczy.

W /listaoneblock status widzę „ODRZUCONY (401)”. Co zrobić?

Lista nie rozpoznała klucza: został źle skopiowany albo wygenerowano nowy. Wygeneruj klucz w panelu (twój serwer → Klucz pluginu), wklej go w api-key i wpisz /listaoneblock reload. Plugin po odrzuceniu klucza czeka 10 minut, żeby nie zasypywać listy zapytaniami.

Czy plugin działa na Folii i najnowszym Minecrafcie?

Tak. Plugin ma flagę folia-supported i korzysta z harmonogramów Folii (komendy nagród wykonuje na wątku regionu globalnego). Działa na Paperze 26.3 i starszych wersjach od 1.18.2, także na Canvasie i Purpurze.

Komenda /glosuj należy już do innego pluginu. Co teraz?

Plugin, który zarejestrował /glosuj wcześniej, zachowa ją. Gracze mogą wtedy użyć /listaoneblock glosuj (albo /lob glosuj). Alias /vote zawsze ustępuje VotingPluginowi, więc nie psuje jego komendy.

Jak sprawdzić, czy pobrany plik jest oryginalny?

Porównaj sumę SHA-256 pliku z sumą podaną na tej stronie. Na Linuksie: sha256sum ListaOneBlock-1.0.0.jar. W Windows PowerShell: (Get-FileHash ListaOneBlock-1.0.0.jar).Hash.ToLower() — samo Get-FileHash wypisuje sumę wielkimi literami, a wielkość liter nie ma znaczenia. Poza tym wszystkie 64 znaki muszą się zgadzać.

Nie znalazłeś odpowiedzi? Napisz na [email protected].