Discord

ProtocolLib

Biblioteka do modyfikacji pakietow sieciowych Minecraft. Wymagana przez wiele pluginow do tworzenia hologramow, NPC, tab listu i efektow wizualnych.

API i biblioteki SpigotPaperPurpur

O pluginie ProtocolLib

ProtocolLib to niskopoziomowa biblioteka, ktora pozwala pluginom przechwytywac i modyfikowac pakiety sieciowe przesylane miedzy serwerem a klientem. W praktyce oznacza to, ze pluginy moga tworzyc elementy, ktore klient widzi, ale ktore nie istnieja po stronie serwera: hologramy (unosacy sie tekst), NPC widoczne tylko dla konkretnych graczy, modyfikacje tab listu, niestandardowe efekty czasteczkowe i wiele wiecej. ProtocolLib sam z siebie nie dodaje zadnych funkcji widocznych w grze.

Jest czysta biblioteka, ktora inne pluginy wykorzystuja pod spodem. Jezeli jakikolwiek zainstalowany plugin wymaga ProtocolLib w swoich dependencjach, musisz go zainstalowac. Bez niego zależny plugin nie załaduje sie.

ProtocolLib to jeden z fundamentalnych pluginow API, ktory powinienes rozwazyc na swoim serwerze Minecraft. Wspiera wersje 1.8 - 1.21.x i dziala na Spigot, Paper, Purpur.

Funkcje ProtocolLib

Ponizej lista glownych funkcji, ktore ProtocolLib dodaje do Twojego serwera. Kazda z nich mozna 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 najwazniejsze). Pelna lista dostepna jest w oficjalnej dokumentacji. Pamietaj, ze kazda komende mozesz zablokowac lub odlokowac przez system uprawnien (np. LuckPerms).

Komenda Opis Uprawnienie
/protocol Informacje o ProtocolLib protocol.admin
/protocol config reload Przeladowuje konfiguracje protocol.admin
Podpowiedz: Uzyj autouzupelniania w konsoli serwera (Tab), zeby zobaczyc dostepne argumenty komend. Na serwerze z LuckPerms nadawaj uprawnienia grupom, nie pojedynczym graczom.

Uprawnienia (permissions)

System uprawnien pozwala kontrolowac, kto moze uzywac 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.

Node uprawnienia Opis Domyslnie OP
protocol.admin Zarzadzanie ProtocolLib Tak

Konfiguracja ProtocolLib

Po pierwszym uruchomieniu ProtocolLib wygeneruje plik konfiguracyjny w folderze plugins/ProtocolLib/. Ponizej najwazniejsze opcje z komentarzami. Pelna lista ustawien jest w oficjalnej dokumentacji.

config.yml Przykladowa konfiguracja
# config.yml ProtocolLib
global:
  auto updater:
    notify: true     # Powiadamiaj o aktualizacjach
  metrics: true      # Anonimowe statystyki (bStats)
# ProtocolLib nie wymaga konfiguracji.
# Zainstaluj i zapomnij - dziala w tle.

Po zmianie konfiguracji zapisz plik i uzyj komendy przeladowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jesli plugin nie pobiera zmian po przeladowaniu, zrestartuj serwer komenda /stop.

YAML to wredny format. Jeden bledny spacja albo tabulacja moze zepsuc caly plik. Uzywaj edytora z podswietlaniem skladni (VS Code, Notepad++) i sprawdzaj plik na yamllint.com przed wrzuceniem na serwer.

Jak zainstalowac ProtocolLib

Pobierz ProtocolLib ze SpigotMC. Wrzuc .jar do plugins/ i zrestartuj serwer. Nie wymaga konfiguracji. Sprawdz, czy wersja ProtocolLib jest kompatybilna z wersja Twojego serwera.

  1. Pobierz ProtocolLib z oficjalnej strony. Upewnij sie, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.8 - 1.21.x).
  2. Skopiuj pobrany plik .jar do folderu plugins/ w katalogu Twojego serwera.
  3. Zrestartuj serwer komenda /stop i uruchom go ponownie. Nie uzywaj /reload przy pierwszej instalacji.
  4. Sprawdz konsole serwera. Jesli ProtocolLib zaladowal sie poprawnie, zobaczysz komunikat z wersja pluginu. Jesli pojawil sie blad, sprawdz czy masz zainstalowane wszystkie zaleznosciow.
  5. Skonfiguruj plugin edytujac plik plugins/ProtocolLib/config.yml (lub odpowiednik). Po zmianach uzyj komendy przeladowania.
Kompatybilnosc serwerow: ProtocolLib dziala na Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik serwera — ma lepsza wydajnosc i wiecej API niz Spigot.

Alternatywy dla ProtocolLib

ProtocolLib nie jest jedynym pluginem w swojej kategorii. Ponizej znajdziesz alternatywy, ktore warto rozwazyc, jesli szukasz czegos innego lub ProtocolLib nie spelnia Twoich oczekiwan.

PacketEvents

Nowsza, lzejsza biblioteka pakietow. Rosnie w popularnosci jako zamiennik ProtocolLib.

Czesto zadawane pytania o ProtocolLib

Jak zainstalowac ProtocolLib?

Pobierz ProtocolLib ze SpigotMC. Wrzuc .jar do plugins/ i zrestartuj serwer. Nie wymaga konfiguracji. Sprawdz, czy wersja ProtocolLib jest kompatybilna z wersja Twojego serwera. Szczegolowa instrukcja z zaleznosciami i konfiguracja znajduje sie w sekcji instalacja powyzej.

Na jakich silnikach serwerowych dziala ProtocolLib?

ProtocolLib dziala na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik — wiekszosci serwerow daje najlepsza rownowage miedzy wydajnoscia a kompatybilnoscia z pluginami. Wiecej o silnikach serwerowych przeczytasz w naszym porownaniu.

Czy ProtocolLib jest darmowy?

Tak, ProtocolLib jest darmowy i dostepny na SpigotMC. Kod zrodlowy jest otwarty na GitHub.

ProtocolLib nie dziala — co robic?

Sprawdz plik logs/latest.log w katalogu serwera. Najczestsze przyczyny bledow: (1) brakujaca zaleznosc, (2) niekompatybilna wersja Minecraft (sprawdz czy masz 1.8 - 1.21.x), (3) blad w pliku config.yml (sprawdz format YAML), (4) konflikt z innym pluginem o tej samej funkcji.

Czy moge uzywac ProtocolLib na serwerze Bedrock?

Nie. ProtocolLib to plugin Java Edition i dziala na serwerach Spigot/Paper/Purpur. Bedrock Edition uzywa innego systemu (behavior packs). Jesli chcesz laczyc graczy Java i Bedrock na jednym serwerze, sprawdz Geyser.

Inne pluginy z kategorii API i biblioteki

Komentarze