Plugin Minecraft Citizens

🔌 À propos de Citizens

Citizens est un plugin Minecraft qui fournit un système complet pour créer et gérer des NPC côté serveur. Il prend en charge de nombreux types de NPC (semblables à des joueurs, mobs, marchands, gardes, statues) et expose une API afin que d'autres plugins et du code personnalisé puissent ajouter des comportements, des traits et des intégrations.

🎯 Objectif

Citizens répond au besoin de personnages non-joueurs persistants et configurables sur un serveur : les NPC peuvent servir de marchands interactifs, d'acteurs scénarisés, de gardes qui suivent des waypoints, de bornes d'information ou de statues décoratives. Le plugin est utilisé à la fois par les propriétaires de serveurs pour créer des fonctionnalités de gameplay et par les développeurs pour étendre les fonctionnalités via l'API Citizens.

⚙️ Fonctionnalités

• Créer et supprimer des NPC avec des commandes en jeu.
• Plusieurs types de NPC (joueur, basés sur des mobs, villageois, etc.).
• Attribuer des commandes ou des actions scriptées aux NPC (déclencheurs au clic/à l'exécution, attaches de commandes).
• Waypoints et comportement de patrouille pour les NPC en déplacement.
• Traits et éditeurs pour personnaliser le comportement et l'apparence des NPC.
• Modèles et persistance pour que les NPC survivent aux redémarrages.
• API développeur pour les addons, traits et intégrations.

🧩 Pour qui

• Les propriétaires de serveurs qui veulent des NPC interactifs pour des boutiques, des guides ou le décor.
• Les développeurs de plugins qui ont besoin d'une API NPC pour créer des intégrations ou des mini-jeux.
• Les serveurs communautaires qui nécessitent des personnages non-joueurs décoratifs ou fonctionnels.

🏗️ Cas d'utilisation exemples

• Un serveur Survival utilise des marchands NPC pour échanger des objets sans plugin d'économie.
• Un serveur RPG script des NPC pour proposer des quêtes et des dialogues.
• Un admin place des gardes NPC en patrouille qui suivent des waypoints autour d'une ville.
• Les développeurs attachent des traits personnalisés aux NPC pour des interactions de mini-jeux.

⌨️ Commandes

(Note : /npc expose de nombreuses sous-commandes et des nœuds de permission plus précis pour des fonctionnalités spécifiques ; consultez la documentation du plugin pour la liste complète des commandes.)

🔐 Permissions

(Il existe de nombreux autres nœuds de permission pour des commandes et traits spécifiques ; la documentation des permissions du plugin les répertorie en détail.)

⚙️ Installation

📥 Installation

• Téléchargez le JAR officiel du plugin Citizens depuis la distribution officielle du projet (catalogue de plugins ou téléchargements du projet).
• Placez le JAR dans le dossier plugins/ de votre serveur sur un serveur compatible Spigot ou Paper.
• Redémarrez le serveur et vérifiez la console pour confirmer que Citizens s'est chargé et a créé ses répertoires de données.

📦 Dépendances

• Aucune dépendance externe requise n'est सूचीée par défaut. Citizens est souvent étendu par des addons optionnels (addons tiers ou autres plugins), mais aucun n'est obligatoire pour le fonctionnement de base.

🧠 Notes techniques

• Citizens fournit une API orientée développeurs afin que d'autres plugins puissent créer des traits, interagir avec des NPC et accrocher des événements de NPC.
• Le plugin stocke les données des NPC de manière persistante afin qu'ils restent après les redémarrages et prend en charge les traits/éditeurs pour la personnalisation à l'exécution.
• La documentation officielle et un wiki communautaire couvrent les commandes, permissions, traits, éditeurs et points d'intégration.

🤝 Quand ce plugin est utile

Si vous avez besoin de NPC durables et scriptables, ainsi que d'une API pour intégrer des personnages non-joueurs dans le gameplay ou les systèmes du serveur, Citizens fournit la gestion centrale des NPC, la persistance et les points d'extension nécessaires aux administrateurs de serveurs comme aux développeurs de plugins.