Plugin Minecraft PlaceholderAPI

🔌 Informazioni su PlaceholderAPI

PlaceholderAPI è un plugin per Minecraft che espone un sistema centralizzato di placeholder e un ecosistema di espansioni (la eCloud). Permette ad altri plugin di leggere e sostituire migliaia di placeholder dinamici (dati del giocatore, valori economici, valori specifici del plugin, ecc.) senza richiedere integrazione diretta o dipendenze rigide.

🎯 Scopo

Il plugin risolve le difficoltà di integrazione tra plugin fornendo una singola API di placeholder estensibile. Gli autori dei plugin pubblicano espansioni che forniscono placeholder nominati; gli amministratori del server installano queste espansioni in modo che i plugin rivolti al server (scoreboards, chat, hologrammi, GUI) possano mostrare dati in tempo reale usando una sintassi coerente.

⚙️ Funzionalità

• API principale per il parsing dei placeholder, a cui altri plugin possono agganciarsi.
• Sistema di espansioni: espansioni distribuite singolarmente o incluse all’interno dei plugin.
• eCloud (cloud delle espansioni) per trovare e scaricare espansioni verificate in gioco.
• Comandi di gestione a runtime per elencare, registrare, annullare la registrazione e ricaricare le espansioni.
• Comandi di debug/parsing per valutare i placeholder per un giocatore o diffondere il risultato, utili per la risoluzione dei problemi.
• Utilità come il comando dump per condividere le espansioni installate e lo stato del plugin quando si chiede supporto.

🧩 A chi è rivolto

• Amministratori di server che hanno bisogno di testo dinamico unificato tra più plugin (scoreboards, tablists, hologrammi, GUI).
• Sviluppatori di plugin che vogliono esporre o usare placeholder senza imporre dipendenze rigide.
• Server Survival, minigiochi e network che combinano molti plugin e necessitano di una sintassi dei placeholder coerente.

🏗️ Esempi di utilizzo

• Un server installa un’espansione Vault così i placeholder dell’economia, come il saldo del giocatore, possono essere usati nei plugin di scoreboard e chat.
• Un amministratore scarica un’espansione specifica di un plugin dalla eCloud in modo che un plugin per hologrammi possa mostrare dati di obiettivi in tempo reale.
• Uno sviluppatore espone i dati del plugin tramite una PlaceholderExpansion, così altri server possono mostrare quei dati senza dipendere direttamente dal plugin.

⌨️ Comandi

(Nota: i comandi sopra sono documentati nella guida ufficiale ai comandi di PlaceholderAPI. I nodi di permesso per i singoli comandi non sono elencati nella documentazione dei comandi citata.)

⚙️ Installazione

📥 Configurazione

• Scarica il jar ufficiale di PlaceholderAPI e posizionalo nella directory plugins/ del tuo server.
• Avvia o riavvia il server e verifica nella console che PlaceholderAPI venga caricato.
• Installa le espansioni inserendo i jar delle espansioni in plugins/PlaceholderAPI/expansions/ oppure usando i comandi eCloud in gioco (per le espansioni verificate).

📦 Dipendenze

• PlaceholderAPI di per sé non richiede una dipendenza generale da plugin per funzionare. Alcuni placeholder forniti dalle espansioni si basano su altri plugin (ad esempio, un’espansione che mostra i valori economici richiederà il plugin economy corrispondente). Questi requisiti dipendono dalla singola espansione.

🧠 Note tecniche

• PlaceholderAPI è fornito per server basati su Spigot ed è comunemente usato anche su Paper. Espone un’API per consentire agli sviluppatori di registrare PlaceholderExpansions.
• Le espansioni possono essere distribuite come file jar autonomi oppure incluse in altri plugin; le espansioni autonome vengono in genere installate in plugins/PlaceholderAPI/expansions/.
• La funzione eCloud consente la scoperta e il download in gioco di espansioni verificate; i server devono consentire HTTPS in uscita affinché i download eCloud funzionino.
• Il plugin include comandi di debug e parsing per aiutare gli amministratori a verificare che i placeholder vengano risolti correttamente.

🤝 Quando questo plugin è utile

Se il tuo server usa più plugin che devono mostrare dati dinamici tra plugin diversi (chat, tab, hologrammi, scoreboards o GUI), PlaceholderAPI è utile perché centralizza la risoluzione dei placeholder e ti permette di aggiungere supporto per altri plugin tramite espansioni modulari senza modificare ogni plugin che li utilizza.