Plugin Minecraft nightcore

🔌 O NightCore

NightCore to lekka biblioteka do tworzenia pluginów na serwery Minecraft. Dostarcza wielokrotnego użytku narzędzia, moduły danych i mosty integracyjne, dzięki czemu inne pluginy nie muszą ponownie implementować typowych funkcji. Projekt jest منتشرzany na licencji GPL-3.0 i jest utrzymywany razem z zestawem pluginów, które od niego zależą.

🎯 Cel

NightCore istnieje po to, aby scentralizować typowe zadania deweloperskie (konfigurację, lokalizację, helpery do baz danych, parsowanie komend, mosty dla itemów i ekonomii itp.), tak by autorzy pluginów mogli skupić się na logice funkcji, a nie na infrastrukturze. Jest przydatny dla deweloperów i administratorów serwerów, którzy uruchamiają lub wdrażają wiele pluginów opartych na NightExpress/NightCore.

⚙️ Funkcje

• Most serwerowy zapewniający jednolite wsparcie dla Spigot, Paper i Folia.
• Most ekonomii do integracji z wieloma pluginami waluty/ekonomii.
• Most przedmiotów i wsparcie dla niestandardowego dostawcy przedmiotów dla zewnętrznych systemów itemów.
• Most uprawnień do integracji z różnymi pluginami permissions.
• Narzędzia do komend: parsowanie argumentów, własne typy argumentów i helpery do podpowiedzi tab.
• Narzędzia do konfiguracji YAML z odczytem/zapisem w stylu schematu i zachowaniem komentarzy.
• Narzędzia lokalizacyjne do uporządkowanych plików językowych i wiadomości parametryzowanych.
• Narzędzia bazodanowe z obsługą SQLite i MySQL oraz helperami do synchronizacji danych tabel.
• Utility do GUI ekwipunku i ekranów dialogowych.
• Helpery i wrappery dla gracza, encji, lokacji i ItemStack.
• Helpery PersistentDataContainer i narzędzia reflection do bardziej zaawansowanych zadań.
• Śledzenie bloków postawionych przez graczy, które zapisuje dane o stawianiu w natywnym storage chunków.

🧩 Dla kogo jest

• Dla twórców pluginów budujących lub utrzymujących pluginy Spigot/Paper/Folia, zwłaszcza z rodziny NightExpress.
• Dla administratorów serwerów, którzy wdrażają wiele pluginów i wolą wspólną warstwę narzędzi.

🏗️ Przykładowe zastosowania

• Plugin używa mostu ekonomii NightCore do współpracy z dowolnym pluginem ekonomii obecnym na serwerze.
• Deweloper korzysta ze schematów konfiguracji i lokalizacji NightCore, aby uniknąć pisania powtarzalnego kodu do obsługi plików.
• Serwer instaluje plugin NightExpress, który wymaga NightCore jako współdzielonej biblioteki.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu NightCore ze strony dystrybucji projektu.
• Umieść plik JAR w katalogu plugins/ swojego serwera, obok innych pluginów zgodnych z Bukkit.
• Uruchom serwer ponownie i sprawdź w konsoli, czy NightCore został poprawnie załadowany.

📦 Zależności

• Nie są udokumentowane żadne wymagane zewnętrzne zależności; NightCore udostępnia mosty integracyjne dla popularnych systemów (ekonomia, uprawnienia, niestandardowe itemy), gdy takie systemy są obecne.

🧠 Uwagi techniczne

• Potwierdzone obsługiwane platformy: Spigot, Paper, Purpur i Folia.
• Udokumentowane wpisy kompatybilności obejmują nowoczesne zakresy wydań Minecrafta (przykłady pokazane na oficjalnych stronach dystrybucji). Właściciele serwerów powinni używać buildu NightCore zgodnego z wersją Minecrafta swojego serwera.
• Licencja GPL-3.0.

🤝 Kiedy ten plugin jest przydatny

Jeśli utrzymujesz lub tworzysz pluginy, które potrzebują typowych narzędzi serwerowych (config, lokalizacja, helpery DB, parsowanie komend, integracja z ekonomią/itemami/uprawnieniami), NightCore zmniejsza ilość powielonej pracy, zapewniając utrzymywaną, współdzieloną warstwę biblioteczną.