LiteBans - system banów i moderacji na serwerze Minecraft

Co to jest LiteBans

LiteBans to plugin do zarządzania karami graczy na serwerze Minecraft, tworzony przez dewelopera o pseudonimie Ruan. W odróżnieniu od darmowych alternatyw, LiteBans jest pluginem płatnym dostępnym na SpigotMC za około 8 EUR. To jednorazowa opłata - po zakupie możesz instalować plugin na dowolnej liczbie własnych serwerów.

Plugin obsługuje wszystkie standardowe kary: ban (stały i czasowy), mute (wyciszenie czatu), ostrzeżenia (warn), kick oraz IP ban. Główna przewaga LiteBans nad darmowymi rozwiązaniami to natywna synchronizacja przez MySQL lub MariaDB, która pozwala na network-wide bany - jeśli gracz zostanie zbanowany na jednym serwerze w sieci, automatycznie traci dostęp do wszystkich pozostałych backendów.

Plugin działa na Spigot, Paper, Purpur oraz serwerach proxy BungeeCord, Velocity i Waterfall. Od wersji 2.10 obsługuje też graczy łączących się przez GeyserMC (Bedrock Edition), co jest istotne dla serwerów z trybem crossplay.

Historia kar jest przechowywana w bazie danych, a nie w plikach YAML. Dzięki temu baza utrzymuje pełną historię nawet po milionach rekordów bez utraty wydajności. Plugin zawiera wbudowany interfejs webowy do przeglądania listy banów, mute'ów i ostrzeżeń przez przeglądarkę.

Komendy moderacyjne

LiteBans rozróżnia kary stałe i czasowe. Czasowe kary używają formatu czasu: 1d (1 dzień), 3h (3 godziny), 30m (30 minut), 1mo (1 miesiąc). Poniżej pełna lista komend moderacyjnych:

Uprawnienia do komend zarządzasz przez LuckPerms. Możesz przypisać moderatorom dostęp tylko do /warn, /mute i /kick, a adminowi pełny dostęp do banów i historii.

Polecenie /staffhistory jest szczególnie przydatne podczas audytu pracy moderatorów - pozwala sprawdzić, ile kar wystawił dany moderator i z jakich powodów, co ułatwia wychwycenie nadużyć uprawnień.

MySQL i bany sieciowe

Domyślnie LiteBans przechowuje dane w lokalnej bazie H2 (plik na dysku). Na pojedynczym serwerze to rozwiązanie wystarczające i nie wymaga konfiguracji bazy danych. Problem pojawia się przy sieciach wielu serwerów - każdy backend ma wtedy osobną bazę i bany nie są synchronizowane.

Rozwiązaniem jest podłączenie wszystkich backendów do wspólnej bazy MySQL lub MariaDB. Po zmianie w konfiguracji każdy z serwerów odczytuje i zapisuje kary do tej samej bazy, co oznacza network-wide bany: zbanowanie gracza na Survival automatycznie blokuje mu dostęp do Skyblock, Creative, PvP i każdego innego serwera w sieci.

Konfiguracja połączenia z MySQL w pliku plugins/LiteBans/config.sql.yml:

sql:
  driver: MySQL      # lub MariaDB
  host: "localhost"
  port: 3306
  name: "litebans"
  user: "litebans_user"
  password: "silnehaslo"
  pool_size: 5       # liczba połączeń w puli

Tabelę i schemat LiteBans tworzy sam przy pierwszym uruchomieniu. Wystarczy stworzyć pustą bazę litebans i konto użytkownika z uprawnieniami SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER.

Jeśli używasz BungeeCord lub Velocity, możesz zainstalować LiteBans zarówno na proxy jak i na backendach, lub tylko na backendach ze wspólną bazą MySQL. Instalacja na proxy pozwala banować graczy nawet przed wejściem na konkretny backend, co zapobiega omijaniu bana przez szybkie przełączanie serwerów.

Interfejs webowy

LiteBans zawiera wbudowany serwer HTTP, który wystawia publiczną stronę z listą aktywnych banów, mute'ów, ostrzeżeń i kicków. Gracze mogą sami sprawdzić szczegóły swojej kary - powód, czas trwania, datę wystawienia i który moderator ją nałożył.

Interfejs webowy włącza się w pliku plugins/LiteBans/config.web.yml:

web:
  enabled: true
  host: "0.0.0.0"      # nasłuchuj na wszystkich interfejsach
  port: 8080            # port HTTP
  path: "/"             # ścieżka bazowa
  show_ips: false       # nie ujawniaj adresów IP publicznie
  records_per_page: 20  # liczba rekordów na stronę

