Server Minecraft con plugin 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 | **Comando** | **Descrizione** | **Permesso** | **Accesso** | |---|---|---:|:---| | `/hd` | Comando principale; mostra informazioni sul plugin e la versione. | nessuno (accessibile a tutti) | Giocatore | | `/hd help` | Mostra i comandi disponibili e un aiuto breve. | nessuno (accessibile a tutti) | Giocatore | | `/hd create <hologramName> [text]` | Crea un nuovo ologramma nella tua posizione. | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | Elimina un ologramma con nome. | `holographicdisplays.delete` | Admin | | `/hd list [page]` | Elenca gli ologrammi e le posizioni esistenti. | `holographicdisplays.list` | Admin | | `/hd near <radius>` | Elenca gli ologrammi vicini a te entro il raggio. | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | Teletrasportati alla posizione di un ologramma. | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | Allinea un ologramma a un altro su un asse specifico. | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | Sposta un ologramma alla tua posizione. | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | Entra nelle opzioni di modifica di un ologramma. | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | Aggiunge una riga di testo a un ologramma. | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | Rimuove una riga numerata da un ologramma. | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | Modifica il testo di una riga specifica. | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | Inserisce una riga dopo l’indice indicato. | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | Mostra il contenuto dell’ologramma con i numeri di riga. | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | Copia il contenuto da un ologramma a un altro. | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | Legge le righe da un file in un ologramma. | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | Renderizza un’immagine nell’ologramma da file o URL. | `holographicdisplays.readimage` | Admin | | `/hd reload` | Ricarica la configurazione e gli ologrammi salvati. | `holographicdisplays.reload` | Admin | 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 | **Permesso** | **Descrizione** | **Predefinito** | |---|---|---:| | `holographicdisplays.<subcommand>` | Permesso individuale per ogni sottocomando `/hd` (esempio: `holographicdisplays.list`). | non specificato | | `holographicdisplays.update` | Ricevi notifiche di aggiornamento all’accesso se abilitato nella configurazione. | non specificato | | `holographicdisplays.*` | Concede tutti i permessi di holographicdisplays (se supportato dal plugin permessi). | non specificato | ## ⚙️ 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.

Plugin