ProtocolLib
Biblioteka do modyfikacji pakietow sieciowych Minecraft. Wymagana przez wiele pluginow do tworzenia hologramow, NPC, tab listu i efektow wizualnych.
O pluginie ProtocolLib
ProtocolLib to niskopoziomowa biblioteka, która pozwala pluginom przechwytywac i modyfikować pakiety sieciowe przesylane między serwerem a klientem. W praktyce oznacza to, ze pluginy moga tworzyć elementy, które klient widzi, ale które nie istnieja po stronie serwera: hologramy (unosacy sie tekst), NPC widoczne tylko dla konkretnych graczy, modyfikacje tab listu, niestandardowe efekty czasteczkowe i wiele więcej. ProtocolLib sam z siebie nie dodaje żadnych funkcji widocznych w grze.
Jest czysta biblioteka, która inne pluginy wykorzystuja pod spodem. Jezeli 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 pluginow API, który powinienes rozwazyc 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 skonfigurowac w pliku konfiguracyjnym pluginu.
- Przechwytywanie pakietow sieciowych
- Modyfikacja pakietow w locie
- Tworzenie wirtualnych bytow (hologramy, NPC)
- Wymagana przez dziesiatki pluginow
Komendy ProtocolLib
ProtocolLib rejestruje 2 komend (pokazujemy najważniejsze). Pelna lista dostepna jest w oficjalnej dokumentacji. Pamietaj, ze każda komende możesz zablokowac lub odlokowac przez system uprawnien (np. LuckPerms).
| Komenda | Opis | Uprawnienie |
|---|---|---|
/protocol | Informacje o ProtocolLib | protocol.admin |
/protocol config reload | Przeladowuje konfiguracje | protocol.admin |
Uprawnienia (permissions)
System uprawnien pozwala kontrolowac, kto może używać poszczegolnych funkcji ProtocolLib. Uprawnienia nadajesz przez plugin rang, np. LuckPerms (/lp group [grupa] permission set [node] true). Kolumna "Domyslnie 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 ustawien 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 uzyj komendy przeladowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jeśli plugin nie pobiera zmian po przeladowaniu, zrestartuj serwer komenda /stop.
Jak zainstalowac ProtocolLib
Pobierz ProtocolLib ze SpigotMC. Wrzuc .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 sie, 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 uzywaj/reloadprzy pierwszej instalacji. - Sprawdź konsole serwera. Jeśli ProtocolLib zaladowal sie poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił sie błąd, sprawdź czy masz zainstalowane wszystkie zaleznosciow.
-
Skonfiguruj plugin edytujac plik
plugins/ProtocolLib/config.yml(lub odpowiednik). Po zmianach uzyj komendy przeladowania.
Alternatywy dla ProtocolLib
ProtocolLib nie jest jedynym pluginem w swojej kategorii. Poniżej znajdziesz alternatywy, które warto rozwazyc, jeśli szukasz czegos innego lub ProtocolLib nie spelnia Twoich oczekiwan.
PacketEvents
Nowsza, lzejsza biblioteka pakietow. Rosnie w popularności jako zamiennik ProtocolLib.
Często zadawane pytania o ProtocolLib
Jak zainstalowac ProtocolLib?
Pobierz ProtocolLib ze SpigotMC. Wrzuc .jar do plugins/ i zrestartuj serwer. Nie wymaga konfiguracji. Sprawdź, czy wersja ProtocolLib jest kompatybilna z wersja Twojego serwera. Szczegolowa instrukcja z zaleznosciami i konfiguracja znajduje sie w sekcji instalacja powyżej.
Na jakich silnikach serwerowych działa ProtocolLib?
ProtocolLib działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik — wiekszosci serwerow daje najlepsza rownowage miedzy wydajnoscia a kompatybilnoscia z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porownaniu.
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 robic?
Sprawdź plik logs/latest.log w katalogu serwera. Najczestsze 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 moge 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