Po uruchomieniu strona jest dostępna pod adresem http://ip-serwera:8080. Aby wystawić ją pod własną domeną (np. bans.twojserwer.pl), użyj reverse proxy (nginx lub Caddy) przekierowanego na port 8080.

Interfejs webowy obsługuje stronicowanie, sortowanie po kolumnach i filtrowanie po typie kary. Wygląd strony można dostosować przez własne szablony HTML i arkusze CSS - pliki szablonów znajdują się w katalogu plugins/LiteBans/web/.

Powody i szablony kar

LiteBans obsługuje predefiniowane szablony powodów kar. Zamiast za każdym razem pisać pełny powód, moderator może użyć skrótu, który plugin rozwijana do pełnej treści. Szablony definiuje się w pliku plugins/LiteBans/reasons.yml:

reasons:
  hacking: "Korzystanie z niedozwolonych modyfikacji (cheaty/haki)"
  spam: "Spam w czacie serwera"
  reklama: "Reklama innych serwerów Minecraft"
  wulgaryzmy: "Używanie wulgaryzmów lub mowy nienawiści"
  griefing: "Niszczenie cudzych budowli bez zgody"
  xray: "Korzystanie z X-Ray (niedozwolona modyfikacja)"

Teraz moderator może wpisać /ban Gracz hacking, a LiteBans automatycznie wstawi pełny powód. Gracz zobaczy na ekranie rozwinięty komunikat, nie skrót.

Szablony redukują literówki w powodach kar i ujednolicają komunikację z graczami. Ułatwiają też późniejszą analizę statystyk - można wyfiltrować wszystkich graczy zbanowanych za konkretny powód.

W komunikatach banów możesz używać zmiennych takich jak {TIME} (czas trwania), {REASON} (powód), {STAFF} (moderator), {ID} (numer bana) czy {EXPIRES} (data wygaśnięcia). Treść komunikatów edytuje się w pliku plugins/LiteBans/messages.yml.

IP ban i wykrywanie omijania

LiteBans obsługuje bany po adresie IP komendą /ipban. Po zbanowaniu IP żaden gracz łączący się z tego adresu nie wejdzie na serwer, niezależnie od nazwy konta. To skuteczna metoda na graczy, którzy tworzą nowe konta, żeby ominąć ban (tzw. ban evasion).

Wbudowany system alt detection automatycznie wykrywa alternatywne konta. Gdy zbanowany gracz spróbuje wejść z nowego konta, ale z tego samego adresu IP, LiteBans może:

• automatycznie zablokować nowe konto (tryb automatyczny),
• powiadomić moderatorów o wykryciu potencjalnego alt konta (tryb alertu),
• wymagać ręcznego zatwierdzenia przez admina przed odblokowaniem.

Konfiguracja alt detection w plugins/LiteBans/config.yml:

alts:
  enabled: true
  kick_alts: true          # automatycznie blokuj alt konta
  alert_staff: true        # powiadamiaj moderatorów
  max_accounts_per_ip: 2   # ile kont dozwolonych na jeden IP (dla rodzin)

Opcja max_accounts_per_ip jest istotna na serwerach, gdzie rodzeństwo lub współlokatorzy grają na tym samym łączu. Ustawienie wartości 2-3 pozwala na normalne granie, jednocześnie wykrywając nadużycia.

Warto pamiętać, że IP ban ma ograniczenia - gracze mogą zmieniać adres IP przez sieć VPN lub mobilny internet. Dlatego IP ban najlepiej łączyć z banem konta i monitorowaniem nowych rejestracji z podejrzanych zakresów IP.

LiteBans vs AdvancedBan vs EssentialsX bans

Wybór pluginu do zarządzania banami zależy głównie od rozmiaru serwera i budżetu:

EssentialsX oferuje proste bany i mute'y przechowywane w plikach YAML. To rozwiązanie wystarczające dla małych serwerów z kilkudziesięcioma graczami, gdzie nie zależy nam na rozbudowanej historii kar ani synchronizacji sieciowej.

AdvancedBan to bezpłatna alternatywa z bardziej rozbudowanym systemem kar niż EssentialsX, obsługująca MySQL i tzw. punishment ladder (automatyczne zaostrzanie kar przy powtórnych wykroczeniach). Jednak nie ma wbudowanego interfejsu webowego i alt detection jest słabsze niż w LiteBans.

LiteBans wybierają głównie sieci serwerów i projekty z kilkuset lub więcej aktywnymi graczami, gdzie liczy się niezawodność synchronizacji, publiczna lista banów i szczegółowe narzędzia audytu moderatorów.

