ProtocolLib
Biblioteka do modyfikacji pakietów sieciowych Minecraft. Wymagana przez wiele pluginów do tworzenia hologramów, NPC, tab listu i efektów wizualnych.
O pluginie ProtocolLib
ProtocolLib to niskopoziomowa biblioteka, która pozwala pluginom przechwytywac i modyfikować pakiety sieciowe przesyłane między serwerem a klientem. W praktyce oznacza to, ze pluginy mogą tworzyć elementy, które klient widzi, ale które nie istnieją po stronie serwera: hologramy (unosacy się tekst), NPC widoczne tylko dla konkretnych graczy, modyfikacje tab listu, niestandardowe efekty cząsteczkowe i wiele więcej. ProtocolLib sam z siebie nie dodaje żadnych funkcji widocznych w grze.
Jest czysta biblioteka, która inne pluginy wykorzystują pod spodem. Jeżeli jakikolwiek zainstalowany plugin wymaga ProtocolLib w swoich dependencjach, musisz go zainstalować. Bez niego zależny plugin nie załaduje sie.
ProtocolLib to jeden z fundamentalnych pluginów API, który powinienes rozważyć na swoim serwerze Minecraft. Wspiera wersje 1.8 - 1.21.x i działa na Spigot, Paper, Purpur.
Funkcje ProtocolLib
Poniżej lista głównych funkcji, które ProtocolLib dodaje do Twojego serwera. Każda z nich można skonfigurować w pliku konfiguracyjnym pluginu.
- Przechwytywanie pakietów sieciowych
- Modyfikacja pakietów w locie
- Tworzenie wirtualnych bytów (hologramy, NPC)
- Wymagana przez dziesiątki pluginów
Komendy ProtocolLib
ProtocolLib rejestruje 2 komend (pokazujemy najważniejsze). Pelna lista dostępna jest w oficjalnej dokumentacji. Pamiętaj, ze każda komendę możesz zablokować lub odlokowac przez system uprawnień (np. LuckPerms).
| Komenda | Opis | Uprawnienie |
|---|---|---|
/protocol | Informacje o ProtocolLib | protocol.admin |
/protocol config reload | Przeładowuje konfiguracje | protocol.admin |
Uprawnienia (permissions)
System uprawnień pozwala kontrolować, kto może używać poszczególnych funkcji ProtocolLib. Uprawnienia nadajesz przez plugin rang, np. LuckPerms (/lp group [grupa] permission set [node] true). Kolumna "Domyślnie OP" oznacza, czy operatorzy serwera maja to uprawnienie bez konfiguracji.
Konfiguracja ProtocolLib
Po pierwszym uruchomieniu ProtocolLib wygeneruje plik konfiguracyjny w folderze plugins/ProtocolLib/. Poniżej najważniejsze opcje z komentarzami. Pełna lista ustawień jest w oficjalnej dokumentacji.
# config.yml ProtocolLib
global:
auto updater:
notify: true # Powiadamiaj o aktualizacjach
metrics: true # Anonimowe statystyki (bStats)
# ProtocolLib nie wymaga konfiguracji.
# Zainstaluj i zapomnij - działa w tle.
Po zmianie konfiguracji zapisz plik i użyj komendy przeładowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jeśli plugin nie pobiera zmian po przeładowaniu, zrestartuj serwer komenda /stop.
Jak zainstalować ProtocolLib
Pobierz ProtocolLib ze SpigotMC. Wrzuć .jar do plugins/ i zrestartuj serwer. Nie wymaga konfiguracji. Sprawdź, czy wersja ProtocolLib jest kompatybilna z wersja Twojego serwera.
- Pobierz ProtocolLib z oficjalnej strony. Upewnij się, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.8 - 1.21.x).
-
Skopiuj pobrany plik
.jardo folderuplugins/w katalogu Twojego serwera. -
Zrestartuj serwer komenda
/stopi uruchom go ponownie. Nie używaj/reloadprzy pierwszej instalacji. - Sprawdź konsole serwera. Jeśli ProtocolLib załadował się poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił się błąd, sprawdź czy masz zainstalowane wszystkie zaleznosciow.
-
Skonfiguruj plugin edytujac plik
plugins/ProtocolLib/config.yml(lub odpowiednik). Po zmianach użyj komendy przeladowania.
Alternatywy dla ProtocolLib
ProtocolLib nie jest jedynym pluginem w swojej kategorii. Poniżej znajdziesz alternatywy, które warto rozważyć, jeśli szukasz czegoś innego lub ProtocolLib nie spełnia Twoich oczekiwan.
PacketEvents
Nowsza, lżejsza biblioteka pakietow. Rośnie w popularności jako zamiennik ProtocolLib.
Często zadawane pytania o ProtocolLib
Jak zainstalować ProtocolLib?
Pobierz ProtocolLib ze SpigotMC. Wrzuć .jar do plugins/ i zrestartuj serwer. Nie wymaga konfiguracji. Sprawdź, czy wersja ProtocolLib jest kompatybilna z wersja Twojego serwera. Szczegolowa instrukcja z zależnościami i konfiguracja znajduje się w sekcji instalacja powyżej.
Na jakich silnikach serwerowych działa ProtocolLib?
ProtocolLib działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik - większości serwerów daje najlepsza równowagę miedzy wydajnością a kompatybilnością z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porównaniu.
Czy ProtocolLib jest darmowy?
Tak, ProtocolLib jest darmowy i dostępny na SpigotMC. Kod źródłowy jest otwarty na GitHub.
ProtocolLib nie działa - co robić?
Sprawdź plik logs/latest.log w katalogu serwera. Najczęstsze przyczyny błędów: (1) brakujaca zależność, (2) niekompatybilna wersja Minecraft (sprawdź czy masz 1.8 - 1.21.x), (3) błąd w pliku config.yml (sprawdź format YAML), (4) konflikt z innym pluginem o tej samej funkcji.
Czy mogę używać ProtocolLib na serwerze Bedrock?
Nie. ProtocolLib to plugin Java Edition i działa na serwerach Spigot/Paper/Purpur. Bedrock Edition używa innego systemu (behavior packs). Jeśli chcesz łączyć graczy Java i Bedrock na jednym serwerze, sprawdź Geyser.
Komentarze