Plugin Minecraft EconomyShopGUI

🔌 O EconomyShopGUI

EconomyShopGUI to plugin do Minecrafta, który zapewnia konfigurowalny graficzny system sklepu, dzięki czemu gracze mogą kupować i sprzedawać przedmioty za pomocą menu zamiast komend na czacie. Plugin oferuje sekcje sklepu, stronicowane strony sklepu, interfejs sprzedaży oraz opcjonalne fizyczne przedmioty "ShopStand". Jest przeznaczony dla środowisk serwerowych Bukkit/Spigot/Paper i integruje się z popularnymi pluginami ekonomii.

🎯 Cel

Plugin zastępuje lub uzupełnia tekstowe komendy sklepu o sklepy oparte na GUI i administracyjną konfigurację sklepu. Jest przeznaczony dla właścicieli i administratorów serwerów, którzy chcą uporządkowanych, konfigurowalnych sklepów w grze podłączonych do istniejącego pluginu ekonomii.

⚙️ Funkcje

• Konfigurowalne sekcje sklepu i stronicowane strony GUI.
• Procesy kupna i sprzedaży przedmiotów z ekranem transakcji i konfigurowalnymi limitami.
• Globalna i per-sekcja funkcja sell-all.
• Obsługa fizycznych przedmiotów ShopStand (stawialne sklepy ekspozycyjne).
• Marketplace układów / instalowalne układy i instalacja układów w grze.
• API dla deweloperów do podłączania się do pluginu z innych pluginów.
• Integracja z wieloma systemami ekonomii oraz opcjonalne integracje z pluginami od spawnerów i narzędzi.
• Używa bStats do anonimowych metryk pluginu.

🧩 Dla kogo jest przeznaczony

• Serwery Survival i SMP, które chcą sklepów GUI w grze.
• Serwery, które już korzystają z osobnego pluginu ekonomii i potrzebują front-endowego interfejsu sklepu.
• Serwery, które chcą konfigurowalne układy sklepu i opcjonalne fizyczne stoiska sklepu.
• Deweloperzy pluginów, którzy potrzebują API sklepu do integracji zachowania sklepu.

🏗️ Przykładowe zastosowania

• Operatorzy tworzą sekcje sklepu dla surowców, narzędzi i kosmetyków, a gracze kupują przez GUI.
• Serwer oferuje komendę /sellall, aby gracze mogli sprzedawać przedmioty do skonfigurowanych sekcji sklepu.
• Administratorzy instalują lub przesyłają układ, aby zmienić wygląd sklepu bez edycji surowych plików.

⌨️ Komendy

(Powyższe komendy są uwzględnione tylko wtedy, gdy zostały udokumentowane przez autora pluginu.)

🔐 Uprawnienia

(Domyślne wartości są zapisywane jako "nie określono", gdy plugin nie podaje wartości domyślnej w udokumentowanej liście uprawnień.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu i umieść go w folderze plugins/ swojego serwera.
• Uruchom ponownie serwer (lub użyj menedżera pluginów, aby załadować plugin).
• Sprawdź konsolę serwera podczas startu, aby potwierdzić, że plugin został załadowany, oraz zobaczyć ewentualne ostrzeżenia o zależnościach.

📦 Zależności

• Wymaga dostawcy ekonomii. Plugin dokumentuje obsługę jednego z: Vault, PlayerPoints, CoinsEngine, GemsEconomy, UltraEconomy, VotingPlugin, zEssentials (jedna z tych opcji musi być obecna, aby działały operacje ekonomii).
• Opcjonalne integracje obejmują PlaceholderAPI, Citizens, Quests oraz różne pluginy od spawnerów zapewniające bezpośrednie wsparcie.

🧠 Uwagi techniczne

• Plugin jest wydawany dla serwerów Bukkit/Spigot/Paper, a autor zaznacza, że nie wspiera serwerów modowanych/hybrydowych.
• Wymagania podane przez autora: Minecraft 1.8+ i Java 8 lub nowsza.
• Plugin udostępnia API dla deweloperów, aby inne pluginy mogły podpinać się pod wydarzenia i funkcje sklepu.
• Plugin używa bStats do anonimowego zbierania metryk.
• Istnieje wersja premium, która dodaje funkcje takie jak edytor GUI, przedmioty komend i niestandardowe przedmioty NBT; podstawowa funkcjonalność (sklepy GUI) jest dostępna w darmowym wydaniu.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz graficznego sklepu w grze, który integruje się z istniejącym pluginem ekonomii i obsługuje konfigurowalne układy, sekcje sklepu oraz przepływy sprzedaży, EconomyShopGUI zapewnia udokumentowany interfejs dla administratorów i API do integracji pluginów.