Konfiguracja

Główny plik konfiguracyjny to plugins/LiteBans/config.yml. Najważniejsze ustawienia:

# Ogólne
date_format: "dd.MM.yyyy HH:mm"   # format dat (polski standard)
prefix: "&c[LiteBans] &f"          # prefix w wiadomościach

# Powiadomienia
broadcast_ban: true        # ogłaszaj bany na czacie serwera
broadcast_tempban: true    # ogłaszaj czasowe bany
broadcast_mute: false      # nie ogłaszaj mute'ów (opcja prywatności)
broadcast_warn: true       # ogłaszaj ostrzeżenia

# Zachowanie przy kicku
kick_message: true         # pokaż graczowi wiadomość przy kicku

# Bazy danych - patrz config.sql.yml
# Interfejs webowy - patrz config.web.yml

# Uprawnienia do pomijania kar
bypass.ban: "litebans.bypass.ban"
bypass.mute: "litebans.bypass.mute"

Plik plugins/LiteBans/messages.yml zawiera wszystkie komunikaty wyświetlane graczom. Możesz w nim dostosować wiadomość wyświetlaną przy banie, formacie czasu ("zbanowany na 3 dni i 2 godziny"), powiadomieniach moderatorów i wielu innych sytuacjach. Plugin obsługuje kody kolorów Minecraft i format MiniMessage.

Aby przeładować konfigurację bez restartu serwera, użyj /litebans reload z uprawnieniem litebans.reload. Zmiana ustawień bazy danych wymaga jednak pełnego restartu.

Cena i zakup

LiteBans jest dostępny wyłącznie na SpigotMC za około 8 EUR. To opłata jednorazowa - po zakupie możesz pobrać plugin i instalować go na dowolnej liczbie własnych serwerów. Nie ma subskrypcji ani opłat za aktualizacje.

Do zakupu na SpigotMC potrzebujesz konta SpigotMC oraz płatności przez PayPal lub kartę kredytową. Po zakupie plugin pojawi się w zakładce "Purchased Resources" na Twoim koncie i będziesz mógł pobierać kolejne aktualizacje bez dodatkowych opłat.

Warto zaznaczyć, że LiteBans jest jednym z niewielu pluginów Minecraft, które pozostają aktywnie rozwijane od ponad 10 lat jako projekt komercyjny. Regularne aktualizacje do nowych wersji Minecraft i solidna obsługa techniczna sprawiają, że cena jest uzasadniona dla serwerów z poważną strukturą moderacyjną.

Jeśli budżet jest ograniczony lub prowadzisz mały serwer dla znajomych, warto rozważyć darmowe alternatywy: AdvancedBan lub system banów wbudowany w EssentialsX. Na serwerach z mniej niż 50 aktywnymi graczami różnica w funkcjonalności rzadko jest odczuwalna.

Kompatybilność

LiteBans obsługuje szeroki zakres wersji i platform:

• Wersje Minecraft: od 1.7.10 do najnowszych wersji 1.21.x. Plugin jest aktualizowany przy każdej nowej wersji Minecraft w ciągu kilku dni od jej wydania.
• Silniki serwerowe: Spigot, Paper, Purpur i wszystkie forki oparte na Paper API. Nie obsługuje Fabric ani Forge.
• Proxy: BungeeCord, Waterfall, Velocity. LiteBans można zainstalować zarówno na proxy jak i na backendach.
• GeyserMC: Pełna obsługa graczy z Bedrock Edition łączących się przez Geyser. Bany działają na podstawie nazwy konta i UUID z mapowania Floodgate.
• Bazy danych: MySQL 5.7+, MariaDB 10.3+, H2 (lokalna), SQLite.
• Java: Java 8+ (zalecane Java 17 lub 21).

LiteBans nie ma zależności od innych pluginów - działa samodzielnie. Integruje się jednak poprawnie z LuckPerms w zakresie uprawnień oraz z ChatControlPro i innymi pluginami do moderacji chatu.

Plugin nie jest kompatybilny z wieloma innymi pluginami do banowania działającymi równolegle (AdvancedBan, MaxBans, BanManager) - używanie dwóch systemów banów jednocześnie powoduje konflikty. Jeśli migrujesz z innego systemu, LiteBans oferuje wbudowane narzędzie importu danych z popularnych alternatyw.

Więcej przydatnych pluginów znajdziesz w katalogu pluginów. Jeśli konfigurujesz uprawnienia do komend moderacyjnych, przeczytaj nasz poradnik o LuckPerms.