Nous voici dans le vif du sujet ! Commençons par ce qui est trivial, c’est-à-dire les outils.

Qu’est-ce qu’il nous faut ?

• Une machine avec de la RAM, 3Go est une bonne valeur sous Windows Seven;
• Créer un dossier C:/dev. L’endroit importe peu mais je vais prendre ceci comme référence.
• Le kit de développement Java (JDK) disponible à ici !

Pour rappel ou pour information, les programmes Java s’exécutent au travers d’une machine virtuelle. C’est donc pour cela que vous avez du installer Java (JRE) sur votre machine pour jouir de Minecraft. Maintenant, vous avez besoin, pour le développement  non seulement de la machine virtuelle (JRE) mais également d’outils (le compilateur, de la documentation, etc) qui permettent la réalisation de programmes Java (JDK). Donc hopla on prend le JDK qui inclut le JRE également.

Aller sur le site, sélectionner le JDK correspondant à votre architecture (32 ou 64bit) et téléchargez-le. Une fois téléchargé il suffit de l’exécuter et de suivre les étapes. Attention toutefois à remémorer le dossier de l’installation. Classiquement dans Program Files/Java.

• D’un éditeur de code, attention, suspense : Eclipse disponible ici !

Actuellement, programmer avec un simple éditeur de texte comme NotePad ou même NotePad++ est vraiment anti-productif et fastidieux. Un éditeur comme Eclipse, Netbeans, IntelliJ est vital pour votre santé ! Eclipse s’impose dans beaucoup de domaines et à défaut d’être le plus accessible, on va dire que c’est un classique. Voilà pourquoi, vous allez installer Eclipse.

Sur le site, aller sur la page de téléchargement et choisir « Eclipse Classic » ou « Eclipse IDE for Java Developers ». Là encore, vous devez choisir votre architecture : 32 ou 64bit. Une fois téléchargé, vous vous rendez compte que c’est une archive Zip. Donc pas d’installation automatisée, il suffit de décompresser le tout dans le dossier C:/dev.

• Télécharger la dernière version stable de Bukkit ici.

Le lien que je vous fournis n’est pas la page principale de Bukkit mais permet d’avoir une vue d’ensemble sur les versions actuelles et celles en cours de développement. Maintenant vous vous en fichez un poil mais dans le futur, lorsque vous serrez un as de la programmation de plugins, c’est bien utile pour suivre l’évolution de Bukkit.

Télécharger la version STABLE ! Pas la dernière version en développement ! La raison est simplement derrière le mot stable. Cela ne sert à rien de développer sur une version non stable si vous n’utilisez pas la dernière nouveauté ne se trouvant pas dans la version stable.

Vous allez avoir un fichier .jar. Placez le dans C:/dev/server.

Premier lancement d’Eclipse et création d’un premier projet

Au premier lancement Eclipse vous demande le dossier Workspace. C’est votre répertoire où seront enregistrés vos projets. Placez le dans C:/dev/workspace et n’oubliez pas de cocher la case en bas afin de ne pas avoir à le redéfinir à chaque fois.

Vous arrivez donc sur l’interface d’Eclipse, un peu rébarbative. Créons enfin ce projet ! Aller dans File -> New -> Java Project. Lui donner un nom, cliquer sur Next et ajouter la librairie Bukkit. Pour ce faire, aller dans l’onglet Libraries et cliquez sur Add External Jar sur la droite. Ensuite sélectionner simplement le fichier .jar précédemment téléchargé.

Création d’un Hello World

• Création du package de base.

Un package est un dossier où sont stockés des classes Java (entre autre). Par convention, un package s’écrit toujours en minuscule ! Par convention toujours, un programme/plugin Java doit se démarquer des autres par un package unique. Le nommage standard est de mettre le nom de votre domaine à l’envers suivi du nom du projet. Ici ce sera com.wtcraft.tutorial. Respectez bien les conventions, cela vous facilitera la vie si un jour vous décider de publier votre plugin.

Clic droit sur src -> new -> package. Entrer com.wtcraft.tutorial et Finish.

• Création du plugin.yml

Lorsque Bukkit recherche les plugins dans le dossier… euh… plugins, il recherche les fichiers .jar (qui sont des Zip) et, plus précisément, il recherche le fichier plugin.yml. Ce fichier renseigne donc Bukkit sur votre plugin et particulièrement son nom, sa version et (surtout) la classe Java principal !

Clic droit sur src -> new -> File et entrer le nom plugin.yml. Vous devez sans doute avoir déjà eu affaire à des fichiers YAML dans votre vie d’administrateur de serveurs Minecraft. La syntaxe n’a donc rien de sorcier. Il faut renseigner name, version et main au minimum.

• Création du point d’entrée du plugin

Récapitulons, Bukkit, au lancement parcours le fichier plugins. Chaque .jar contenant un plugin.yml est analysé. Il va instancier la classe référencée par main, le point d’entrée. Dans notre cas com.wtcraft.tutorial.Tutorial. Cette classe doit hériter de la classe JavaPlugin de Bukkit. Nous allons donc créer une classe Java Tutorial.

Clic droit sur com.wtcraft.tutorial -> new -> Class. Donner à la classe le nom de Tutorial et ensuite la faire hériter de JavaPlugin. Dans le champ Superclass, clic sur Browse… et écrivez le début de JavaPlugin. Si Bukkit est bien dans votre librairie, la recherche sera fructueuse. Sinon, retournez à l’étape précédente de création de projet.

• Réaliser le plugin

Lors de la création de la classe, vous avez déjà la structure de base du plugin avec les méthodes onEnable et onDisable. Il ne faut pas être anglophobe lorsque l’on programme… onEnable s’exécutera au lancement du plugin et onDisable lors de la fermeture. L’article est déjà bien long et donc on va se contenter de lui ajouter un « Hello world ».

Ecrire les deux lignes de code pour écrire en console.

• Exporter le plugin

Vous venez de finir votre premier plugin ! Vous ne me croyez pas ? Et bien pourtant, il suffit de ça. Maintenant il faut le compiler et l’inclure dans un fichier .jar pour pouvoir l’exécuter sur son serveur. Eclipse vous mâche le boulot et s’occupe de tout, quasiment.

File -> Export -> JAR File. Ensuite, Next et sélectionner le répertoire plugins du serveur. Entrer un nom, ici Tutorial.jar.

• Enjoy

Vous venez de compiler votre premier plugin. Maintenant lancez le serveur et vous allez voir « Hello World » écrit sur la console et « Bye bye ! » lorsque vous stoppez Bukkit.

Ceci conclu le premier Tutoriel. J’espère que les explications ont été assez claires. Les utilisateurs avancés n’auront sans doute aucun besoin de suivre ce tutoriel. Ceux n’ayant que peu de connaissances serront peut-être un peu perdu lorsque les mots classe, hériter et package surviennent. Si vous désirez une petite leçon sur l’orienté objet et Java en général n’hésitez pas et je m’attèlerais à la tâche pour vous pondre quelque chose d’assez didactique.