Comment créer un plugin Minecraft

Étape par étape

1. 1.Choisir le logiciel serveur et la version

   Les plugins tournent sur des serveurs basés sur Bukkit : Spigot, Paper ou Folia (BungeeCord et Velocity pour les proxys). Choisissez la version de Minecraft de votre serveur, de la 1.8 à la 26.x.

2. 2.Décrire ce que fait le plugin

   Écrivez les commandes, les permissions, ce qui se passe en jeu et ce qui doit être configurable. Exemple : « /sethome, /home et /delhome, 3 homes max par joueur, 3 secondes de délai, messages dans config.yml ».

3. 3.Laisser Codexe l'écrire et le compiler

   Codexe écrit les classes Java, plugin.yml, config.yml et pom.xml, lance un vrai build et corrige les erreurs de compilation avant de déclarer le projet prêt.

4. 4.Le tester sur un vrai serveur

   Appuyez sur Tester maintenant pour rejoindre un serveur Minecraft privé avec le plugin installé. Les joueurs de test de Codexe exécutent chaque commande et vérifient ce que vous avez demandé.

5. 5.Télécharger et installer le .jar

   Téléchargez le .jar compilé, placez-le dans le dossier plugins/ de votre serveur et redémarrez le serveur. Les fichiers de configuration apparaissent dans plugins/<PluginName>/.

Ce qu'est un plugin Minecraft

Un plugin est un fichier .jar qu'un serveur Minecraft charge depuis son dossier plugins/. Il ajoute des commandes, des règles de jeu, des économies, des mini-jeux ou n'importe quoi d'autre, uniquement côté serveur : les joueurs se connectent avec le jeu normal, sans mods.

Les plugins sont écrits en Java (ou Kotlin) avec l'API du serveur : Spigot et Paper pour les serveurs de jeu, BungeeCord ou Velocity pour les proxys. Un plugin a aussi besoin d'un fichier plugin.yml qui indique au serveur son nom, sa classe principale, ses commandes et ses permissions.

La voie manuelle : Java, Maven et l'API Spigot ou Paper

C'est plus long à apprendre mais cela donne un contrôle total. Codexe produit le même type de projet : vous pouvez donc partir d'un plugin généré et continuer à la main.

1. Installez un JDK (Java 21 pour 1.20.5 à 1.21.x, Java 25 pour 26.x) et un IDE comme IntelliJ IDEA.
2. Créez un projet Maven ou Gradle et ajoutez la dépendance paper-api ou spigot-api pour votre version, avec la portée provided.
3. Écrivez une classe principale qui étend JavaPlugin, avec onEnable() et onDisable().
4. Ajoutez plugin.yml dans src/main/resources avec name, version, main, api-version et vos commandes.
5. Enregistrez les commandes avec getCommand("name").setExecutor(...) et les écouteurs avec getServer().getPluginManager().registerEvents(...).
6. Compilez avec mvn package, copiez le .jar depuis target/ dans le dossier plugins/ d'un serveur de test et redémarrez.

Questions