Serwery Minecraft z pluginem 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 | **Komenda** | **Opis** | **Uprawnienie** | **Dostęp** | |---|---|---|---| | `/eshop additem <section> <material> <buy price> <sell price>` | Dodaje przedmiot do sekcji sklepu. | `EconomyShopGUI.eshop.additem` | Admin | | `/eshop edititem <section> <index> <action> <key> <value>` | Edytuje właściwości przedmiotu w sekcji. | `EconomyShopGUI.eshop.edititem` | Admin | | `/eshop deleteitem <section> <index>` | Usuwa przedmiot z sekcji sklepu. | `EconomyShopGUI.eshop.deleteitem` | Admin | | `/eshop addhanditem <section> <buy price> <sell price>` | Dodaje przedmiot trzymany w ręce do sekcji sklepu. | `EconomyShopGUI.eshop.addhanditem` | Admin | | `/eshop installLayout <id>` | Instaluje układ sklepu po id (integracja z marketplace układów). | `EconomyShopGUI.eshop.installLayout` | Admin | | `/eshop logs export` | Eksportuje logi transakcji jako widok webowy (funkcja logowania transakcji). | `nie określono` | Admin | | `/sellall` | Sprzedaje wszystkie przedmioty możliwe do sprzedaży zgodnie z skonfigurowanymi sekcjami sklepu. | `EconomyShopGUI.sellall` | Gracz | | `/sellgui` | Otwiera Sell GUI, aby sprzedawać przedmioty przez menu. | `EconomyShopGUI.sellgui` | Gracz | (Powyższe komendy są uwzględnione tylko wtedy, gdy zostały udokumentowane przez autora pluginu.) ## 🔐 Uprawnienia | **Uprawnienie** | **Opis** | **Domyślnie** | |---|---|---| | `EconomyShopGUI.shop` | Pozwala graczom otworzyć sklep. | nie określono | | `EconomyShopGUI.shop.<section>` | Dostęp do otwarcia konkretnej sekcji sklepu po nazwie. | nie określono | | `EconomyShopGUI.shop.all` | Pozwala otwierać wszystkie sekcje sklepu. | nie określono | | `EconomyShopGUI.sellall` | Pozwala używać komendy `/sellall`. | nie określono | | `EconomyShopGUI.sellall.<section>` | Pozwala sprzedawać do konkretnej sekcji sklepu za pomocą `/sellall`. | nie określono | | `EconomyShopGUI.sellall.all` | Pozwala sprzedawać do wszystkich sekcji za pomocą `/sellall`. | nie określono | | `EconomyShopGUI.sellallitem` | Pozwala używać `/sellall <item>`. | nie określono | | `EconomyShopGUI.sellgui` | Pozwala otwierać Sell GUI. | nie określono | | `EconomyShopGUI.reload` | Pozwala przeładować plugin. | nie określono | | `EconomyShopGUI.eshop.additem` | Pozwala dodawać przedmioty sklepu przez komendę. | nie określono | | `EconomyShopGUI.eshop.edititem` | Pozwala edytować przedmioty sklepu przez komendę. | nie określono | | `EconomyShopGUI.eshop.deleteitem` | Pozwala usuwać przedmioty sklepu przez komendę. | nie określono | | `EconomyShopGUI.eshop.addhanditem` | Pozwala dodawać do sklepu przedmiot trzymany w ręce przez komendę. | nie określono | | `EconomyShopGUI.eshop.addsection` | Pozwala dodawać sekcje sklepu przez komendę. | nie określono | | `EconomyShopGUI.eshop.uploadLayout` | Pozwala przesyłać układ. | nie określono | | `EconomyShopGUI.eshop.installLayout` | Pozwala instalować układ. | nie określono | | `EconomyShopGUI.eshop.shopstands.create` | Pozwala tworzyć/ustawiać przedmioty ShopStand. | nie określono | | `EconomyShopGUI.eshop.shopstands.destroy` | Pozwala niszczyć ShopStandy. | nie określono | (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.

Pluginy