Plugin Minecraft FancyNpcs

🔌 À propos de FancyNpcs

FancyNpcs est un plugin Minecraft permettant de créer et de gérer des personnages non joueurs (NPCs) à l'aide de packets. Il vise les serveurs Paper et Folia et propose une alternative basée sur les packets aux plugins de NPCs reposant sur des entités. Le plugin se concentre sur une apparence et des interactions configurables tout en réduisant au minimum la charge liée aux entités côté serveur.

🎯 Objectif

FancyNpcs est destiné aux administrateurs de serveur qui ont besoin de NPCs légers et personnalisables pour des affichages cosmétiques, des kiosques interactifs ou des interactions scriptées, sans générer de vraies entités serveur complètes. Il résout le problème des implémentations lourdes de NPCs grâce à un rendu côté client via packets et à un système d'actions documenté.

⚙️ Fonctionnalités

• Créez, copiez, supprimez et listez des NPCs en jeu via une seule commande /npc.
• NPCs de type joueur et de type mob avec skins personnalisables (nom d'utilisateur, UUID, URL ou fichier local) et prise en charge du modèle slim.
• Emplacements d'équipement : casque, plastron, jambières, bottes, configuration de la main principale et de la main secondaire.
• Effet lumineux avec couleurs configurables et visibilité facultative dans la liste des joueurs pour les NPCs de type joueur.
• Noms d'affichage compatibles avec MiniMessage, PlaceholderAPI et MiniPlaceholders.
• Système d'actions avec déclencheurs et plusieurs types d'action (add, remove, list, reorder, clear) pour un comportement interactif.
• Contrôles de position et de rotation, commandes de déplacement/téléportation, et comportement de "se tourner vers le joueur" basé sur la distance.
• Prise en charge de la taille/échelle dans les versions récentes de Minecraft lorsqu'elle est disponible.
• Le plugin expose une API pour la création et la gestion programmatiques des NPCs.

🧩 Pour qui c'est fait

• Les serveurs Survival et SMP qui veulent des NPCs cosmétiques ou interactifs sans ajouter de charge d'entités.
• Les réseaux ou lobbys qui ont besoin de NPCs légers pour les menus, boutiques ou points d'information.
• Les développeurs qui souhaitent intégrer la création de NPCs via une API fournie.

🏗️ Exemples d'utilisation

• Un serveur hub crée des NPCs stationnaires avec des skins personnalisés qui affichent des informations lorsqu'on clique dessus.
• Un serveur RPG utilise des NPCs avec des actions scriptées pour guider les joueurs ou déclencher des commandes et des messages.
• Un plugin de développement enregistre des NPCs à l'exécution à l'aide de l'API FancyNpcs.

⌨️ Commandes

🔐 Permissions

⚙️ Installation

📥 Installation

• Téléchargez le fichier JAR du plugin FancyNpcs depuis une page de distribution prise en charge.
• Placez le JAR dans le dossier plugins/ de votre serveur.
• Redémarrez le serveur et vérifiez la console pour confirmer que le plugin a bien été chargé.

📦 Dépendances

• FancyNpcs est conçu pour les logiciels de serveur Paper et Folia et nécessite Paper pour fonctionner. L'auteur indique que le plugin ne requiert pas de dépendances externes supplémentaires.

🧾 Configuration

• Le plugin fournit des commandes en jeu pour la plupart des tâches ; les fichiers de configuration et le comportement du plugin sont documentés dans la documentation officielle.

🧠 Notes techniques

• Logiciels de serveur pris en charge confirmés : Paper et Folia.
• FancyNpcs utilise un rendu basé sur les packets pour présenter les NPCs aux clients plutôt que de faire apparaître des entités persistantes côté serveur.
• Le projet expose une API Java pour l'intégration ainsi que la création et l'enregistrement programmatiques de NPCs.
• L'auteur collecte des métriques d'utilisation anonymes avec une option de désactivation ; les détails de la collecte de données sont documentés par le projet.

🤝 Quand ce plugin est utile

Si vous avez besoin de NPCs rendus côté client avec une apparence flexible et des interactions scriptées tout en gardant une faible charge d'entités serveur, FancyNpcs fournit une solution basée sur les packets avec gestion en jeu et une API pour les intégrations.