Citizens est un plugin pour vos serveurs Bukkit. Il permet de créer des PNJs (personnages non joueurs) qui peuvent parler, vendre, acheter, téléporter, avoir un skin et surement encore d'autres fonctions.

Chaque PNJ peut obtenir une armure ou autres objets. Ce plugin est idéal pour tout type de serveur utilisant Bukkit.

Installation

Nécessite pour ce tutoriel le plugin Permissions et un plugin d'économie tel que iConomy.

Commencez par télécharger le fichier citizens.jar depuis ce lien de la documentation officielle.

Une fois téléchargé pensez à arrêter votre serveur puis installez votre plugin dans le dossier plugins.

Un dossier Citizens doit apparaître, si ce n'est pas le cas démarrez votre serveur puis ré-arrêtez le.

Configuration Citizens

Ce plugin permet diverses possibilités, je vais vous faire part de celles que je connais actuellement, je ne connais pas toutes les fonctionnalités de ce plugin encore.

Nous allons configurer de façon simple l'économie utilisée par les Pnjs et le plugin en lui même.

Ouvrez le dossier du plugin Citizens, il y a plusieurs fichiers .yml ceux qui vont nous intéresser sont economy.yml et citizens.yml.

economy.yml

Ce fichier vous permet de configurer la partie économique du plugin (en sachant qu'il faut avoir instaurer une économie au préalable sur votre serveur).

economy:
use-econplugin: true Si vous utilisez un plugin d'économie mettre true sinon false.
use-economy: true Si vous voulez utilisez l'économie, mettre true sinon false.

Ces deux lignes sont la base de l'utilisation de l'économie, je n'ai jamais testé une économie autre que monnétaire, je ferais donc selon mon expérience.

Si vous pensez que vous n'utiliserez pas de PNJ spéciaux tel que des réparateurs d'armure, ou d'armes, des soigneurs ou des "sorciers" pour la mana alors laissez la configuration comme telle et sauvegardez votre fichier puis remplacez celui déjà existant et allez jusqu'au prochain point du tutoriel citizens.yml.

Vous pouvez configurer l'échange de monnaie contre un service pour chaque type de PNJ, je vais donner un exemple pour un PNJ qui répare l'armure :

armorrepair:
item:
diamond: 5 Pour réparer un item en diamand, le joueur devra 5 pièces d'or
gold: 2 Pour un item en or, 2 pièces d'or
leather: 1 Ainsi de suite ....
iron: 4
chainmail: 3
econplugin:
diamond: 1.25
gold: 0.5
leather: 0.25
iron: 1
chainmail: 0.75
item-currency-id: 37
Il y a encore bien d'autres types de PNJ a configurer, je vous laisse le faire de vous même, si vous avez des questions j'y répondrais dans les commentaires.

Citizens.yml

Là nous allons configurer de manière simple le plugin en général. Je me base également sur mon expérience personnelle.

Je ne me pencherais pas sur les premières lignes du fichier ne les ayant pas testées, cependant elles servent à la configuration de la régénération que donnent les PNJs principalement.

On arrive donc à la configuration générale du plugin :

general:
    defaults:
        enable-following: true Le pnj vous suit des yeux (tourne sur lui même et bouge la tête)
        talk-when-close: false Le pnj vous parle dès que vous l'approchez si valeur true.
        debug-mode: false ? Je ne sais pas a quoi sert cette option
healers:
    pay-for-heal: true Payer le Pnj pour être soigner, si false le joueur n'aura pas besoin.
    regen-health: true Une pour peut-être permettre aux pnjs healeurs de soigner?
colors:
    use-npc-colours: true Utiliser la couleur pour le nom des pnjs
    npc-colour: f f représente le blanc je pense, vous pouvez utiliser sinon de 1 à 9
wizards:
    regen-mana: true Alors ici si il y a de la "mana" je suppose, donc un plugin
    max-mana: 100 La quantité de mana
    wizard-max-locations: 10 ? Peut-être le nombre maximum de joueurs utilisant la regen
    notify-updates: true Notification de mise à jour, je n'en sais pas plus
chat:
    slashes-to-spaces: true
    selection-message: You selected (ID ).
    default-text: Hello.;How are you today?;Having a nice day?;Good weather today.;Stop hitting me!;I'm bored.;
    creation-message: The NPC was born!
    format: '[%name%]: '

Le chat des pnjs, vous pouvez changez leur phrase d'origine et la phrase lors de leur création.

selection:
    quick-select: false
    use-bukkit-permissions: false
Ici quick-select c'est pour sélection facile mais je n'ai pas testé et use-bukkit-permissions c'est si vous avez le plugin surement?

Les permissions

Voici la liste des permissions du plugin (pour un plugin de permissions).

Pour les utilisateurs

citizens.use.trader

trader = vendeur donc ici les utilisateurs ont le droit d'acheter, de vendre à un vendeur mais également je suppose d'utiliser la monnaie selon le type de vendeur (réparateur,soigneur,etc...). trader peut être remplacer par un autre type de PNJ.

Pour les admins/ modérateurs

Pour les admins, voir modérateurs enfin pour le groupe que vous voulez :)

citizens.create.healer

Permission de créer un soigneur, vous pouvez changer par un autre type de PNJ.

citizens.modify.wizard

Possibilité de modifier (ici pour un "sorcier") le fait qu'ils parlent dès qu'on approche ou non, la couleur, etc... vous pouvez évidemment remplacer wizard par un autre type de pnj.

citizens.admin

Pour avoir accès à toutes les commandes, et donc avoir toutes les permissions sur le plugin.

Les commandes in-game

Voici les commandes in-game: http://citizens.wikia.com/wiki/Commands

Tutoriel vidéo: utiliser le plugin