Plugin Minecraft CommandButtons

🔌 Despre CommandButtons

CommandButtons este un plugin Minecraft pentru asocierea comenzilor cu interacțiunile cu blocuri. Le permite administratorilor serverului să atașeze seturi de comenzi la blocuri (butoane, semne, pressure plates sau blocuri clicabile), astfel încât acele comenzi să ruleze atunci când un jucător interacționează cu blocul configurat. Pluginul acceptă rularea comenzilor ca și consolă și/sau ca jucătorul care a declanșat blocul și oferă un editor GUI în joc pentru a gestiona butoanele și proprietățile lor.

🎯 Scop

Pluginul rezolvă problema creării de elemente interactive din lume care execută acțiuni administrative sau de gameplay fără ca jucătorii să fie nevoiți să scrie comenzi. Utilizările obișnuite includ panouri de teleportare, selectoare de kituri, acțiuni ce pot fi cumpărate și mecanici personalizate declanșate de interacțiunea cu blocuri.

⚙️ Funcții

• Asociază un număr nelimitat de comenzi unui singur command button (comenzi de consolă și de jucător).
• Editor GUI în joc pentru crearea și editarea command buttons și a locațiilor lor.
• Cooldown-uri per jucător și globale; cooldown-urile persistă după repornirea serverului.
• Integrare economică opțională prin Vault pentru a taxa jucătorii pentru folosirea butoanelor.
• Noduri de permisiune personalizate pentru restricționarea utilizării anumitor butoane.
• Mesaje personalizabile printr-un fișier de mesaje.
• Mai multe locații pentru un command button, astfel încât o singură configurație să poată fi aplicată la mai multe blocuri.
• Comenzi de bază pentru creare, editare și reîncărcarea datelor pluginului.

🧩 Pentru cine este

• Administratori de server și builderi care vor elemente din lume ce pot fi apăsate și rulează comenzi.
• Servere de minigame și lobby care au nevoie de meniuri interactive sau panouri de teleportare/selectare kit.
• Servere care folosesc pluginuri de economie și vor mecanici de tip plată per utilizare.

🏗️ Exemple de utilizare

• Un panou de teleportare la spawn, unde fiecare buton teleportează jucătorul care apasă la o arenă diferită.
• Un perete de selectare a kitului: apăsarea unui buton rulează un set de comenzi pentru a oferi kituri și mesaje.
• O acțiune ce poate fi cumpărată: un buton taxează moneda din joc și execută comanda de recompensă.

⌨️ Comenzi

🔐 Permisiuni

⚙️ Instalare

📥 Configurare

• Descărcați jar-ul oficial al pluginului și puneți-l în directorul plugins/ al serverului.
• Reporniți serverul și verificați logurile consolei pentru a confirma că pluginul a fost încărcat corect.
• Folosiți comenzile /commandbuttons furnizate pentru a crea și edita configurațiile butoanelor în joc.

📦 Dependențe

• Opțional: Vault pentru a activa funcțiile de taxare economică. Este necesar un plugin de economie care se integrează cu Vault (de exemplu, EssentialsX economy) pentru a folosi funcția de plată per utilizare.

🧠 Note tehnice

• Pluginul oferă un editor GUI și creează fișiere de configurare/mesaje pentru personalizare.
• Cooldown-urile persistă după repornirea serverului.
• Sunt acceptate atât modul de executare a comenzilor ca și consolă, cât și ca jucător; comenzile executate ca jucător vor folosi permisiunile jucătorului (comenzile care necesită permisiuni mai mari decât cele ale jucătorului nu vor rula când sunt executate ca jucător).
• Funcțiile economice necesită Vault și un plugin de economie acceptat.

🤝 Când este util acest plugin

Folosiți CommandButtons când aveți nevoie de acțiuni configurabile, legate de locație, declanșate de interacțiunea jucătorului (butoane, semne, plăci) cu cooldown-uri integrate, verificări de permisiuni și costuri economice opționale, gestionate printr-un editor în joc.