Plugin Minecraft HolographicDisplays

🔌 Informazioni su Holographic Displays

Holographic Displays è un plugin per Minecraft che fornisce ologrammi fluttuanti persistenti in grado di mostrare testo e oggetti. Il plugin espone comandi in gioco per creare e modificare gli ologrammi e offre un’API per sviluppatori per integrarli in altri plugin.

🎯 Obiettivo

Il plugin risolve la necessità di mostrare informazioni fluttuanti, etichette, menu ed elementi visivi nel mondo senza creare entità visibili permanenti. È utile per l’amministrazione del server, per display estetici, menu nel mondo e integrazioni in cui i plugin devono presentare dati ai giocatori in posizioni fisse.

⚙️ Funzionalità

• Creare e rimuovere ologrammi con nome in posizioni specifiche.
• Aggiungere, rimuovere, impostare e inserire righe di testo negli ologrammi.
• Mostrare oggetti fluttuanti come righe dell’ologramma (supporto agli oggetti fluttuanti).
• Leggere righe da un file di testo in un ologramma.
• Leggere e renderizzare immagini in un ologramma da un file o URL (con mappatura dei simboli e larghezza massima configurabili).
• Allineare, spostare, copiare e teleportarsi agli ologrammi.
• Ricaricare la configurazione del plugin e gli ologrammi salvati senza modifiche manuali ai file.
• API per sviluppatori disponibile per consentire ad altri plugin di creare e gestire gli ologrammi in modo programmatico.

🧩 A chi è rivolto

• Amministratori di server che vogliono display visivi nel mondo (server SMP, Survival, Minigame).
• Sviluppatori di plugin che hanno bisogno di un’API per mostrare testo/oggetti ai giocatori nel mondo.
• Team di staff che usano gli ologrammi per cartelli, menu o display informativi.

🏗️ Casi d’uso di esempio

• Un minigame mostra i punteggi attuali sopra ogni arena usando gli ologrammi.
• Una lobby del server mostra le regole del server e gli oggetti per teletrasportarsi al clic come righe fluttuanti.
• Un’integrazione di plugin pubblica statistiche dinamiche dei giocatori in un ologramma in una posizione fissa.

⌨️ Comandi

Nota: la documentazione indica che ogni sottocomando ha un permesso individuale (ad esempio /hd list richiede holographicdisplays.list). Il comando principale /hd è accessibile a tutti.

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin da un catalogo affidabile.
• Inserisci il JAR nella directory plugins/ del server per Bukkit/Spigot.
• Riavvia il server e controlla la console per confermare che il plugin sia stato caricato.

📦 Dipendenze

• Nel riepilogo ufficiale della documentazione non sono indicate dipendenze obbligatorie; verifica la pagina di download per eventuali integrazioni opzionali durante l’installazione.

🧾 Configurazione

• Il plugin supporta file di configurazione e ologrammi salvati; usa il comando di ricarica fornito per applicare le modifiche dopo aver modificato i file.
• Il rendering delle immagini e la mappatura dei simboli sono configurabili tramite la configurazione del plugin.

🧠 Note tecniche

• La documentazione ufficiale include una guida all’aggiornamento per Minecraft 1.13+ riguardo alle modifiche ai nomi dei materiali e alla gestione di immagini/icone.
• È documentata un’API per sviluppatori per le integrazioni con i plugin.

🤝 Quando questo plugin è utile

Se hai bisogno di display persistenti e modificabili nel mondo per informazioni, menu o integrazioni con plugin, Holographic Displays offre ologrammi con nome, importazione da file/immagini e un’API affinché altri plugin possano creare e aggiornare gli ologrammi in modo affidabile.