Minecraft plugin CommandPanels

🔌 O CommandPanels

CommandPanels je plugin pro Minecraft, který poskytuje systém GUI/menu založený na YAML pro servery. Zaměřuje se na panely založené na inventáři, dialogové (form) panely a panely kompatibilní s Floodgate pro hráče Bedrock. Projekt obsahuje online editor a strukturovaný formát pro vytváření interaktivních menu řízených daty, která spouštějí příkazy, zobrazují dynamické placeholders a reagují na logiku i oprávnění.

🎯 Účel

Plugin je určen pro správce serverů a vývojáře, kteří potřebují flexibilní, programovatelná GUI pro obchody, kity, lobby, moderační nástroje nebo vlastní workflow. Je navržen tak, aby panely mohly spouštět příkazy, kontrolovat podmínky, animovat předměty a zpřístupňovat session nebo persistentní data pro použití v jiných systémech.

⚙️ Funkce

• Inventářové panely s interakcemi s předměty, rozložením slotů a animačními řetězci.
• Dialogové panely pro strukturované formuláře a vstupy od hráčů.
• Podpora panelů Floodgate pro zobrazení kompatibilních panelů hráčům Bedrock (prostřednictvím nastavení Geyser/Floodgate).
• Inline logika a podmínky (operátory ve stylu AND/OR/NOT) pro řízení viditelnosti a chování.
• Systém příkazů/akcí: hooky otevření/zavření, akce kliknutí, akce kliknutí mimo panel a podmíněné spouštění příkazů.
• Podpora PlaceholderAPI a dynamické aktualizace placeholderů uvnitř panelů.
• Session a persistentní data panelů dostupná napříč panely a příkazy.
• Pravidelné aktualizace a observer oprávnění, který může při změně oprávnění vyvolat úplné znovuparsování logiky.
• Online editor s živým náhledem YAML a kontrolou struktury.

🧩 Pro koho to je

Pro administrátory a vývojáře pluginů provozující moderní servery kompatibilní s Paper, kteří potřebují flexibilní GUI menu: Survival/SMP servery, sítě minihier, PvP huby a servery vyžadující vlastní administrační/moderační rozhraní.

🏗️ Příklady použití

• Vytvořte GUI pro kit nebo obchod, které spouští serverové příkazy a vyžaduje konkrétní oprávnění nebo ekonomický zůstatek.
• Sestavte navigační menu hubu s animovanými předměty a podmíněnou viditelností podle hodnosti hráče.
• Poskytněte menu kompatibilní s Bedrock pomocí variant panelů specifických pro Floodgate.

⌨️ Commands

(Příkazy a jejich oprávnění jsou převzaty z oficiální dokumentace CommandPanels.)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | Umožňuje přístup k základnímu příkazu /pa. | true | | commandpanels.command.reload | Umožňuje znovunačtení pluginu. | op | | commandpanels.command.generate | Přístup k příkazu generátoru panelů. | op | | commandpanels.command.version | Umožňuje kontrolu verze pluginu. | true | | commandpanels.command.data | Umožňuje konfiguraci dat panelu. | op | | commandpanels.command.open | Umožňuje otevírání panelů pomocí /pa open. | op | | commandpanels.command.open.other | Umožňuje otevírání panelů pro jiné hráče. | op | | commandpanels.command.help | Umožňuje přístup k /pa help. | true |

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální soubor CommandPanels .jar a vložte jej do složky plugins/ na vašem serveru.
• Spusťte server, aby se vygenerovala data pluginu.
• Po prvním spuštění zkontrolujte plugins/CommandPanels a vyhledejte config.yml a složku panels/, která obsahuje soubory definic panelů.

📦 Dependencies

• PlaceholderAPI — volitelné, ale doporučené pro dynamické placeholders.
• Floodgate — volitelné pro podporu panelů Bedrock (Floodgate).

🧾 Konfigurace

• Panely jsou definovány jako YAML soubory umístěné v adresáři panels/. Pro lepší organizaci jsou podporovány i podsložky.
• Plugin vygeneruje ukázkové panely, pokud je adresář panels/ smazán a plugin je poté restartován.

🧠 Technické poznámky

• Oficiální dokumentace a vydání uvádějí Paper a Folia (forky Paper) jako podporované serverové platformy pro moderní verze v4.
• Řada vydání v4 se zaměřuje na novější verze serverů Minecraft; definice panelů podporují dynamické placeholders a podmíněnou logiku zpracovávanou za běhu.
• Plugin vystavuje uzly oprávnění a API založené na příkazech pro otevírání panelů; lze jej také vložit jako knihovnu do jiných pluginů načtením YAML panelů a voláním open akcí.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete strukturovaný, skriptovatelný systém GUI, který podporuje dynamická data, podmíněnou logiku, kompatibilitu s Bedrock a online editor, CommandPanels nabízí ověřený přístup založený na YAML, který dobře sedí na servery a sítě postavené na Paper.