Plugin Minecraft CommandPanels

🔌 O CommandPanels

CommandPanels to plugin do Minecrafta, który udostępnia oparty na YAML system GUI/menu dla serwerów. Skupia się na panelach opartych na ekwipunku, panelach dialogowych (formularzach) oraz panelach zgodnych z Floodgate dla graczy Bedrock. Projekt zawiera edytor online i uporządkowany format do tworzenia interaktywnych, opartych na danych menu, które uruchamiają komendy, pokazują dynamiczne placeholdery i reagują na logikę oraz uprawnienia.

🎯 Cel

Plugin jest przeznaczony dla administratorów serwerów i deweloperów, którzy potrzebują elastycznych, programowalnych GUI do sklepów, zestawów, lobby, narzędzi moderacyjnych lub niestandardowych przepływów pracy. Został zaprojektowany tak, aby panele mogły wykonywać komendy, sprawdzać warunki, animować przedmioty oraz udostępniać dane sesji lub trwałe do użycia w innych systemach.

⚙️ Funkcje

• Panele ekwipunku z interakcjami z przedmiotami, układem slotów i łańcuchami animacji.
• Panele dialogowe do ustrukturyzowanych formularzy i wejścia od graczy.
• Obsługa paneli Floodgate, aby wyświetlać zgodne panele graczom Bedrock (w konfiguracjach Geyser/Floodgate).
• Logika inline i warunki (operatory w stylu AND/OR/NOT) do kontrolowania widoczności i zachowania.
• System komend/akcji: hooki otwarcia/zamknięcia, akcje kliknięcia, akcje kliknięcia poza panelem i warunkowe wykonywanie komend.
• Obsługa PlaceholderAPI i dynamiczne aktualizacje placeholderów wewnątrz paneli.
• Dane sesji i trwałe dane paneli dostępne między panelami i komendami.
• Okresowe aktualizacje oraz obserwator uprawnień, który może wywołać pełne ponowne parsowanie logiki po zmianie uprawnień.
• Edytor online z podglądem YAML na żywo i sprawdzaniem struktury.

🧩 Dla kogo

Dla administratorów i twórców pluginów prowadzących nowoczesne serwery zgodne z Paper, którzy potrzebują elastycznych menu GUI: serwery survival/SMP, sieci minigier, huby PvP oraz serwery wymagające niestandardowych interfejsów administracyjnych/moderacyjnych.

🏗️ Przykłady użycia

• Stworzenie GUI zestawu lub sklepu, które uruchamia komendy serwera i wymaga określonych uprawnień albo salda ekonomii.
• Zbudowanie menu nawigacyjnego hubu z animowanymi przedmiotami i warunkową widocznością zależną od rangi gracza.
• Udostępnienie menu zgodnego z Bedrock przy użyciu wariantów paneli specyficznych dla Floodgate.

⌨️ Komendy

(Komendy i ich uprawnienia pochodzą z oficjalnej dokumentacji CommandPanels.)

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik .jar CommandPanels i umieść go w folderze plugins/ swojego serwera.
• Uruchom serwer, aby wygenerować dane pluginu.
• Po pierwszym uruchomieniu sprawdź plugins/CommandPanels w poszukiwaniu config.yml oraz folderu panels/ zawierającego pliki definicji paneli.

📦 Zależności

• PlaceholderAPI — opcjonalne, ale zalecane dla dynamicznych placeholderów.
• Floodgate — opcjonalne dla obsługi paneli Bedrock (Floodgate).

🧾 Konfiguracja

• Panele są definiowane jako pliki YAML umieszczone w katalogu panels/. Dla porządku obsługiwane są podfoldery.
• Plugin generuje przykładowe panele, jeśli katalog panels/ zostanie usunięty i plugin zostanie uruchomiony ponownie.

🧠 Uwagi techniczne

• Oficjalna dokumentacja i wydania wskazują Paper i Folia (forki Paper) jako obsługiwane platformy serwerowe dla nowoczesnych wydań v4.
• Linia wydań v4 koncentruje się na nowszych wersjach serwerów Minecraft; definicje paneli obsługują dynamiczne placeholdery i logikę warunkową analizowaną w czasie działania.
• Plugin udostępnia węzły uprawnień i API oparte na komendach do otwierania paneli; może też być osadzony jako biblioteka w innych pluginach przez wczytanie YAML paneli i wywoływanie akcji otwarcia.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz uporządkowanego, skryptowalnego systemu GUI, który obsługuje dynamiczne dane, logikę warunkową, zgodność z Bedrock i edytor online, CommandPanels oferuje sprawdzone podejście oparte najpierw na YAML, które pasuje do serwerów i sieci opartych na Paper.