ZNPCs: plugin per creare NPC in Minecraft
Dipendenze: Tipo di server: Paper o Spigot 1.8.8–1.21.4 Versione di Minecraft: 1.8.8–1.21.4 Plugin dipendenti: PlaceholderAPI (facoltativo…
Dipendenze: Tipo di server: Paper o Spigot 1.8.8–1.21.4 Versione di Minecraft: 1.8.8–1.21.4 Plugin dipendenti: PlaceholderAPI (facoltativo, per le variabili negli ologrammi) Scarica: SpigotMC / GitHub Se ti servono NPC
Dipendenze:
Tipo di server: Paper o Spigot 1.8.8–1.21.4
Versione di Minecraft: 1.8.8–1.21.4
Plugin dipendenti: PlaceholderAPI (facoltativo, per le variabili negli ologrammi)
Scarica: SpigotMC / GitHub
Se ti servono NPC semplici per la lobby o come decorazione, Citizens può risultare troppo pesante. ZNPCs risolve lo stesso compito in modo più semplice: è un unico file .jar senza una marea di dipendenze, che permette di posizionare personaggi con la propria skin, del testo e una reazione al clic.
Funzionalità principali
Tutti gli NPC hanno un ID numerico univoco. Puoi creare un normale giocatore con una skin tramite nickname o URL, oppure posizionare un mob come uno ZOMBIE o uno SCHELETRO.
Quando un giocatore clicca su un NPC, il plugin esegue le azioni impostate. Può trattarsi di un messaggio, di un comando a nome del giocatore o della console, o persino dell'invio del giocatore a un altro server tramite BungeeCord. Se le azioni sono più di una, vengono eseguite a turno. Puoi anche impostare un cooldown (ritardo) per ogni azione.
Testo sopra la testa (Lines)
Sopra un NPC puoi aggiungere del testo con il comando lines. Il plugin supporta i codici colore e, se è installato PlaceholderAPI, anche variabili come %player_name% o %server_online%. Puoi inoltre modificare l'altezza del testo con il comando height.
Percorsi (Paths)
Un NPC non deve per forza restare fermo in un punto. Per insegnargli a camminare, devi attivare la modalità di registrazione (/znpcs path create <nome>) e percorrere tu stesso il tragitto desiderato. Al termine devi digitare /znpcs path exit. Poi questo percorso viene assegnato a un NPC specifico (/znpcs path set <id> <nome>), e quest'ultimo inizia a percorrerlo all'infinito.
Una precisazione importante: il movimento è molto semplice. ZNPCs non utilizza la ricerca del percorso vanilla (Pathfinder), perciò i personaggi non aggireranno gli ostacoli e non reagiranno agli altri giocatori.
Equipaggiamento e aspetto
I personaggi possono essere vestiti con un'armatura e si possono dare loro oggetti in mano. Basta prendere l'oggetto desiderato e digitare /znpcs equip <id> <slot> (slot disponibili: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
È inoltre possibile configurare il comportamento dell'NPC con il comando toggle: fargli guardare i giocatori più vicini (look), rispecchiare la skin del giocatore che lo osserva (mirror) oppure aggiungere un bagliore (glow) del colore scelto.
Comandi
Questi comandi richiedono i permessi di amministratore (znpcs.admin).
Comando | Descrizione | Permesso |
| Crea un NPC alle tue coordinate | znpcs.admin |
| Elimina un NPC | znpcs.admin |
| Mostra l'elenco degli NPC e dei loro ID | znpcs.admin |
| Teletrasporta l'NPC da te | znpcs.admin |
| Ti teletrasporta dall'NPC | znpcs.admin |
| Modifica il tipo di un NPC esistente | znpcs.admin |
| Modifica la skin del personaggio | znpcs.admin |
| Dà all'NPC l'oggetto che hai in mano | znpcs.admin |
| Modifica il testo sopra l'NPC | znpcs.admin |
| Modifica l'altezza del testo (predefinito 1) | znpcs.admin |
| Aggiunge un'azione al clic | znpcs.admin |
| Mostra l'elenco delle azioni dell'NPC (con i loro ID) | znpcs.admin |
| Elimina un'azione tramite il suo ID | znpcs.admin |
| Imposta un ritardo per l'esecuzione dell'azione | znpcs.admin |
| Registra un nuovo percorso | znpcs.admin |
| Esce dalla modalità di registrazione del percorso | znpcs.admin |
| Assegna un percorso all'NPC | znpcs.admin |
| Attiva/disattiva opzioni (look, holo, mirror) | znpcs.admin |
| Aggiunge un effetto di bagliore del colore scelto | znpcs.admin |
Tipi di azione per action add:
CMD (esegue un comando a nome del giocatore)
CONSOLE (esegue un comando dalla console)
CHAT (il giocatore scrive un messaggio in chat)
MESSAGE (invia un messaggio al giocatore)
SERVER (lo trasferisce a un altro server tramite BungeeCord)
Permessi di accesso
Qui è tutto estremamente semplice. Per quasi tutto serve un solo nodo:
Nodo | Cosa concede |
znpcs.admin | Accesso completo a tutti i comandi |
Configurazione
config.json
Parametro | Valore | Descrizione |
| 500 | Numero massimo di punti (passi) che è possibile registrare per un singolo percorso di NPC. Se il percorso è troppo lungo, la registrazione si interrompe automaticamente al raggiungimento di questo limite. |
| "DEFAULT" | Algoritmo di generazione dei nomi interni per gli NPC. Il valore standard garantisce un corretto collegamento dell'ID. |
| TRUE | Allinea automaticamente l'NPC esattamente al centro del blocco durante la sua creazione. Evita lo spostamento del modello verso il bordo del blocco. |
| "-" | Carattere che il plugin utilizza per sostituire gli spazi nel testo dei comandi o durante la generazione degli identificatori. |
| 600 | Intervallo di salvataggio automatico dei personaggi creati nel file npcs.json (600 secondi = 10 minuti). Protegge dalla perdita di dati in caso di crash improvviso del server. |
| TRUE | Attivazione della modalità di debug. Il plugin inizia a mostrare informazioni tecniche dettagliate e log degli errori nella console del server. Si consiglia di disattivarla (false) sui server stabili per mantenere pulita la console. |
| 0.3 | Distanza tra le righe dell'ologramma (testo) sopra la testa dell'NPC. Un valore più basso rende il testo più compatto. |
| 32 | Raggio (in blocchi) entro il quale il server inizia a inviare al giocatore i pacchetti per il rendering del modello dell'NPC. Ridurre il valore consente di risparmiare le risorse del server e del client. |
| FALSE | Supporto del cambio dinamico dei colori (sfumatura RGB) per il testo degli ologrammi. L'attivazione può generare un carico aggiuntivo sul client. |
npcs.json
Tutti gli NPC creati vengono registrati nel file npcs.json. Il plugin lo genera automaticamente, quindi è meglio non modificarlo a mano. L'unica giustificazione per mettere mano a questo file è quando devi trasferire NPC già configurati su un altro server.
conversations.json
Tutti i dialoghi sono salvati qui.
paths
Cartella in cui vengono salvati tutti i percorsi registrati.
data.json
Qui vengono salvate tutte le informazioni dettagliate sugli NPC creati.
Integrazioni
Se sul server è installato PlaceholderAPI, ZNPCs lo rileverà automaticamente senza estensioni particolari. Questo è utile, ad esempio, se vuoi mostrare sopra un NPC un contatore dinamico dei giocatori online.
Compatibilità
ZNPCs originale funziona correttamente solo fino alla versione 1.21.1. Per i server più recenti (1.21.1 e successivi) bisogna installare il fork ZNPC Plus.
Inoltre il plugin non si avvierà su Folia a causa delle sue particolarità nella gestione delle entità.
Quando conviene usare ZNPCs
Se devi posizionare allo spawn un NPC che si limita ad aprire un menu, consegnare un kit iniziale o reindirizzare i giocatori verso altri server di minigiochi, ZNPCs è un'ottima scelta. Fa esattamente ciò che promette e non appesantisce il server con funzionalità inutili.
Ma se hai intenzione di realizzare dialoghi ramificati o quest complesse, ti serve l'ecosistema Citizens + Denizen. ZNPCs non è pensato per questo.
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.








