PlaceholderAPI — il plugin per la sostituzione di dati dinamici in Minecraft
PlaceholderAPI (PAPI) inserisce dati dinamici — nome giocatore, rango, saldo — in chat, scoreboard e menu di un server Minecraft.
PlaceholderAPI (PAPI) inserisce dati dinamici — nome giocatore, rango, saldo — in chat, scoreboard e menu di un server Minecraft.
PlaceholderAPI — il plugin per la sostituzione di dati dinamici in Minecraft
Versione di Minecraft su cui l'articolo è stato testato e scritto: 26.1.2
Intervallo di versioni supportate: 1.8.x – 26.1.x
PlaceholderAPI (abbreviato PAPI) è un plugin lato server per Minecraft che inserisce nel testo valori dinamici al posto di marcatori speciali. Di per sé non genera nulla: è un motore che individua in una stringa un marcatore del tipo %player_name% e lo sostituisce con il valore attuale — il nome del giocatore, il saldo, il rango, il numero di giocatori online. I dati veri e propri vengono forniti da moduli separati — le estensioni —, mentre PAPI si occupa solo della sostituzione. Grazie a questo, i plugin di chat, scoreboard, tab-list e menu leggono i valori in un formato comune, senza una propria sintassi.
Formato dei placeholder
Un placeholder si scrive tra due segni di percentuale: %<розширення>_<параметр>%. La prima parte, prima del trattino basso, è il nome dell'estensione, seguita dal parametro specifico. Per esempio, %player_name% restituisce il nome del giocatore, mentre %server_online% restituisce il numero di giocatori online.
La sostituzione avviene solo dove è il plugin destinatario stesso a richiamarla. Se un plugin non supporta PAPI, i marcatori nei suoi messaggi resteranno semplice testo. È possibile verificare un singolo placeholder con il comando di analisi:
/papi parse me %player_name%
Se la risposta restituisce il testo del marcatore stesso e non un valore, significa che l'estensione necessaria manca oppure che il plugin sorgente è disattivato.
Estensioni ed eCloud
PlaceholderAPI di base non contiene alcun placeholder — provengono tutti dalle estensioni. Alcune sono integrate nel plugin sorgente e si registrano automaticamente all'avvio del server; altre sono file jar separati disponibili nel cloud delle estensioni (eCloud) e si installano nella cartella /plugins/PlaceholderAPI/expansions/.
L'estensione desiderata può essere scaricata direttamente dal gioco:
/papi ecloud download <розширення>
/papi reload
Tramite il comando vengono scaricate solo le estensioni verificate — una protezione contro il codice dannoso. Quelle non verificate si installano manualmente: si scarica il jar dal sito e lo si colloca nella cartella delle estensioni.
Accesso a eCloud: se l'hosting o il firewall blocca le connessioni esterne, il download tramite comando non funzionerà — l'estensione dovrà essere aggiunta manualmente.
Comandi
Tutti i comandi iniziano con /papi. Per impostazione predefinita sono disponibili solo agli operatori; permessi specifici vengono assegnati tramite i nodi placeholderapi.*.
Comando | Funzione |
| Analizza i placeholder nel testo per un giocatore |
| Analizza i placeholder relazionali per due giocatori |
| Mostra le estensioni attive |
| Informazioni su un'estensione specifica |
| Scarica un'estensione dal cloud |
| Elenco dei placeholder dell'estensione |
| Ricarica il plugin e la configurazione |
| Versione del plugin installato |
Configurazione
In config.yml solo pochi parametri sono utili da modificare:
Parametro | Cosa fa |
| Connessione a eCloud. |
| Testo dei valori booleani dei placeholder; può essere sostituito con sì / no |
| Formato di data e ora per i placeholder corrispondenti |
| Controlla gli aggiornamenti del plugin all'avvio e avvisa gli operatori |
I restanti valori nel file sono di servizio (protezione delle estensioni, modalità di sostituzione nei componenti Adventure, debug) e per impostazione predefinita non vengono modificati.
Conclusione
PlaceholderAPI offre un formato unico di sostituzione dei dati compreso da centinaia di plugin: invece di un'integrazione separata per ogni plugin, basta una sola riga con un placeholder. È utile agli amministratori di server Minecraft con chat, tab-list, scoreboard o menu basati su dati dinamici; per il gioco in singolo non ha applicazione.
Installazione
Un'installazione tipica richiede circa 5 minuti. Il procedimento è lo stesso; cambiano solo il loader e la build corrispondente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
