Plugin Minecraft PlaceholderAPI

🔌 Despre PlaceholderAPI

PlaceholderAPI este un plugin Minecraft care oferă un sistem centralizat de placeholder-uri și un ecosistem de extensii (eCloud). Le permite altor pluginuri să citească și să înlocuiască mii de placeholder-uri dinamice (datele jucătorilor, valori economice, valori specifice pluginului etc.) fără integrare directă sau dependențe puternice.

🎯 Scop

Pluginul rezolvă dificultățile de integrare dintre pluginuri oferind un singur API extensibil pentru placeholder-uri. Autorii de pluginuri publică "expansions" care oferă placeholder-uri denumite; administratorii serverului instalează aceste expansions, astfel încât pluginurile care afișează informații pe server (scoreboard-uri, chat, holograme, GUI-uri) să poată afișa date live folosind o sintaxă consistentă.

⚙️ Funcții

• API de bază pentru parsarea placeholder-urilor, la care se pot conecta alte pluginuri.
• Sistem de expansions: expansions împachetate separat sau expansions incluse în pluginuri.
• eCloud (cloud de extensii) pentru găsirea și descărcarea expansions verificate direct din joc.
• Comenzi de administrare în timpul rulării pentru listarea, înregistrarea, anularea înregistrării și reîncărcarea expansions.
• Comenzi debug/parse pentru evaluarea placeholder-urilor pentru un jucător sau pentru difuzarea rezultatelor, utile la depanare.
• Utilitare precum comanda dump pentru a partaja expansions instalate și starea pluginului atunci când ceri suport.

🧩 Pentru cine este

• Administratori de server care au nevoie de text dinamic unificat între mai multe pluginuri (scoreboard-uri, tablisturi, holograme, GUI-uri).
• Dezvoltatori de pluginuri care vor să expună sau să consume placeholder-uri fără a impune dependențe puternice.
• Servere Survival, minigame și network care combină multe pluginuri și au nevoie de o sintaxă consistentă pentru placeholder-uri.

🏗️ Exemple de utilizare

• Un server instalează o expansion Vault astfel încât placeholder-urile economice, precum soldul jucătorului, să poată fi folosite în pluginurile pentru scoreboard și chat.
• Un administrator descarcă o expansion specifică unui plugin din eCloud, astfel încât un plugin de hologramă să poată afișa date de obiectiv în timp real.
• Un dezvoltator expune datele pluginului printr-un PlaceholderExpansion, astfel încât alte servere să poată afișa acele date fără a depinde direct de plugin.

⌨️ Comenzi

(Notă: comenzile de mai sus sunt documentate în referința oficială de comenzi PlaceholderAPI. Nodurile de permisiune pentru comenzile individuale nu sunt listate în documentația de referință.)

⚙️ Instalare

📥 Configurare

• Descărcați jar-ul oficial PlaceholderAPI și puneți-l în directorul plugins/ al serverului dvs.
• Porniți sau reporniți serverul și verificați în consolă că PlaceholderAPI se încarcă.
• Instalați expansions fie plasând jar-urile expansion în plugins/PlaceholderAPI/expansions/, fie folosind comenzile eCloud din joc (pentru expansions verificate).

📦 Dependențe

• PlaceholderAPI în sine nu necesită o dependență generală de plugin pentru a funcționa. Unele placeholder-uri oferite de expansions se bazează pe alte pluginuri (de exemplu, o expansion care afișează valori economice va necesita pluginul de economie corespunzător). Aceste cerințe depind de expansion-ul specific.

🧠 Note tehnice

• PlaceholderAPI este oferit pentru servere bazate pe Spigot și este folosit în mod obișnuit și pe Paper. Acesta oferă un API pentru ca dezvoltatorii de pluginuri să înregistreze PlaceholderExpansions.
• Expansions pot fi distribuite ca fișiere jar independente sau incluse în alte pluginuri; expansions independente sunt instalate de obicei în plugins/PlaceholderAPI/expansions/.
• Funcția eCloud permite descoperirea și descărcarea în joc a expansions verificate; serverele trebuie să permită HTTPS de ieșire pentru ca descărcările eCloud să funcționeze.
• Pluginul include comenzi de debug și parsing pentru a ajuta administratorii să verifice că placeholder-urile se rezolvă corect.

🤝 Când este util acest plugin

Dacă serverul dvs. folosește mai multe pluginuri care trebuie să afișeze date dinamice, partajate între pluginuri (chat, tab, holograme, scoreboard-uri sau GUI-uri), PlaceholderAPI este util deoarece centralizează rezolvarea placeholder-urilor și vă permite să adăugați suport pentru pluginuri suplimentare prin expansions modulare, fără a modifica fiecare plugin consumator.