Plugin Minecraft ItemJoin

🔌 O ItemJoin

ItemJoin to wtyczka do Minecrafta, która automatycznie daje graczom w pełni konfigurowalne niestandardowe przedmioty. Przedmioty mogą być przyznawane przy zdarzeniach takich jak join, first-join, respawn, world-switch, region-enter i region-leave. Wtyczka skupia się na elastycznych definicjach przedmiotów (itemflags), zdarzeniach wyzwalających i komendach powiązanych z przedmiotami, dzięki czemu serwery mogą udostępniać menu lobby, zestawy startowe lub narzędzia zależne od kontekstu bez własnych modów po stronie klienta.

🎯 Cel

ItemJoin rozwiązuje problem niezawodnego dawania graczom niestandardowych lub interaktywnych przedmiotów powiązanych ze zdarzeniami i światami serwera. Jest przydatny dla serwerów hub/lobby, serwerów minigier, sieci survival (gdzie przedmioty muszą być ograniczone per świat) oraz sieci, które potrzebują menu opartego na przedmiotach lub przedmiotów uruchamiających komendy.

⚙️ Funkcje

• Przyznawanie przedmiotów na konfigurowalnych triggerach: join, first-join, respawn, world-switch, region-enter/exit i podobnych zdarzeniach.
• itemflags per przedmiot, które zmieniają zachowanie (slot, overwrite, reguły stackowania, blokowanie ruchu/podnoszenia, limity gamemode, szansa otrzymania, cooldowny).
• ItemCommands: dołączanie komend do przedmiotów i konfiguracja kontekstu wykonania (console, player, server, message) oraz typów akcji (lewy/prawy klik, klik w ekwipunek, fizyczny, wieloklik).
• Integracja z PlaceholderAPI dla dynamicznych nazw/lore przedmiotów i obsługi placeholderów.
• Obsługa niestandardowych głów graczy (własne tekstury i właściciele), obrazów na mapach, tipped arrows, książek, banerów, fajerwerków, personalizacji skórzanej zbroi i niestandardowych poziomów zaklęć.
• Opcjonalne blokowanie ruchu lub podnoszenia przedmiotów w wybranych światach oraz ograniczanie przedmiotów według adresu IP lub stanu first-join.
• Wbudowany kreator GUI do budowania zestawów przedmiotów oraz zintegrowany przepływ importu/tworzenia.
• API dla innych wtyczek: dostępne pod me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Dla kogo

• Właściciele serwerów potrzebujący automatycznych przedmiotów lobby/hub lub zestawów startowych.
• Operatorzy minigier i sieci wymagający przedmiotów zależnych od świata lub kompasów menu.
• Programiści, którzy chcą systemu przedmiotów z API do podłączania.

🏗️ Przykładowe zastosowania

• Dawać graczom kompas menu przy dołączeniu, który uruchamia różne komendy po kliknięciu.
• Zapewnić jednorazowe zestawy startowe przy first-join, jednocześnie blokując przenoszenie przedmiotów między wskazanymi światami.
• Tworzyć interaktywne przedmioty wykonujące komendy ekonomii/sklepu z cooldownami i kosztami.

⌨️ Komendy

Uwaga: te komendy i podkomendy pochodzą z udokumentowanego zestawu komend wtyczki. Wtyczka udostępnia dodatkowe podkomendy w wiki oraz w generowanym wyjściu pomocy.

🔐 Uprawnienia

Zachowanie uprawnień dla konkretnych przedmiotów jest konfigurowalne; sprawdzanie uprawnień przedmiotów jest domyślnie wyłączone i musi zostać włączone w konfiguracji wtyczki, aby zaczęło działać.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar ItemJoin i umieść go w folderze plugins/ na serwerze.
• Upewnij się, że w plugins/ nie ma zduplikowanych plików jar ItemJoin (np. ItemJoin(1).jar).
• Uruchom ponownie serwer, aby wtyczka mogła wygenerować konfigurację i zarejestrować funkcje dla wersji twojego serwera.
• Sprawdź logi konsoli serwera, aby potwierdzić załadowanie wtyczki, i zajrzyj do wiki wtyczki po szczegółową konfigurację.

📦 Zależności

Wtyczka nie ma twardych wymagań uruchomieniowych, ale wymienia kilka popularnych soft-dependency i integracji (opcjonalnych i aktywowanych, gdy są obecne):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Włącz lub skonfiguruj integracje według potrzeb; wtyczka działa bez nich, ale funkcje takie jak placeholdery, niestandardowe głowy/skiny i hooki ekonomii opierają się na odpowiednich wtyczkach.

🧠 Uwagi techniczne

• Platformy: potwierdzone dla serwerów w stylu Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Obsługiwany/testowany zakres Minecrafta: 1.8 do 1.21.
• Kod źródłowy i wydania są publikowane, a projekt udostępnia API pod me.RockinChaos.itemjoin.api.ItemJoinAPI dla innych wtyczek.
• Licencja: LGPL-3.0.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli potrzebujesz elastycznego, konfigurowalnego systemu do dostarczania graczom interaktywnych i zależnych od kontekstu przedmiotów (menu, zestawy startowe, narzędzia zależne od świata) oraz chcesz API do integracji, ItemJoin zapewnia te funkcje z obsługą popularnych wtyczek od placeholderów i skinów.