Co to jest BetterWhitelist

Wbudowana whitelist Minecraft jest prymitywna - można dodać gracza lub go usunąć, i to wszystko. BetterWhitelist rozszerza tę funkcjonalność o tymczasowe wpisy (whitelist na X godzin/dni), osobne whitelisty per serwer na sieciach, integrację z Discordem i zarządzanie przez panel webowy.

Whitelist jest kluczowa na serwerach prywatnych (zamkniętych społecznościach), serwerach beta/testowych i serwerach SMP, gdzie administratorzy chcą kontrolować, kto dołącza. BetterWhitelist sprawia, że zarządzanie listą dopuszczonych graczy jest wygodne i elastyczne.

Plugin jest dostępny na SpigotMC. Darmowa wersja pokrywa większość potrzeb.

Komendy

Komenda	Co robi	Uprawnienie
`/bwl add Gracz`	Dodaje gracza na whitelistę	betterwhitelist.add
`/bwl remove Gracz`	Usuwa gracza z whitelisty	betterwhitelist.remove
`/bwl tempadd Gracz czas`	Tymczasowy wpis (np. /bwl tempadd Steve 7d)	betterwhitelist.tempadd
`/bwl list`	Lista graczy na whiteliście	betterwhitelist.list
`/bwl on`	Włącza whitelistę	betterwhitelist.toggle
`/bwl off`	Wyłącza whitelistę	betterwhitelist.toggle
`/bwl check Gracz`	Sprawdza czy gracz jest na liście	betterwhitelist.check
`/bwl reload`	Przeładowanie konfiguracji	betterwhitelist.reload

Tymczasowe wpisy

Tymczasowe wpisy to główna przewaga BetterWhitelist nad standardową whitelistą. Przykłady użycia:

Eventy - otwierasz serwer na weekend, dodając graczy na 48h. Po evencie whitelist automatycznie wraca do normalnego stanu
Okres próbny - nowy gracz dostaje tymczasowy dostęp na 7 dni. Jeśli się sprawdzi, dodajesz go na stałe
Beta testy - testerzy dostają dostęp na czas testów, nie musisz pamiętać o ręcznym usuwaniu
Karuzele graczy - na serwerach z limitem miejsc rotacja tymczasowych slotów pozwala większej społeczności grać na zmianę

Formaty czasu: m (minuty), h (godziny), d (dni), w (tygodnie). Przykład: /bwl tempadd Steve 14d dodaje gracza na 14 dni.

Integracja z Discordem

BetterWhitelist może połączyć się z botem Discord, umożliwiając zarządzanie whitelistą bezpośrednio z serwera Discord:

Aplikacje przez Discord - gracze wpisują nick w dedykowanym kanale, a bot automatycznie dodaje ich na whitelistę (opcjonalnie z akceptacją staffu)
Komendy bota - staff zarządza whitelistą komendami Discorda bez konieczności logowania się na serwer MC
Powiadomienia - bot informuje o nowych aplikacjach, wygasających wpisach i zmianach na liście
Weryfikacja - gracz musi połączyć konto Discord z nickiem Minecraft, żeby dostać whitelist

Integracja z Discordem jest szczególnie przydatna na serwerach prywatnych, gdzie aplikacja na Discord jest standardowym procesem dołączania.

Konfiguracja

Główny plik to plugins/BetterWhitelist/config.yml:

# Wiadomość przy odmowie dostępu
kick-message: "&cNie jestes na whiteliscie!\n&7Aplikuj na naszym Discordzie: discord.gg/twojserwer"

# Baza danych (dla synchronizacji BungeeCord)
database:
  type: SQLITE   # SQLITE lub MYSQL
  mysql:
    host: "localhost"
    port: 3306
    database: "whitelist"

# Discord bot (opcjonalny)
discord:
  enabled: false
  token: ""
  application-channel: "whitelist-aplikacje"
  auto-accept: false  # true = automatyczne dodawanie, false = wymaga akceptacji staffu

Na sieciach BungeeCord/Velocity z MySQL whitelist synchronizuje się między serwerami. Gracz dodany na jednym serwerze automatycznie ma dostęp do wszystkich.

Typowe zastosowania

Serwer SMP prywatny - zamknięta społeczność, aplikacja przez Discord, akceptacja przez staffa
Serwer beta/testowy - tymczasowe wpisy dla testerów, automatyczne usuwanie po zakończeniu testów
Serwer z rekrutacją - nowi gracze dostają okres próbny, stali gracze mają stały wpis
Event serwer - whitelist włączana tylko na czas eventu z tymczasowymi wpisami

BetterWhitelist współpracuje z LuckPerms (uprawnienia do komend whitelisty), EssentialsX (podstawowe zarządzanie serwerem) i DiscordSRV (rozszerzona integracja z Discordem).