Dla administratorów

1. Konto i dodanie serwera

Załóż konto (e-mail i hasło), a potem wypełnij formularz dodawania serwera: adres Java lub Bedrock (albo oba), nazwę, krótki opis, wersje, liczbę faz, plugin OneBlock, co-op, P2W, datę startu edycji i linki. Lista przyjmuje tylko serwery z trybem OneBlock.

Nowy wpis czeka na pierwszy udany ping z naszego monitoringu — zwykle kilka minut. Potem pojawia się na liście i w rankingu. Serwer jest już na liście, bo dodaliśmy go automatycznie? Nie dodawaj go drugi raz: na stronie serwera kliknij „Przejmij”.

2. Weryfikacja własności

Zweryfikowany serwer dostaje odznakę i pełną kontrolę nad opisem. Wybierz jedną z trzech metod:

• MOTD — w panelu dostaniesz kod lob-xxxxxx. Dopisz go do MOTD (np. w server.properties albo w konfiguracji proxy), przeładuj serwer i kliknij „Sprawdź MOTD”. Po weryfikacji kod możesz usunąć.
• Rekord DNS TXT — dodaj rekord TXT lista-oneblock=lob-xxxxxx na domenie serwera (albo na domenie głównej). Działa także dla serwerów Bedrock.
• Plugin listy — wygeneruj klucz w panelu i zainstaluj plugin. Heartbeat wysłany z adresu IP serwera potwierdza własność automatycznie. Jeśli serwer stoi za proxy z innym adresem IP (np. ochrona DDoS), użyj MOTD lub DNS.

3. Plugin listy

Plugin ListaOneBlock (Paper, Folia, Spigot) pobiera głosy z listy co 30 sekund i wydaje nagrody — bez otwierania portów i bez Votifiera. Gracz offline dostanie nagrodę po wejściu na serwer. Plugin wysyła też heartbeat (wersja, TPS, liczba graczy), dzięki czemu na liście widać, że serwer naprawdę działa.

1. Pobierz plugin ze strony /plugin i wrzuć go do katalogu plugins.
2. W panelu serwera kliknij „Wygeneruj klucz pluginu”. Klucz (lob_srv_…) pokazujemy tylko raz.
3. Wklej go do plugins/ListaOneBlock/config.yml jako api-key i przeładuj plugin.
4. Ustaw nagrody w sekcji rewards. W sieci serwerów włącz głosy tylko na jednym serwerze.

4. Votifier

Masz już NuVotifier z VotingPlugin albo SuperbVote? Lista wyśle każdy głos na twój Votifier. W panelu serwera podaj:

• adres i port Votifiera (domyślnie 8192; port musi być otwarty z internetu),
• token v2 z plugins/Votifier/config.yml (sekcja tokens, zwykle default) — zalecane,
• albo klucz publiczny v1 z plugins/Votifier/rsa/public.key (tylko stary Votifier).

W VotingPlugin dodaj stronę głosowania z ServiceSite: 'lista-oneblock.pl' — tak nazywa się nasz serwis w każdym głosie (serviceName). Nick gracza trafia w polu username, a adres w polu address to zawsze 127.0.0.1 — nie przekazujemy adresów IP graczy.

Po zapisaniu ustawień kliknij „Wyślij testowy głos” — od razu zobaczysz, czy połączenie i token działają.

Tryb wysyłania: „automatycznie” (domyślnie) wysyła Votifierem tylko wtedy, gdy plugin listy nie działa — żeby gracz nie dostał nagrody dwa razy. „Zawsze” wysyła głos oboma kanałami, „nigdy” wyłącza Votifier.

5. Jak działa kolejka nagród

• Gracz może oddać jeden głos na serwer na dobę (licznik zeruje się o północy czasu polskiego), z jednego nicku i jednego połączenia.
• Plugin listy odbiera głosy sam i potwierdza ich odbiór. Głos, którego plugin nie potwierdził, wraca w kolejnym pobraniu — nagroda nie przepada i nie dubluje się.
• Votifier dostaje głos od razu. Gdy serwer nie odpowiada, ponawiamy po 1, 5, 15 i 60 minutach, potem co 6 godzin. Po 24 godzinach głos oznaczamy jako nieudany — statystyki i ostatnie błędy zobaczysz w panelu.
• Ranking liczy głosy z bieżącego miesiąca; 1. dnia miesiąca licznik startuje od zera.

6. Odznaki i widgety

Pochwal się miejscem w rankingu: na stronie widgetów i odznak znajdziesz kod przycisku „Głosuj” i odznaki z miejscem w rankingu do wklejenia na stronę serwera lub Discord.

Pytania

Coś nie działa albo masz pomysł? Napisz na [email protected]. Zasady listy znajdziesz w regulaminie, a opis rankingu na stronie jak działa ranking.