Citizens

Créez des PNJ (personnages non joueurs) qui ressemblent à des joueurs, avec dialogues, trajets de déplacement et intégration aux quêtes. La base des serveurs RPG.

RPG et PNJ SpigotPaperPurpur

À propos de Citizens

Citizens est un plugin pour créer et gérer des PNJ (personnages non-joueurs) sur un serveur Minecraft. Les PNJ ressemblent à de vrais joueurs (avec le skin de votre choix), mais c'est le serveur qui les contrôle. Ils peuvent rester sur place, suivre des trajets définis, tenir des conversations, échanger avec les joueurs et jouer un rôle dans des quêtes. Citizens est la base des serveurs RPG et MMO. Les PNJ peuvent avoir différents rôles : marchand (vend et achète des objets), garde (attaque les mobs hostiles), guide (mène les joueurs le long d'un itinéraire) ou donneur de quêtes (distribue des quêtes).

Le plugin est modulaire. Citizens seul vous donne la création de PNJ et les trajets de déplacement. Denizen (un plugin distinct) ajoute des scripts avancés, des dialogues et des mécaniques de quêtes. Citizens s'intègre aussi à Sentinel (des PNJ gardes ou combattants) et à BetonQuest (un système de quêtes).

Citizens fait partie des plugins RPG incontournables à envisager pour votre serveur Minecraft. Il prend en charge Minecraft 1.8.8 - 1.21.x et fonctionne sur Spigot, Paper et Purpur.

Fonctionnalités de Citizens

Voici les principales fonctionnalités que Citizens ajoute à votre serveur. Vous pouvez configurer chacune d'elles dans le fichier de configuration du plugin.

PNJ avec n'importe quelle skin
Trajets de déplacement (waypoints)
Intégration de Denizen (dialogues)
Différents types de PNJ (marchand, garde)
Sentinel (PNJ de combat)
Prend en charge plus de 20 types d'entités

Commandes de Citizens

Voici les 6 commandes les plus importantes de Citizens. Vous trouverez la liste complète dans la documentation officielle. Gardez en tête que vous pouvez bloquer ou autoriser n'importe quelle commande grâce à un système de permissions (par exemple LuckPerms).

Commande	Description	Permission
`/npc create [nom]`	Crée un nouveau PNJ	`citizens.npc.create`
`/npc skin [joueur]`	Donne au PNJ le skin d'un compte de joueur	`citizens.npc.skin`
`/npc select`	Sélectionne un PNJ (faites un clic droit dessus)	`citizens.npc.select`
`/npc remove`	Supprime le PNJ sélectionné	`citizens.npc.remove`
`/npc tphere`	Téléporte le PNJ vers vous	`citizens.npc.tphere`
`/npc lookclose`	Fait regarder le PNJ vers le joueur le plus proche	`citizens.npc.lookclose`

Astuce : utilisez l'autocomplétion dans la console du serveur (la touche Tab) pour voir les arguments qu'une commande accepte. Sur un serveur avec LuckPerms, attribuez les permissions à des groupes, pas à des joueurs individuels.

Permissions

Le système de permissions vous permet de contrôler qui peut utiliser chaque fonctionnalité de Citizens. Vous accordez les permissions via un plugin de grades tel que LuckPerms (/lp group [groupe] permission set [nœud] true). La colonne « OP par défaut » indique si les opérateurs du serveur ont la permission sans aucune configuration.

Nœud de permission	Description	OP par défaut
`citizens.npc.create`	Création de PNJ	Oui
`citizens.npc.edit`	Modification de PNJ	Oui
`citizens.npc.remove`	Suppression de PNJ	Oui

Configuration de Citizens

Au premier lancement, Citizens génère un fichier de configuration dans le dossier plugins/Citizens/. Voici les options les plus importantes, avec des commentaires. La liste complète des paramètres se trouve dans la documentation officielle.

