Minecraft plugin MyCommand

🔌 O MyCommand

MyCommand je plugin Minecraft pro vytváření vlastních příkazů, aliasů a interaktivních rozhraní řízených příkazy bez nutnosti psát Java. Poskytuje systém založený na YAML pro definici příkazů, které spouštějí jiné příkazy, odesílají formátovaný text, otevírají GUI, spouštějí skripty a pracují s událostmi.

🎯 Účel

MyCommand je určen pro správce serverů, kteří potřebují flexibilní vlastní příkazy, zkratky a admin/použivatelská rozhraní. Řeší problém přidání vlastního chování příkazů (zpoždění, warmupy, cooldowny, tab-completion, placeholdery) a lehkých GUI interakcí bez vývoje plnohodnotného pluginu.

⚙️ Funkce

• Vytváření nových příkazů a aliasů, volitelně registrovaných pro tab completion.
• Spouštění více příkazů z jednoho vlastního příkazu (provedení z console nebo hráčem).
• Zpoždění, warmupy a cooldowny pro příkazy.
• Přepsání jiných příkazů nebo poskytnutí zkratek/aliasů.
• Spouštěče příkazů z itemů, bloků, cedulek, knih, NPC a item frames.
• GUI prvky: IconMenu založené na chest, ActionBar, BossBar, Title, Scoreboard, Anvil GUI a Sign GUI.
• Podpora placeholderů a podmínek ve stylu skriptů pro dynamické chování.
• Integrace ekonomiky (volitelně přes Vault) a některé samostatné ekonomické funkce.
• Podpora událostí hráčů (join/quit/death) a plánovaných úloh.
• Volitelná SQL databáze vlastních hráčů a podpora více souborů pro neomezené příkazy.
• Funkce související s BungeeCord a samostatná varianta pro Bungee pro příkazy na straně proxy.
• HTTP požadavky (GET/POST) a podpora formátování MiniMessage, kde je dostupné.
• Používá bStats pro reportování metrik.

🧩 Pro koho je určen

• Survival a SMP servery, které chtějí vlastní příkazy a menu bez programování.
• Servery silně zaměřené na administraci nebo ekonomiku, které potřebují vlastní shop/command flow.
• Proxy sítě vyžadující centralizované nebo proxy-side chování příkazů.
• Provozovatelé serverů, kteří potřebují skriptové podmínky a placeholdery pro dynamické výstupy.

🏗️ Příklady použití

• Definovat jeden příkaz, který spustí sekvenci console příkazů pro otevření shopu, předání itemů a zalogování nákupu.
• Vytvářet GUI menu pro trestání/teleportaci pomocí položek chest GUI a výzev anvil/sign.
• Poskytnout krátké aliasy mapované na delší příkazy pro přepínání serverů BungeeCord s tab completion.

⌨️ Commands

Oficiální dokumentace uvádí administrativní příkazy pro správu pluginu. Mezi příklady dokumentované projektem patří:

(Pro úplný seznam a přesnou syntaxe se podívejte do oficiální dokumentace příkazů pluginu.)

🔐 Permissions

Projekt dokumentuje permission nodes pro administrativní akce. Příklady z oficiálního seznamu oprávnění zahrnují:

(Pro úplnou mapu oprávnění se podívejte do dokumentace permissions pluginu.)

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální plugin .jar a vložte jej do složky plugins/ vašeho serveru.
• Spusťte nebo restartujte server a zkontrolujte logy console, abyste potvrdili, že se plugin načetl.
• Pokud se plugin nenačte, ověřte, zda jsou přítomné nebo aktualizované požadované/volitelné podpůrné pluginy (viz Dependencies).

📦 Dependencies

• ProtocolLib — uveden jako důležitý, pokud se plugin nenačte nebo pro některé funkce.
• Vault — volitelné, vyžadováno pro integrace ekonomiky.
• PlaceholderAPI — volitelné, pro rozšířenou podporu placeholderů.

Instalujte pouze ty závislosti, které jsou potvrzené pro vámi požadované funkce; mnoho integrací je volitelných.

🧠 Technické poznámky

• Plugin se konfiguruje přes YAML soubory a podporuje více souborů příkazů, aby se předešlo limitům příkazů.
• Pro vlastní databázi hráčů je k dispozici SQL úložiště (volitelně) a jsou podporována nastavení s více soubory.
• Existuje samostatný komponent BungeeCord pro zpracování příkazů na straně proxy.
• Projekt reportuje metriky přes bStats.
• Formátování MiniMessage a podpora tab-completion jsou dostupné v podporovaných prostředích.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete flexibilní, na souborech založené vlastní příkazy, podmíněné skriptování a GUI založené flow příkazů bez psaní Java, MyCommand poskytuje konfigurovatelnou platformu pro tyto potřeby a podle potřeby přidává integrace s proxy a ekonomikou.