Plugin Minecraft BlueSlimeCore

🔌 O BlueSlimeCore

BlueSlimeCore to plugin Minecraft w stylu biblioteki, przeznaczony jako wspólna baza dla innych pluginów. Łączy komendy narzędziowe dla serwera oraz API dla deweloperów, które upraszcza typowe zadania (konfiguracja, języki/wiadomości, menu, buildery przedmiotów, obsługa wersji), dzięki czemu autorzy mogą ponownie wykorzystywać funkcjonalność w wielu pluginach.

🎯 Cel

Plugin rozwiązuje problem duplikowania typowej infrastruktury pluginów: centralizuje zarządzanie konfiguracją, obsługę języków, tworzenie menu, pomocniki zgodności między wersjami oraz niewielki zestaw komend administracyjnych, aby zależne pluginy mogły skupić się na funkcjach zamiast na powtarzalnym kodzie.

⚙️ Funkcje

• API dla deweloperów do zarządzania konfiguracją i językami (wsparcie języka per gracz, MiniMessage, PlaceholderAPI).
• API menu do tworzenia inventory, przycisków i menu stronicowanych.
• Narzędzia buildera przedmiotów dla itemów, skórzanej zbroi, mikstur i głów graczy.
• Pomocniki multiversion/NMS do spawnowania encji, health/absorption, pakietów cooldown i sprawdzania TPS.
• API handlera Factions pomagające w zgodności z wieloma implementacjami Factions.
• Sprawdzanie aktualizacji pluginu dla SpigotMC lub Hangar.
• Małe komendy narzędziowe serwera do sprawdzania przedmiotów i debugowania listenerów zdarzeń.

🧩 Dla kogo

• Dla twórców pluginów, którzy chcą wielokrotnego użytku bazy dla typowych funkcji serwera.
• Dla administratorów serwerów uruchamiających wiele pluginów SirBlobman lub inne pluginy zależne od narzędzi BlueSlimeCore.

🏗️ Przykładowe zastosowania

• Deweloper używa API menu, aby zbudować interfejs sklepu bez pisania obsługi inventory od zera.
• Administrator używa item-to-nbt, aby sprawdzić dane NBT przedmiotu podczas debugowania.
• Plugin integruje handler factions, aby obsłużyć wiele implementacji Factions przy użyciu jednej warstwy integracji.

⌨️ Komendy

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar BlueSlimeCore i umieść go w katalogu plugins/ na swoim serwerze.
• Upewnij się, że serwer uruchamia wspierany build Spigot/Paper/Folia, a następnie uruchom lub zrestartuj serwer.
• Sprawdź, czy plugin został załadowany, przeglądając konsolę serwera w poszukiwaniu komunikatów startowych BlueSlimeCore.

📦 Zależności

• Wymaga Java 25 (wymóg JVM serwera potwierdzony przez repozytorium projektu).

🧠 Uwagi techniczne

• Potwierdzone wspierane oprogramowanie serwera: Spigot, Paper, Folia.
• Projekt udostępnia API przeznaczone dla innych twórców pluginów; zainstaluj plik jar BlueSlimeCore na każdym serwerze uruchamiającym pluginy, które od niego zależą.
• Repozytorium jest objęte licencją GPL-3.0.

🤝 Kiedy ten plugin jest przydatny

Jeśli zarządzasz wieloma pluginami lub tworzysz funkcje oparte na wspólnych narzędziach serwera (menu, wiadomości, wsparcie multiversion), BlueSlimeCore zmniejsza ilość duplikowanego kodu i zapewnia spójne API dla administratorów serwera i opiekunów pluginów.