# config.yml de Citizens
npc:
  default:
    look-close:
      enabled: false       # Par défaut, les PNJ ne regardent pas les joueurs
      range: 5             # Portée du regard
    pathfinding:
      enabled: true
      attack-range: 1.75   # Portée d'attaque des gardes
  max-npcs-per-player: 10  # Limite de PNJ par joueur

Après avoir modifié la configuration, enregistrez le fichier et utilisez une commande de rechargement (par exemple /reload ou la commande de rechargement propre au plugin). Si le plugin ne prend pas en compte les changements après un rechargement, redémarrez le serveur : arrêtez-le avec /stop puis relancez-le.

Le YAML ne pardonne rien. Une seule espace ou tabulation de travers peut casser tout le fichier. Utilisez un éditeur avec coloration syntaxique (VS Code, Notepad++) et vérifiez le fichier sur yamllint.com avant de l'envoyer sur le serveur.

Comment installer Citizens

Téléchargez Citizens depuis le site officiel. Vérifiez que la version est compatible avec votre version de Minecraft (1.8.8 - 1.21.x).
Copiez le fichier .jar téléchargé dans le dossier plugins/ du répertoire de votre serveur.
Arrêtez le serveur avec /stop et relancez-le. N'utilisez pas /reload pour une première installation.
Consultez la console du serveur. Si Citizens s'est chargé correctement, vous verrez un message indiquant la version du plugin. En cas d'erreur, vérifiez que toutes les dépendances sont installées.
Configurez le plugin en modifiant plugins/Citizens/config.yml (ou son équivalent). Après vos modifications, utilisez la commande de rechargement.

Compatibilité serveur : Citizens fonctionne sur Spigot, Paper et Purpur. Nous recommandons Paper comme moteur de serveur : il offre de meilleures performances et plus d'API que Spigot.

Alternatives à Citizens

Citizens n'est pas le seul plugin de sa catégorie. Voici des alternatives à envisager si vous cherchez autre chose ou si Citizens ne répond pas à vos besoins.

FancyNPCs

Une alternative plus légère, avec une approche minimaliste de la création de PNJ.

ZNPCsPlus

Un plugin de PNJ moderne basé sur les paquets, qui fonctionne sans ProtocolLib.

Questions fréquentes sur Citizens

Comment installer Citizens ?

Téléchargez Citizens depuis le serveur CI officiel. Placez le .jar dans plugins/ et redémarrez le serveur. Créez des PNJ avec la commande /npc create [nom]. Pour les dialogues et les quêtes, installez Denizen ou BetonQuest. Vous trouverez des instructions détaillées, avec les dépendances et la configuration, dans la section d'installation ci-dessus.

Sur quels moteurs de serveur Citizens fonctionne-t-il ?

Citizens fonctionne sur : Spigot, Paper, Purpur. Nous recommandons Paper comme moteur : pour la plupart des serveurs, c'est le meilleur équilibre entre performances et compatibilité avec les plugins. Vous en saurez plus sur les moteurs de serveur dans notre comparatif.

Citizens est-il gratuit ?

Citizens est disponible sur son site officiel. Consultez les détails de la licence sur la page de téléchargement.

Citizens ne fonctionne pas. Que faire ?

Consultez le fichier logs/latest.log dans le dossier de votre serveur. Les causes d'erreur les plus fréquentes sont : (1) une dépendance manquante, (2) une version de Minecraft incompatible (vérifiez que la version de votre serveur est comprise dans 1.8.8 - 1.21.x), (3) une erreur dans config.yml (vérifiez le formatage YAML), (4) un conflit avec un autre plugin qui fait la même chose.

Puis-je utiliser Citizens sur un serveur Bedrock ?

Non. Citizens est un plugin pour l'édition Java et fonctionne sur les serveurs Spigot/Paper/Purpur. L'édition Bedrock utilise un autre système (les packs de comportement). Si vous voulez réunir joueurs Java et Bedrock sur un même serveur, regardez du côté de Geyser.