ZNPCs : plugin pour créer des PNJ dans Minecraft
Dépendances : Type de serveur : Paper ou Spigot 1.8.8–1.21.4 Version de Minecraft : 1.8.8–1.21.4 Plugins dépendants : PlaceholderAPI…
Dépendances : Type de serveur : Paper ou Spigot 1.8.8–1.21.4 Version de Minecraft : 1.8.8–1.21.4 Plugins dépendants : PlaceholderAPI (facultatif, pour les variables dans les hologrammes) Télécharger : SpigotMC / GitHub
Dépendances :
Type de serveur : Paper ou Spigot 1.8.8–1.21.4
Version de Minecraft : 1.8.8–1.21.4
Plugins dépendants : PlaceholderAPI (facultatif, pour les variables dans les hologrammes)
Télécharger : SpigotMC / GitHub
Si vous avez besoin de PNJ simples pour le lobby ou la décoration, Citizens peut s'avérer trop lourd. ZNPCs résout la même tâche de façon plus simple : c'est un unique fichier .jar sans une multitude de dépendances, qui permet de placer des personnages avec leur propre skin, du texte et une réaction au clic.
Fonctionnalités principales
Tous les PNJ possèdent un ID numérique unique. Vous pouvez créer un joueur ordinaire avec un skin par pseudo ou par URL, ou placer un mob comme un ZOMBIE ou un SQUELETTE.
Lorsqu'un joueur clique sur un PNJ, le plugin exécute les actions définies. Cela peut être un message, une commande au nom du joueur ou de la console, ou même l'envoi du joueur vers un autre serveur via BungeeCord. S'il y a plusieurs actions, elles s'exécutent à tour de rôle. Vous pouvez aussi configurer un cooldown (délai) pour chaque action.
Texte au-dessus de la tête (Lines)
Au-dessus d'un PNJ, vous pouvez ajouter du texte à l'aide de la commande lines. Le plugin prend en charge les codes couleur et, si PlaceholderAPI est installé, également des variables comme %player_name% ou %server_online%. Vous pouvez aussi modifier la hauteur du texte avec la commande height.
Trajets (Paths)
Un PNJ n'est pas obligé de rester immobile. Pour lui apprendre à marcher, il faut activer le mode enregistrement (/znpcs path create <nom>) et parcourir vous-même le trajet souhaité. Une fois terminé, il faut taper /znpcs path exit. Ensuite, ce trajet est attribué à un PNJ précis (/znpcs path set <id> <nom>), et celui-ci commence à le parcourir indéfiniment.
Une nuance importante : le déplacement est très simple. ZNPCs n'utilise pas la recherche de chemin vanilla (Pathfinder), c'est pourquoi les personnages ne contourneront pas les obstacles et ne réagiront pas aux autres joueurs.
Équipement et apparence
On peut habiller les personnages d'une armure et leur mettre des objets en main. Il suffit de prendre l'objet souhaité et de taper /znpcs equip <id> <emplacement> (emplacements disponibles : HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Il est également possible de configurer le comportement du PNJ via la commande toggle : le faire regarder les joueurs les plus proches (look), refléter le skin du joueur qui le regarde (mirror) ou ajouter une lueur (glow) de la couleur choisie.
Commandes
Ces commandes nécessitent les droits d'administrateur (znpcs.admin).
Commande | Description | Droit |
| Crée un PNJ à vos coordonnées | znpcs.admin |
| Supprime un PNJ | znpcs.admin |
| Affiche la liste des PNJ et de leurs ID | znpcs.admin |
| Téléporte le PNJ vers vous | znpcs.admin |
| Vous téléporte vers le PNJ | znpcs.admin |
| Modifie le type d'un PNJ existant | znpcs.admin |
| Modifie le skin du personnage | znpcs.admin |
| Donne au PNJ l'objet que vous tenez en main | znpcs.admin |
| Modifie le texte au-dessus du PNJ | znpcs.admin |
| Modifie la hauteur du texte (par défaut 1) | znpcs.admin |
| Ajoute une action au clic | znpcs.admin |
| Affiche la liste des actions du PNJ (avec leurs ID) | znpcs.admin |
| Supprime une action par son ID | znpcs.admin |
| Définit un délai pour l'exécution de l'action | znpcs.admin |
| Enregistre un nouveau trajet | znpcs.admin |
| Quitte le mode enregistrement du trajet | znpcs.admin |
| Attribue un trajet au PNJ | znpcs.admin |
| Active/désactive des options (look, holo, mirror) | znpcs.admin |
| Ajoute un effet de lueur de la couleur choisie | znpcs.admin |
Types d'action pour action add :
CMD (exécute une commande au nom du joueur)
CONSOLE (exécute une commande depuis la console)
CHAT (le joueur écrit un message dans le chat)
MESSAGE (envoie un message au joueur)
SERVER (le transfère vers un autre serveur via BungeeCord)
Droits d'accès
Ici, tout est on ne peut plus simple. Presque tout ne nécessite qu'un seul nœud :
Nœud | Ce qu'il accorde |
znpcs.admin | Accès complet à toutes les commandes |
Configuration
config.json
Paramètre | Valeur | Description |
| 500 | Nombre maximal de points (étapes) pouvant être enregistrés pour un seul trajet de PNJ. Si le trajet est trop long, l'enregistrement s'arrête automatiquement une fois cette limite atteinte. |
| "DEFAULT" | Algorithme de génération des noms internes des PNJ. La valeur par défaut assure une liaison correcte des ID. |
| TRUE | Aligne automatiquement le PNJ exactement au centre du bloc lors de sa création. Empêche le décalage du modèle vers le bord du bloc. |
| "-" | Caractère que le plugin utilise pour remplacer les espaces dans le texte des commandes ou lors de la génération des identifiants. |
| 600 | Intervalle de sauvegarde automatique des personnages créés dans le fichier npcs.json (600 secondes = 10 minutes). Protège contre la perte de données en cas de plantage soudain du serveur. |
| TRUE | Activation du mode débogage. Le plugin commence à afficher des informations techniques détaillées et des journaux d'erreurs dans la console du serveur. Il est recommandé de le désactiver (false) sur les serveurs stables pour garder la console propre. |
| 0.3 | Distance entre les lignes de l'hologramme (texte) au-dessus de la tête du PNJ. Une valeur plus faible rend le texte plus compact. |
| 32 | Rayon (en blocs) dans lequel le serveur commence à envoyer des paquets au joueur pour le rendu du modèle du PNJ. Réduire la valeur économise les ressources du serveur et du client. |
| FALSE | Prise en charge du changement dynamique des couleurs (dégradé RGB) du texte des hologrammes. L'activer peut générer une charge supplémentaire sur le client. |
npcs.json
Tous les PNJ créés sont enregistrés dans le fichier npcs.json. Le plugin le génère automatiquement, il vaut donc mieux ne pas le modifier à la main. La seule justification pour intervenir dans ce fichier est lorsque vous devez transférer des PNJ configurés vers un autre serveur.
conversations.json
Tous les dialogues sont stockés ici.
paths
Dossier dans lequel sont enregistrés tous les trajets enregistrés.
data.json
Toutes les informations détaillées sur les PNJ créés sont stockées ici.
Intégrations
Si PlaceholderAPI est installé sur le serveur, ZNPCs le détectera automatiquement sans extensions particulières. Cela est utile, par exemple, si vous souhaitez afficher au-dessus d'un PNJ un compteur dynamique de joueurs en ligne.
Compatibilité
Le ZNPCs original ne fonctionne correctement que jusqu'à la version 1.21.1. Pour les serveurs plus récents (1.21.1 et au-delà), il faut installer le fork ZNPC Plus.
De plus, le plugin ne démarrera pas sur Folia en raison de ses particularités dans la gestion des entités.
Quand utiliser ZNPCs
Si vous devez placer au spawn un PNJ qui se contente d'ouvrir un menu, de distribuer un kit de départ ou de rediriger les joueurs vers d'autres serveurs de mini-jeux, ZNPCs est un excellent choix. Il fait exactement ce qu'il promet et ne surcharge pas le serveur de fonctionnalités inutiles.
Mais si vous prévoyez de créer des dialogues ramifiés ou des quêtes complexes, vous avez besoin de l'écosystème Citizens + Denizen. ZNPCs n'est pas conçu pour cela.
Installation
Une installation classique prend environ 5 minutes. Le déroulé est le même ; seuls le loader et le build correspondant changent.
- 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.








