Plugin Minecraft DecentHolograms

🔌 Despre Decent Holograms

Decent Holograms este un plugin Minecraft care oferă holograme plutitoare configurabile (text pe mai multe linii și afișări cu iconițe) pentru servere Spigot/Bukkit. Se concentrează pe prezentare flexibilă și integrare pentru dezvoltatori, oferind un public API și puncte de integrare pentru alte pluginuri.

🎯 Scop

Pluginul rezolvă nevoia de a afișa informații persistente în lume (etichete, clasamente, instrucțiuni, afișări de stare) sub formă de text plutitor sau pictograme vizuale mici. Este destinat administratorilor de server și dezvoltatorilor de pluginuri care au nevoie de holograme personalizabile, scriptabile, fără dependențe externe obligatorii suplimentare.

⚙️ Funcții

• Crearea de holograme plutitoare pe mai multe linii (linii de text orientate către jucători).
• Suport pentru PlaceholderAPI pentru înlocuirea dinamică a textului.
• Public developer API pentru integrări cu pluginuri și instrumente personalizate.
• Suport pentru iconițe (vizualuri mici ale entităților/obiectelor care se rotesc și se mișcă ușor).
• Design ușor, fără dependențe externe obligatorii.
• Telemetrie de utilizare prin bStats (raportată de depozitul proiectului).
• Limitări Minecraft documentate explicit de autor (textul se uită mereu spre jucător; dimensiunea/fontul textului nu pot fi schimbate; unele iconițe de entități pot produce sunete).

🧩 Pentru cine este

• Proprietari și administratori de server care au nevoie de etichete în lume, panouri informative sau text decorativ.
• Dezvoltatori de pluginuri care vor să integreze holograme printr-un API.
• Servere Survival, SMP și minigame care folosesc placeholders pentru afișări dinamice.

🏗️ Exemple de utilizare

• Afișarea unui clasament dinamic folosind placeholders pentru a arăta jucătorii de top.
• Plasarea de panouri informative la spawn care se actualizează automat.
• Folosirea API-ului pentru a crea holograme din alte pluginuri sau scripturi personalizate.

⚙️ Instalare

📥 Configurare

• Descărcați JAR-ul oficial al pluginului de pe pagina de distribuție a proiectului.
• Plasați JAR-ul în directorul plugins/ al serverului dvs. (server compatibil cu Spigot/Bukkit).
• Reporniți serverul și verificați consola serverului pentru a confirma că pluginul s-a încărcat.

📦 Dependențe

• Nu există dependențe obligatorii. PlaceholderAPI este suportat pentru placeholders dinamice (opțional).

🧠 Note tehnice

• Codul sursă și versiunile sunt întreținute în depozitul public al proiectului.
• Licențiat sub GPL-3.0, așa cum este publicat în depozit.
• Proiectul oferă un API pentru dezvoltatori și instrucțiuni pentru a construi pluginul din surse.
• Pluginul este testat pe mai multe versiuni Minecraft (vedeți pagina oficială de distribuție pentru versiunile testate exact).

🤝 Când este util acest plugin

Dacă aveți nevoie de text în lume configurabil și scriptabil sau de afișări cu iconițe mici, cu suport pentru placeholders și un API pentru integrare, Decent Holograms oferă o soluție întreținută și cu puține dependențe pentru servere Spigot/Bukkit.