Plugin Minecraft MyCommand

🔌 Despre MyCommand

MyCommand este un plugin Minecraft pentru crearea de comenzi personalizate, aliasuri și interfețe interactive bazate pe comenzi, fără a scrie Java. Oferă un sistem bazat pe YAML pentru a defini comenzi care rulează alte comenzi, trimit text formatat, deschid GUI-uri, declanșează scripturi și interacționează cu evenimente.

🎯 Scop

MyCommand se adresează administratorilor de servere care au nevoie de comenzi personalizate flexibile, scurtături și interfețe pentru administratori/utilizatori. Rezolvă problema adăugării unui comportament personalizat al comenzilor (delay-uri, warmup-uri, cooldown-uri, tab-completion, placeholders) și a interacțiunilor GUI ușoare, fără a dezvolta un plugin complet.

⚙️ Funcții

• Creează comenzi și aliasuri noi, opțional înregistrate pentru tab completion.
• Rulează mai multe comenzi dintr-o singură comandă personalizată (executare de către console sau jucător).
• Delay-uri, warmup-uri și cooldown-uri pentru comenzi.
• Suprascrie alte comenzi sau oferă scurtături/aliasuri.
• Declanșatoare de comandă din iteme, blocuri, semne, cărți, NPC-uri și item frames.
• Elemente GUI: IconMenu bazat pe chest, ActionBar, BossBar, Title, Scoreboard, Anvil GUI și Sign GUI.
• Suport pentru placeholders și condiții de tip script pentru comportament dinamic.
• Integrare cu economia (opțional prin Vault) și câteva funcții de economie standalone.
• Suport pentru evenimente ale jucătorilor (join/quit/death) și sarcini programate.
• Bază de date personalizată pentru jucători bazată pe SQL, opțională, și suport pentru mai multe fișiere pentru comenzi nelimitate.
• Funcții legate de BungeeCord și o variantă separată pentru Bungee pentru comenzi pe partea de proxy.
• Cereri HTTP (GET/POST) și suport pentru formatarea MiniMessage acolo unde este disponibilă.
• Folosește bStats pentru raportarea metricilor.

🧩 Pentru cine este

• Servere Survival și SMP care doresc comenzi și meniuri personalizate fără programare.
• Servere axate pe administrare sau economie care au nevoie de fluxuri shop/command personalizate.
• Rețele proxy care necesită comportament de comenzi centralizat sau pe partea de proxy.
• Operatori de server care au nevoie de condiții de tip script și placeholders pentru ieșiri dinamice.

🏗️ Exemple de utilizare

• Definește o singură comandă care rulează o secvență de comenzi console pentru a deschide un shop, a da iteme și a înregistra achiziția.
• Creează meniuri GUI pentru pedeapsă/teleport folosind intrări chest GUI și prompturi anvil/sign.
• Oferă aliasuri scurte care se mapează la comenzi mai lungi de schimbare a serverului BungeeCord cu tab completion.

⌨️ Commands

Documentația oficială listează comenzi administrative pentru gestionarea pluginului. Exemple documentate de proiect includ:

(Consultați documentația oficială a comenzilor pluginului pentru lista completă și sintaxa exactă.)

🔐 Permissions

Proiectul documentează noduri de permission pentru acțiuni administrative. Exemple din lista oficială includ:

(Vezi documentația permissions a pluginului pentru harta completă a permisiunilor.)

⚙️ Instalare

📥 Configurare

• Descarcă fișierul oficial al pluginului .jar și pune-l în folderul plugins/ al serverului tău.
• Pornește sau repornește serverul și verifică logurile consolei pentru a confirma că pluginul s-a încărcat.
• Dacă pluginul nu se încarcă, verifică dacă pluginurile de suport necesare/opționale (vezi Dependencies) sunt prezente sau actualizate.

📦 Dependencies

• ProtocolLib — menționat ca important dacă pluginul nu se încarcă sau pentru unele funcții.
• Vault — opțional, necesar pentru integrări cu economia.
• PlaceholderAPI — opțional, pentru suport extins pentru placeholders.

Instalează doar dependency-urile confirmate pentru funcțiile dorite; multe integrări sunt opționale.

🧠 Note tehnice

• Pluginul este configurat prin fișiere YAML și suportă mai multe fișiere de comenzi pentru a evita limitele de comenzi.
• Stocarea SQL este disponibilă pentru baza de date personalizată a jucătorilor (opțional), iar configurările cu mai multe fișiere sunt suportate.
• Există un component BungeeCord separat pentru procesarea comenzilor pe partea de proxy.
• Proiectul raportează metrici prin bStats.
• Formatarea MiniMessage și suportul pentru tab-completion sunt disponibile în mediile suportate.

🤝 Când este util acest plugin

Dacă ai nevoie de comenzi personalizate flexibile, bazate pe fișiere, scripting condițional și fluxuri de comenzi bazate pe GUI fără a scrie Java, MyCommand oferă o platformă configurabilă pentru aceste nevoi și adaugă integrări cu proxy și economie acolo unde este necesar.