Plugin Minecraft eco

🔌 O eco

eco to biblioteka deweloperska dla Spigota (samodzielny plugin do Minecrafta), zaprojektowana tak, aby uprościć tworzenie pluginów i dostarczać wielokrotnego użytku funkcje silnika dla innych pluginów. Udostępnia API do komend i konfiguracji, adaptery trwałego przechowywania danych, systemy GUI i niestandardowych przedmiotów oraz liczne integracje, dzięki czemu autorzy pluginów mogą ponownie wykorzystywać wspólną funkcjonalność zamiast pisać ją od nowa.

🎯 Cel

eco istnieje po to, aby scentralizować typowe systemy potrzebne nowoczesnym pluginom i skierowane do deweloperów: parsowanie komend, formaty kolorów i wiadomości, formaty konfiguracji, dostęp do trwałych danych, komponenty GUI, obsługę przedmiotów oraz integracje z innymi systemami po stronie serwera. Jest przeznaczone dla autorów pluginów, którzy chcą szybko budować funkcje na bazie utrzymywanego, współdzielonego frameworka.

⚙️ Funkcje

• Nowoczesne API komend i parsowania
• Natywne parsowanie kolorów z obsługą hex / RGB / MiniMessage
• System config obsługujący YAML, JSON i TOML
• API trwałego przechowywania danych z backendami YAML, MySQL i MongoDB
• API GUI i gotowe komponenty
• Niestandardowe przedmioty i ultraszybka obsługa ItemStack
• Wyświetlanie przedmiotów przez paczki i lekka pętla zdarzeń paczek
• API AI encji z mapowaniem NMS prawie 1:1
• API Placeholder i natywne integracje (projekt wymienia ponad 30 integracji)
• Abstrakcja ceny/ekonomii (system cen obsługujący pluginy ekonomii, XP i przedmioty)
• Natywne wsparcie bStats i sprawdzanie aktualizacji pluginu
• System rozszerzeń (pluginy dla pluginów) i narzędzia dependency injection dla deweloperów

🧩 Dla kogo jest

• Dla deweloperów pluginów tworzących pluginy zgodne ze Spigot/Paper, którzy chcą wielokrotnego użytku frameworka
• Dla właścicieli serwerów uruchamiających pluginy zależne od eco (eco musi być zainstalowane jako zależność)
• Dla projektów wymagających niestandardowych przedmiotów, GUI lub ujednoliconych narzędzi do persystencji i komend

🏗️ Przykłady użycia

• Deweloper tworzy własny pakiet przedmiotów, który korzysta z wyszukiwania przedmiotów i API GUI eco.
• Plugin używa API storage eco, aby obsługiwać zarówno lokalny YAML, jak i zdalny backend MongoDB bez duplikowania kodu.
• Kilka mniejszych pluginów współdzieli eco, aby zapewnić spójne przetwarzanie komend i parsowanie kolorów.

⚙️ Instalacja

📥 Konfiguracja

• Zainstaluj eco jako plugin na dowolnym serwerze, który tego wymaga, umieszczając plik JAR w folderze plugins/ serwera i restartując serwer.
• Jeśli inny plugin zależy od eco, zadeklaruj to w jego plugin.yml w sekcji depend: z wpisem - eco, aby serwer załadował eco jako pierwszy.

📦 Zależność (dla deweloperów pluginów)

• Projekt publikuje repozytorium Maven i współrzędne Gradle do użycia jako compile-only. Udostępnia też opublikowany artefakt (na przykład z grupą com.willfp i tagami wersji), aby deweloperzy mogli dodać eco jako zależność provided podczas builda.

🧠 Uwagi techniczne

• Obsługiwane oprogramowanie serwera: oficjalny projekt wskazuje wsparcie dla Spigot, Paper, Purpur i Folia.
• Obsługiwane wersje Minecrafta: projekt deklaruje wsparcie od 1.21.4, a późniejsze buildy są kierowane na nowoczesną serię 1.21.x.
• Backendów przechowywania: framework dostarcza adaptery YAML, MySQL i MongoDB.
• Licencja: eco jest wydawane na licencji MIT.

🤝 Kiedy ten plugin jest przydatny

Jeśli tworzysz wiele funkcji lub pluginów, które mają wspólne potrzeby (komendy, formaty configu, komponenty GUI, storage, niestandardowe przedmioty), eco zmniejsza ilość powielonej pracy, zapewniając utrzymywany framework i integracje, od których mogą zależeć inne pluginy.