---
title: "Essentials + extensions"
date: 2012-11-20
author: "Shyndard"
featured_image: "https://minecraft.fr/wp-content/uploads/2012/11/essentials.jpg"
categories:
  - name: "Plugin"
    url: "/categorie/plugin.md"
tags:
  - name: "essentials"
    url: "/tag/essentials.md"
  - name: "minecraft"
    url: "/tag/minecraft.md"
  - name: "plugin"
    url: "/tag/plugin.md"
---

# Essentials + extensions

Dans ce tuto, nous allons parler du plugin **Essentials**, qui comme son nom l’indique, est essentiel à votre serveur Minecraft. Essentials propose 6 parties pour que votre serveur fonctionne avec une bonne configuration. ( Il existe également d’autres extensions telle que essenntialsbuil et bien d’autres ! )

- Essentials.jar –&gt; C’est le fichier java de base. Attention, les extensions que nous allons voir doivent absolument être associée à ce fichier, sans quoi, le plugin ne fonctionnerait pas. Essentials.jar permet de configurer le délai de téléportation, le nombre limite de monstres spawnés en même temps, interdire certains objets, instaurer des règles, mettre des prisons, éditer un message d’accueil lors de votre connexion au serveur, créer des points de téléportations et tant d’autres !

- EssentialsChat.jar –&gt; Extension du plugin essentials.jar. Il vous permet d’éditer votre chat en déplaçant l’ordre de votre pseudo et de vos messages. Exemple :  
    Le format de base étant de &lt;{DISPLAYNAME}&gt; {MESSAGE} , vous pouvez inverser l’ordre {MESSAGE} &lt;{DISPLAYNAME}&gt;, pourquoi pas ? Bon, c’est vrai que cela fera bizarre mais ça peut-être sympa.

- EssentialsProtect.jar –&gt; Extension du plugin essentials.jar. Vous permet de sécuriser automatiquement des blocks que vous posez.

- EssentialsSpawn.jar –&gt; Extension du plugin essentials.jar. Vous permet de créer un point de spawn général et de l’éditer par la suite. Il est également possible de créer plusieurs spawns pour plusieurs groupes, on reverra ça plus bas. Cela prend également en compte la création de session pour les nouveaux joueurs ainsi qu’un message de bienvenue lors de leur première connexion.

- EssentialsGroupManager.jar –&gt; Ce plugin fait partie de l’extension de essentials.jar mais n’est pas dépendant de celui-ci. Cette extension permet de créer des groupes ainsi que leur attribuer des droits/permissions. Cette extension est tellement longue que je ferais un tuto consacré exclusivement à GroupManager.

- EssentialsGroupBridge.jar –&gt; Il faut le mettre ;-)

Passons maintenant à la configuration. Pour cela, extrayez les fichiers .jar de l’archive winrar puis déplacez les dans votre dossier *plugins* de votre serveur puis démarrer le. Une fois cela fait, un nouveau dossier devrait être créé : Essentials. Et là, vous allez me dire qu’il y a beaucoup de choses ! Oui, mais nous allons surtout nous concentrer sur le fichier *config.YML* , vous allez donc l’ouvrir.

**NB : Vous pouvez d’ores et déjà vous connecter à votre serveur et vous pourrez y voir quelques changements.**  
Votre dossier config.YML ressemble à cela :

