FancyNpcs – Minecraft Java Edition 1.19.4–1.21.x

La creazione di personaggi non giocanti (NPC) interattivi sui server Minecraft comporta tradizionalmente un notevole dispendio di risorse hardware. Le soluzioni obsolete registrano gli NPC come entità server a tutti gli effetti (Entity), costringendo il core a elaborare la loro intelligenza artificiale, le collisioni fisiche, la ricerca dei percorsi e il caricamento dei chunk. Ciò provoca un calo critico dell'indicatore TPS (Ticks Per Second) all'aumentare del numero di personaggi. Il plugin FancyNpcs propone un metodo alternativo, basato sui pacchetti, per il rendering dei personaggi virtuali, che consente di gestire centinaia di figure interattive senza alcun impatto sulle prestazioni del thread del server.

Architettura a pacchetti e compatibilità con Folia

La principale particolarità tecnica di FancyNpcs consiste nel fatto che i personaggi creati esistono esclusivamente nella memoria del plugin e sul lato dei client connessi. Il server non li aggiunge al database del mondo e non li elabora nel ciclo generale di aggiornamento delle entità.

Quando un giocatore si avvicina alle coordinate impostate, il plugin intercetta il traffico di rete e invia al client i pacchetti ClientboundAddPlayerPacket (per i modelli umani) o ClientboundAddEntityPacket (per le altre creature). Il comportamento successivo, l'equipaggiamento e lo stato di visualizzazione vengono aggiornati tramite i pacchetti ClientboundSetEntityDataPacket (metadati) e ClientboundSetEquipmentPacket (equipaggiamento). Per il server questi personaggi non esistono: sono «proiezioni virtuali» destinate agli utenti finali.

Questo approccio rende FancyNpcs la scelta ideale per i server multithread basati su Folia. Poiché Folia suddivide il mondo in regioni separate, ognuna delle quali opera in un proprio thread, i plugin NPC tradizionali provocano spesso deadlock ed errori critici a causa dei tentativi di interazione tra i thread di regioni diverse. FancyNpcs elabora i dati in modo asincrono e invia i pacchetti direttamente ai giocatori, evitando completamente i conflitti con lo scheduler delle attività di Folia.

Opzioni di personalizzazione dell'aspetto

Il plugin supporta un'ampia gamma di tipi di entità ed effetti visivi. I giocatori possono creare NPC sotto forma di qualsiasi mob vanilla (Player, Cow, Zombie, Skeleton, Villager, Pig, ecc.) e regolarne con precisione l'aspetto.

Gestione delle skin (per i modelli umani)

Per i personaggi di tipo player sono disponibili diverse fonti per il caricamento delle texture:

• @mirror: la skin dell'NPC copia dinamicamente la skin del giocatore che in quel momento lo sta guardando.

• Nome o UUID di un account con licenza: il plugin invia automaticamente una richiesta ai server di sessione Mojang per caricare la texture corrispondente.

• Collegamento diretto a una risorsa web (URL): possibilità di caricare qualsiasi file .png di terze parti da un server web.

• File locali: immagini precedentemente collocate nella cartella /plugins/FancyNpcs/skins/.

• Flag --slim: attiva l'uso del modello a braccia sottili (stile Alex) per le skin caricate tramite collegamento.

Effetti visivi e attributi

• Bagliore (Glowing): aggiunge un contorno colorato attorno al personaggio. Il colore è legato ai colori delle squadre vanilla (Team Colors).

• Equipaggiamento (Equipment): ai personaggi si possono assegnare oggetti qualsiasi nella mano sinistra o destra, oltre a far loro indossare elmo, corazza, gambali e stivali.

• Pose (Poses): sono supportati stati di visualizzazione specifici, come stare seduti, sdraiati (imitazione del sonno nel letto), nuotare e strisciare.

• Dimensione (Scale): nelle nuove versioni del plugin è implementato il supporto al ridimensionamento delle entità (modifica della dimensione fisica del modello).

Sistema di comandi e sintassi

La gestione dei personaggi avviene esclusivamente tramite comandi nella chat di gioco o nella console del server. La tabella seguente contiene la descrizione della sintassi di base:

Per l'amministrazione globale del plugin si utilizzano i comandi della piattaforma:

• /fancynpcs reload — ricarica le configurazioni di sistema.

