Plugin Minecraft 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

🔐 Uprawnienia

⚙️ 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.