[![](http://minecraft.fr/wp-content/uploads/2012/11/config2-300x150.png "config")](http://minecraft.fr/wp-content/uploads/2012/11/config2.png)

Et oui, c’est de l’Anglais ! Mais vous allez voir, c’est très simple.  
**NB : Toutes les phrases précédées d’un # ne valent rien, vous pouvez les supprimer, cela n’affectera pas votre configuration mais elles permettent néanmoins de savoir à quoi correspondent les lignes. Il se peut également que je ne cite pas de configuration car ce n’est pas très intéressant.**  
Alors au boulot !

- La première partie de votre fichier config.yml est apellée Notes, cela vous indique juste quelques informations au sujet du plugin et quelques configurations possibles.

- La seconde partie : Essentials (Global)

*ops-name-color: ‘c’* –&gt; Cette ligne indique la couleur du pseudo de la personne qui est administrateur du serveur. (Voir plus bas pour les codes couleur de Minecraft)

*nickname-prefix: ‘~’* –&gt; En changeant le pseudo d’une personne en jeu avec la commande en jeu /nick pseudo nouveaupseudo, ce qui est entre parenthèse se place juste devant son pseudo quand il parle dans le chat..

*change-displayname: true* –&gt; Cette ligne commande si oui ou non la couleur dans le chat de votre serveur est activé. True : oui False : non

*\#change-playerlist: true* –&gt; Cette ligne est précédé d’un # car elle est désactivée par défaut. Pourtant, cela est très pratique : quand vous appuyez sur la touche tabulation dans le jeu, vous pouvez y voir les pseudos en couleurs des personnes connectées.

*teleport-cooldown: 0* –&gt; Délai minimum entre l’accès à la commande /home , /tp, etc…

*teleport-delay: 0* –&gt; Délai minimum avant d’être téléporté.

*item-spawn-blacklist:* –&gt; Mettez-y les ids des items/blocs que vous ne voulez pas voir sur votre serveur

*spawnmob-limit: 10* –&gt; Limite de spawn de monstre à chaque fois pour la commande /spawnmob.

*disabled-commands:*  
*\# – nick* –&gt; Mettez-y toutes les commandes que vous ne voulez pas voir être exécutables sur votre serveur.

*auto-afk: 300* –&gt; Délai d’inactivité avant que le serveur ne vous mette en afk (occupé).

*auto-afk-kick: -1* –&gt; Délai d’afk avant qu’un joueur ne soit kické du serveur. Laissez -1 pour désactiver cette option (ne fonctionne pas sur les administrateurs)

*death-messages: true* –&gt; Lorsqu’un joueur meurt, un message dans le chat est affiché en fonction de la manière dont ce dernier est mort.

*repair-enchanted: true* –&gt; Autorise ou non la réparation et l’enchantement d’objets.

- La troisième partie EssentialsHome

*spawn-if-no-home: true* –&gt; Téléporte au spawn au joueur n’ayant pas de home.  
*update-bed-at-daytime: true* –&gt; Permet à un joueur d’éditer son spawn de lit le jour.  
*sethome-multiple:*  
*default: 3* –&gt; Nombre de home maximum au joueurs par défaut .

- La quatrième partie EssentialsEco

Cette partie permet de faire un système monaitaire sur votre serveur minecraft. Si vous avez l’intention d’installer *Ieconomy*, cela ne vous sera d’aucune utilité.  
*starting-balance: 100* –&gt; Argent que reçoit un joueur lors de sa première connexion au serveur.  
*currency-symbol: ‘$’* –&gt; Signe de votre monnaie sur votre serveur. Par défaut, c’est le $ dollar Américain.  
*max-money: 10000000000000* –&gt; Limite maximum de monnaie par joueur.  
*min-money: -10000* –&gt; Minimum de monnaie que l’on peut avoir. Dans ce genre de cas, vous pouvez cumuler des dettes.

- La cinquième partie EssentialsHelp

*non-ess-in-help: true* –&gt; Autorise les autres plugins à pouvoir mettre leurs commandes dans la liste de la commande /help.

- La sixième partie EssentialsChat

*format: ‘&lt;{DISPLAYNAME}&gt; {MESSAGE}’* –&gt; Format du chat de votre serveur. Vous pouvez changer l’ordre du format et mettre le message avant le pseudo (displayname).

- La septième partie EssentialsProtect

Nous allons rentrer dans une partie de programmation réservée au serveur hébergés ayant une base de donnée MYSQL. Pour les autres, ne touchez à rien, la programmation fonctionnera parfaitement.  
*datatype: ‘sqlite’* –&gt; Type de base de donnée  
*username: ‘root’* –&gt; Identifiant de connexion à votre base de donnée  
*password: ‘root’* –&gt; Mot de passe de connexion.  
*mysqlDb:*  
*‘jdbc:mysql://localhost:3306/minecraft’* –&gt; Adresse de votre base de donnée.

*protect:*  
*signs: true* –&gt; Protège ou non les signs  
*rails: true* –&gt; Protège ou non les rails. Seul la personne ayant posée les rails ou un administrateur pourra les détruire.

*pvp: false* –&gt; Autoriser ou non le PVP entre joueurs.

*drown: false*  
*suffocate: false*  
–&gt; Type de dommages infligés ou non aux joueurs.

Les prochaines configurations traitent des types de dommages acceptés ou non.

*build: true* –&gt; Autorise ou non la construction pour les joueurs pas défauts sur votre serveur

*weather:*  
*storm: false*  
*thunder: false*  
*lightning: false*  
–&gt; Désactiver les types d’intempéries. Laissez false pour les laisser actifs.

- On arrive à la dernière partie : Essentials Spawn / New Players

*announce-format: ‘&amp;dWelcome {DISPLAYNAME}&amp;d to the server!’* –&gt; Format de l’annonce affichée sur le jeu lors de l’arrivée d’un nouveau joueur sur le serveur. Modifiez le avec votre système de couleur Minecraft à la fin de ce tuto. Exemple de format :  
announce-format: ‘&amp;dBienvenue &amp;a{DISPLAYNAME}&amp;d sur Minecraft.fr !’

*kit: tools* –&gt; Kits d’items donnés aux nouveaux joueurs. Par défaut, c’est le kit tools : pelle/pioche/hache/épée

**Nous avons terminé la configuration du fichier config.yml !** YES ! Mais voyons rapidement les autres dossiers.

Le dossier *userdata* regroupe toutes les informations sur les joueurs passés sur votre serveur.

Le dossier *warps*. Mais c’est quoi au juste ? Et bien vous pouvez créer des points de téléportations sur vos mondes et ce dossier les regroupe.

Le fichier *MOTD.txt .* C’est dedans que vous éditez le message d’accueil qui s’affiche aux joueurs lors de leurs connexions au serveur. Vous pouvez utiliser le système de couleurs de Minecraft.

[![](http://minecraft.fr/wp-content/uploads/2012/11/captur10-300x216.jpg "captur10")](http://minecraft.fr/wp-content/uploads/2012/11/captur10.jpg)Code des couleurs



Le fichier *upgrades-done.YML* . Encore quelques configurations de Essentials mais vous n’êtes pas obligé d’y toucher, cela fonctionne parfaitement par défaut.

Le fichier *worth.YML* . Fichier qui pourrait être comparable à une base de donnée, donc, il ne vaut mieux pas y toucher.

# LIENS

[Essentials.jar et de ses extensions](http://tiny.cc/EssentialsExtraZip)  
[ Groupmanager](http://tiny.cc/EssentialsGMZip)

Voilà, j’espère que ce tuto sur la programmation du plugin essentials vous aidera. Très bonne journée à tous !