Plugin Minecraft NPC

🔌 À propos de NPC

NPC est un plugin Minecraft pour les serveurs Spigot qui permet aux administrateurs de créer des NPC simples et persistants. Chaque NPC peut cloner la skin d'un joueur ou utiliser une skin basée sur une entité, est sauvegardé sur le disque afin de persister entre les redémarrages du serveur, et affiche un message configurable lorsqu'un joueur interagit avec lui.

🎯 Objectif

Le plugin offre un moyen léger de placer des NPC décoratifs ou interactifs dans un monde de serveur pour des repères du staff, des sélecteurs de lobby, des marchands statiques ou d'autres interactions simples qui ne nécessitent pas de frameworks NPC plus complets.

⚙️ Fonctionnalités

• Crée des NPC qui clonent par défaut la skin du joueur qui les crée.
• Possibilité de spécifier une entité ou un nom de skin pour modifier l'apparence d'un NPC.
• Les NPC persistent entre les redémarrages du serveur en enregistrant les emplacements et les données de skin dans un fichier data.yml.
• Chaque NPC peut afficher un message personnalisé lorsqu'on clique dessus.
• Commandes de base de création et de suppression pour l'administration en jeu.
• Le plugin stocke les données dans un dossier de plugin (NpcMain) et crée data.yml lors du premier lancement.
• Les versions fournies par l'auteur ciblent des versions spécifiques de Minecraft/Spigot (un jar séparé par version de serveur prise en charge).

🧩 À qui s'adresse-t-il

Ce plugin vise les administrateurs de serveurs Spigot de petite à moyenne taille qui ont besoin de NPC simples et persistants sans la complexité de frameworks NPC plus importants. Il convient aux serveurs lobby ou survival qui nécessitent des NPC statiques pour les messages ou une présence cosmétique.

🏗️ Exemples d'utilisation

• Placer un NPC au spawn qui affiche les règles du serveur lorsqu'on clique dessus.
• Créer une statue décorative qui correspond à la skin d'un membre du staff.
• Utiliser des NPC comme sélecteurs nommés et cliquables dans un lobby pour ouvrir des menus (via le message du NPC ou en le combinant avec d'autres plugins).

⌨️ Commandes

(Les commandes ci-dessus sont documentées dans les ressources officielles du plugin.)

⚙️ Installation

📥 Installation

• Téléchargez le jar du plugin adapté à la version de votre serveur Spigot.
• Placez le jar dans le dossier plugins/ du serveur.
• Démarrez ou redémarrez le serveur.
• Au premier chargement, le plugin créera un dossier de plugin (NpcMain) et un fichier data.yml pour stocker les entrées des NPC.

📦 Dépendances

• Aucune dépendance requise n'est documentée par l'auteur.

🧾 Configuration

• Les données des NPC (positions, noms, signatures de skin, messages) sont stockées dans data.yml à l'intérieur du dossier du plugin.
• Modifier data.yml permet de renommer ou de changer le message d'un NPC ; un redémarrage du serveur est nécessaire pour charger les modifications manuelles.

🧠 Notes techniques

• L'auteur publie des builds séparés pour des versions spécifiques de Spigot/Minecraft ; le build actuel du dépôt cible Spigot 1.18.2 et le projet indique que les versions ne sont pas rétrocompatibles entre les grandes versions du serveur.
• Le dépôt du projet est sous licence MIT.
• Le plugin inclut des métriques d'utilisation (bStats), comme l'indiquent les métadonnées du dépôt et de la ressource.

🤝 Quand ce plugin est utile

Si vous avez besoin de NPC simples et persistants qui affichent des messages ou servent de repères cosmétiques/staff sans adopter un framework NPC plus vaste, ce plugin offre une solution petite et ciblée pour les serveurs Spigot.