Plugin Minecraft EconomyAPI

🔌 O EconomyAPI

EconomyAPI to podstawowy plugin ekonomii oraz implementacja API, pierwotnie stworzona przez onebone. Jest publikowany i dystrybuowany dla ekosystemów serwerowych w stylu Bedrock/PocketMine (warianty PocketMine/Nukkit) i ma zapewniać współdzielony backend waluty oraz programowe metody, z których mogą korzystać inne pluginy.

🎯 Cel

EconomyAPI zapewnia scentralizowany system waluty, dzięki czemu autorzy pluginów mogą odczytywać i modyfikować salda graczy, rejestrować zdarzenia związane z ekonomią oraz umożliwiać administratorom serwera udostępnianie graczom podstawowych komend ekonomicznych. Rozwiązuje problem wielu pluginów wymagających osobnych implementacji ekonomii, oferując wspólną warstwę API.

⚙️ Funkcje

• Udostępnia programowe metody API do sprawdzania i aktualizacji sald (przykłady w dokumentacji obejmują dostęp w stylu getInstance).
• Zapewnia komendy ekonomii dla graczy, takie jak saldo, płatność i administracyjne zmiany pieniędzy.
• Emituje zdarzenia i hooki, których mogą słuchać inne pluginy w celu obsługi transakcji.
• Szeroko używany jako zależność/podstawowy komponent dla innych dodatków i rozszerzeń ekonomicznych PocketMine/Nukkit.

🧩 Dla kogo

• Dla twórców serwerów i pluginów, którzy potrzebują współdzielonego backendu ekonomii w oprogramowaniu serwerowym Bedrock w stylu PocketMine/Nukkit.
• Dla administratorów małych i średnich serwerów Bedrock, które korzystają z ekosystemów pluginów integrujących się z EconomyAPI.

🏗️ Przykładowe zastosowania

• Plugin sklepu lub marketplace odczytuje i odlicza salda graczy przez wywołania EconomyAPI.
• Plugin aukcyjny lub nagród przyznaje walutę, wywołując metody add/reduce API.
• Sieci serwerów, które dostarczają pluginy addon oczekujące wspólnego dostawcy ekonomii.

⌨️ Komendy

(Powyższe komendy i węzły uprawnień pochodzą z opublikowanych list zasobów PocketMine/Nukkit; dokładna dostępność może się różnić w zależności od builda/forka.)

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalną wersję pluginu dla swojej dystrybucji serwera (PocketMine/Poggit lub build społeczności Nukkit).
• Umieść pobrany plik pluginu w katalogu plugins/ serwera.
• Zatrzymaj i uruchom serwer ponownie oraz sprawdź konsolę, aby potwierdzić, że plugin został załadowany.

(Dokładny format paczki może się różnić w zależności od dystrybucji i builda; postępuj zgodnie z instrukcją instalacji wybranej dystrybucji.)

🧠 Uwagi techniczne

• EconomyAPI jest dystrybuowany w wielu buildach/forkach dla ekosystemów PocketMine i Nukkit; różne buildy mogą zawierać nieco inne komendy lub punkty wejścia API.
• Plugin udostępnia wzorce dostępu programowego używane przez inne dodatki (przykłady w dokumentacji społeczności pokazują wywołania takie jak EconomyAPI::getInstance() lub EconomyAPI.getInstance().addMoney(...)).
• Zdarzało się, że plugin był oznaczany w kanałach dystrybucji z powodu wydajności lub kwestii utrzymania; przy wdrażaniu na serwerach produkcyjnych warto wziąć pod uwagę aktualny status utrzymania i kompatybilne alternatywy.

🤝 Kiedy ten plugin jest przydatny

Jeśli twój serwer lub ekosystem dodatków oczekuje wspólnego dostawcy ekonomii dla serwerów w stylu Bedrock/PocketMine/Nukkit, EconomyAPI oferuje szeroko przyjęte API oraz zestaw podstawowych komend dla graczy, z którymi integruje się wiele innych pluginów.