• /fancynpcs save — scrive forzatamente lo stato attuale di tutti gli NPC su disco nel file del database.

Sistema di azioni interattive (Actions)

FancyNpcs contiene un meccanismo di scripting delle azioni integrato, che si attiva all'interazione del giocatore con il personaggio. Le azioni possono essere configurate per diversi tipi di clic (LEFT_CLICK, RIGHT_CLICK, ANY_CLICK).

Il plugin offre i seguenti tipi di azioni da eseguire:

• message: invio di un messaggio al giocatore. Supporta MiniMessage (colori Hex) e le variabili PlaceholdersAPI.

• player_command: esecuzione di un comando a nome del giocatore.

• player_command_as_op: esecuzione di un comando a nome del giocatore con concessione temporanea dei diritti di operatore (per attivare comandi che un giocatore comune non può utilizzare).

• console_command: esecuzione di un comando da parte della console del server. La variabile {player} viene sostituita automaticamente con il nome del giocatore.

• send_to_server: trasferimento istantaneo del giocatore su un altro server della rete BungeeCord o Velocity.

• wait: crea una pausa tra le azioni (ritardo in tick del server).

• block_until_done: impedisce di cliccare ripetutamente sull'NPC fino al completamento dello scenario di azioni in corso.

• execute_random_action: scelta casuale di una delle azioni successive nell'elenco.

Esempio di creazione di uno scenario interattivo complesso per un NPC di nome Bob:

1. Aggiunta di un messaggio di benvenuto:
   /npc action Bob RIGHT_CLICK add message <yellow>Benvenuto sul nostro server, %player_name%!</yellow>

2. Aggiunta di una pausa di 40 tick (2 secondi):
   /npc action Bob RIGHT_CLICK add wait 40

3. Teletrasporto del giocatore allo spawn tramite la console:
   /npc action Bob RIGHT_CLICK add console_command teleport {player} 0 100 0

Grazie alla possibilità di aggiungere più passaggi consecutivi e di regolare la coda tramite add_before, add_after e move_up/move_down, gli amministratori possono costruire veri e propri alberi di dialogo o meccaniche complesse di transizione tra server di lobby senza installare plugin aggiuntivi come Denizen o MyCommand.

Struttura dei file di configurazione

Tutti i dati sono memorizzati nella cartella plugins/FancyNpcs/. Il funzionamento del plugin si basa su due file:

1. config.yml

Questo file definisce il comportamento globale del plugin e contiene le seguenti impostazioni:

• turn_to_player_distance (predefinito 5): raggio in blocchi entro il quale il personaggio gira la testa verso i giocatori. La riduzione di questo parametro ottimizza la trasmissione dei pacchetti di rete nelle zone affollate.

• visibility_distance (predefinito 20): distanza in blocchi alla quale vengono inviati al client i pacchetti di comparsa degli NPC. La riduzione aiuta a nascondere i personaggi dietro le pareti o la nebbia di rendering per risparmiare gli FPS dei giocatori.

• enable_autosave: salvataggio automatico e periodico delle modifiche su disco.

2. npcs.yml

In questo file il plugin memorizza il database degli NPC creati. Ogni personaggio è descritto da un blocco di dati separato:

YAML

Conclusione

Il plugin FancyNpcs è una soluzione moderna ed efficiente per creare personaggi decorativi e interattivi sui server di Minecraft Java Edition. Elimina il problema principale dei vecchi strumenti: il consumo di tempo di processore del server per la gestione delle entità.

La principale limitazione del plugin è la totale assenza di intelligenza artificiale. Poiché i personaggi sono proiezioni virtuali sul lato client, non possono spostarsi autonomamente nel mondo, interagire con i blocchi o attaccare altri mob.

Rispetto al classico plugin Citizens, che supporta meccaniche di movimento complesse (navigazione tramite waypoint) e l'integrazione con sistemi di combattimento (mod Sentinel), FancyNpcs è inferiore quanto a flessibilità dell'intelligenza artificiale. Tuttavia, Citizens crea un carico enorme sul thread principale del server ed è praticamente inutilizzabile su Folia. FancyNpcs offre un'alternativa ideale per i server di lobby, gli hub Velocity e i grandi progetti SMP, dove ai personaggi si richiede soltanto una presenza statica, un bell'aspetto e una rapida esecuzione dei comandi al clic.