Serwery Minecraft z pluginem DeluxeMenus

## 🔌 O DeluxeMenus DeluxeMenus to plugin do Minecrafta służący do tworzenia konfigurowalnych menu GUI opartych na ekwipunku. Administratorzy serwera definiują menu i elementy menu w YAML; przedmioty mogą wyświetlać dynamiczne dane przez PlaceholderAPI i uruchamiać komendy lub akcje po kliknięciu. Plugin generuje folder `gui_menus` dla zewnętrznych plików menu i używa centralnego `config.yml` do ustawień głównych. ## 🎯 Cel DeluxeMenus rozwiązuje problem tworzenia graficznych menu w grze bez programowania. Pozwala właścicielom serwerów tworzyć sklepy, selektory serwerów, menu zestawów, panele informacyjne i inne interaktywne interfejsy, które uruchamiają komendy lub pokazują dane konkretnego gracza. ## ⚙️ Funkcje - Tworzenie menu GUI ekwipunku przez YAML (obsługa zewnętrznych plików menu). - Elementy menu mogą uruchamiać komendy lub wykonywać akcje po kliknięciu. - Integracja z PlaceholderAPI dla dynamicznych nazw przedmiotów, lore i warunków. - Uprawnienia per menu i per kliknięcie (dostęp do menu i ograniczenia kliknięć). - Komendy do otwierania, listowania, przeładowywania i wykonywania akcji dla menu. - W pierwszym uruchomieniu generuje `plugins/DeluxeMenus/gui_menus` oraz przykładowe pliki menu. - Używa bStats do anonimowych statystyk (włączone domyślnie, chyba że zostanie wyłączone). ## 🧩 Dla kogo - Dla właścicieli i administratorów serwerów, którzy chcą niestandardowych GUI w grze (sklepy, selektory, zestawy). - Dla serwerów SMP i survival używających sklepów opartych na GUI lub menu informacyjnych. - Dla sieci serwerów, które potrzebują konfigurowalnych menu z wartościami PlaceholderAPI. ## 🏗️ Przykładowe zastosowania - Menu selektora serwera, które teleportuje graczy lub uruchamia komendy połączenia z serwerem. - Menu sklepu, które wykonuje komendy zakupu po kliknięciu przedmiotu przez gracza. - GUI wyboru zestawu pokazujące informacje specyficzne dla gracza za pomocą placeholderów. ## ⌨️ Komendy | **Komenda** | **Opis** | **Uprawnienie** | **Dostęp** | |---|---|---|---| | `/dm open <menuName>` | Otwiera nazwane menu dla siebie. | `deluxemenus.open` | Gracz | | `/dm open <menuName> <player>` | Otwiera nazwane menu dla innego gracza. | `deluxemenus.open.others` | Administrator | | `/dm list` | Wyświetla listę wszystkich menu, do których masz dostęp. | `deluxemenus.list` | Gracz | | `/dm reload` | Przeładowuje konfigurację i menu DeluxeMenus. | `deluxemenus.reload` | Administrator | | `/dm execute <player> <action>` | Wykonuje skonfigurowaną akcję na docelowym graczu (ograniczone). | op / console | Administrator | ## 🔐 Uprawnienia | **Uprawnienie** | **Opis** | **Domyślne** | |---|---|---| | `deluxemenus.open` | Umożliwia otwieranie menu przez `/dm open`. | nie określono | | `deluxemenus.open.others` | Umożliwia otwieranie menu dla innych graczy. | nie określono | | `deluxemenus.list` | Umożliwia wyświetlanie dostępnych menu. | nie określono | | `deluxemenus.reload` | Umożliwia przeładowanie konfiguracji pluginu. | nie określono | | `deluxemenus.clickmenu.<menuName>` | Węzeł uprawnienia używany do ograniczania dostępu do menu klikalnego dla danego menu. | nie określono | ## ⚙️ Instalacja ### 📥 Konfiguracja - Pobierz oficjalny plik `.jar` DeluxeMenus dla Spigot i umieść go w katalogu `plugins/` swojego serwera. - Upewnij się, że PlaceholderAPI jest zainstalowane przed uruchomieniem DeluxeMenus (PlaceholderAPI jest wymagane, aby placeholdery działały). - Uruchom lub zrestartuj serwer; DeluxeMenus utworzy folder `plugins/DeluxeMenus` z plikiem `config.yml` oraz folder `gui_menus`. - Sprawdź konsolę serwera, aby potwierdzić poprawne załadowanie pluginu, i zwróć uwagę na ostrzeżenia dotyczące wersji Java. ### 📦 Zależności - PlaceholderAPI (wymagane do obsługi placeholderów). ### 🧾 Konfiguracja - DeluxeMenus używa głównego `config.yml` i obsługuje zewnętrzne pliki menu YAML zapisane w `plugins/DeluxeMenus/gui_menus`. - Podczas tworzenia nowego menu przez plugin zostanie wygenerowany domyślny zewnętrzny plik menu, który można edytować, aby dostosować sloty, przedmioty, placeholdery i akcje. ## 🧠 Uwagi techniczne - PlaceholderAPI jest wymagane do dynamicznych placeholderów w nazwach przedmiotów, lore i warunkach. - Do nowoczesnych wydań pluginu wymagany jest Java 11 lub nowszy. - DeluxeMenus zbiera anonimowe statystyki przez bStats (można wyłączyć, jeśli chcesz). - Plugin jest open source, ma publiczne repozytorium i dostarcza przykładowe menu oraz wiki z instrukcjami konfiguracji. - Obsługiwane wersje Minecrafta są podane przez projekt; przed wdrożeniem sprawdź zgodność z wersją swojego serwera. ## 🤝 Kiedy ten plugin jest przydatny Jeśli potrzebujesz konfigurowalnych, opartych na YAML GUI ekwipunku, które mogą pokazywać dane konkretnego gracza i uruchamiać komendy po kliknięciu, DeluxeMenus jest praktycznym wyborem do tworzenia sklepów, selektorów i interfejsów w grze bez własnego kodu.

Pluginy