Tutoriel plugin Minecraft

Créer un plugin Minecraft : la méthode Java et la méthode IA, étape par étape

Un plugin Minecraft est un fichier .jar que votre serveur Paper ou Spigot charge au démarrage. Ce guide détaille les deux façons de le produire : écrire le code Java vous-même, ou décrire le plugin et laisser notre IA l'écrire puis le compiler.

Créer mon plugin avec l'IA Voir les plugins du marketplace

Gratuit pour commencer · Sans carte bancaire

Création d'un plugin Minecraft pour serveur Paper ou Spigot, du code Java au fichier .jar

Deux voies, un même .jar

Java à la main ou IA, le résultat est le même : un .jar à déposer dans plugins/.

Les bases Java expliquées

JDK, Maven, classe principale, plugin.yml, commandes et écouteurs.

Compilation prise en charge

Sur Spaleforce, Maven compile sur nos serveurs et les erreurs sont corrigées automatiquement.

Installation sans mauvaise surprise

Ce qu'il faut vérifier une fois le .jar déposé : /plugins, console, dépendances.

Ce qu'il faut savoir avant de créer un plugin Minecraft

Un plugin n'est pas un mod : il s'exécute côté serveur, et les joueurs se connectent avec un client Minecraft Java normal. Il repose sur l'API Bukkit, enrichie par Spigot, Paper et les dérivés de Paper (Purpur, Pufferfish, Leaf, Folia).

Il réagit à des événements (connexion, bloc cassé, mort), ajoute des commandes et lit un fichier de configuration. Première décision : la version de Minecraft visée. Un plugin écrit pour une API récente peut appeler des méthodes absentes d'une version plus ancienne ; fixez la cible avant la première ligne et testez sur cette version.

Comment créer un plugin Minecraft en Java : la voie classique

Installez un JDK adapté : Java 17 pour Minecraft 1.18 à 1.20.4, Java 21 à partir de 1.20.5 ; pour les versions 26.x, suivez la version exigée par votre serveur. Ajoutez un IDE, par exemple IntelliJ IDEA, et créez un projet Maven ou Gradle.

Déclarez l'API Paper (paper-api) ou Spigot en dépendance « provided », avec son dépôt Maven : le serveur fournit déjà ces classes. La classe principale étend JavaPlugin et redéfinit onEnable() et onDisable().

Le plugin.yml, dans les ressources, donne le nom (name), la version (version), la classe principale (main) et la version d'API (api-version), puis déclare commandes (commands) et permissions (permissions). Ensuite :

Commandes : une classe CommandExecutor, rattachée dans onEnable() à la commande de plugin.yml.
Écouteurs : une classe Listener dont les méthodes portent @EventHandler, enregistrée par getServer().getPluginManager().registerEvents(...).
Configuration : un config.yml dans les ressources, copié par saveDefaultConfig() ; absent du .jar, l'appel échoue au démarrage.
Compilation : mvn package produit le .jar dans target/ (Gradle : build/libs/).

Faire un plugin Minecraft avec l'IA : ce qui change

Sur Spaleforce, une description remplace le code. Notre IA rédige plugin.yml, classe principale, commandes, écouteurs et config.yml ; Maven compile sur nos serveurs et, en cas d'échec, les erreurs repartent vers l'IA qui corrige avant de livrer le .jar.

L'IA n'emploie pas d'API plus récente que la version choisie et compile avec le bon niveau de Java, deux sources d'erreurs fréquentes en voie classique.

Vault, PlaceholderAPI, WorldEdit ou PlotSquared sont résolus automatiquement à la compilation. L'éditeur en ligne affiche les fichiers, vous demandez des changements en langage naturel et chaque version reste dans l'historique.

Tuto : installer le plugin Minecraft sur votre serveur

Arrêtez le serveur, copiez le .jar dans le dossier plugins/, puis redémarrez. Évitez /reload : le rechargement à chaud laisse souvent tâches et écouteurs dans un état incohérent.

La console indique le chargement ou l'erreur qui l'empêche. En jeu, /plugins liste les plugins : vert s'il est actif, rouge s'il est désactivé. logs/latest.log garde la trace complète.

Causes fréquentes d'échec : une dépendance absente (Vault ou PlaceholderAPI doivent être installés, et Vault seul ne gère pas l'argent sans plugin d'économie), ou une version de serveur différente de la cible.

Au premier lancement, le plugin crée plugins/<NomDuPlugin>/ et son config.yml : modifiez les valeurs, puis redémarrez.

Java à la main ou IA : quelle méthode choisir ?

La voie Java reste la bonne si vous voulez apprendre le développement, maintenir un gros projet sur plusieurs années ou travailler à plusieurs sur le même code. Prévoyez le temps d'installer les outils, de comprendre Maven et de parcourir la documentation de l'API.

La voie IA convient quand l'objectif est un plugin qui tourne sur votre serveur : kits, message de bienvenue, protection de zone, mini-jeu simple. Vous obtenez un .jar compilé sans installer de JDK ni d'IDE.

Les deux se combinent : générer une première version, l'essayer sur un serveur de test lancé depuis l'éditeur, puis l'affiner par petites demandes. Le code affiché dans l'éditeur sert aussi de support pour comprendre l'organisation d'un plugin avant de passer à Java.

Comment ça marche

1
Choisissez la cible
Sélectionnez le type de serveur (Paper, Purpur, Spigot, Folia…) et la version de Minecraft, de 1.16 à 26.3.
2
Décrivez le plugin
Commandes, permissions, messages et valeurs de configuration : plus la description est précise, plus le plugin correspond à votre besoin.
3
Laissez compiler
Notre IA écrit le code, Maven le compile sur nos serveurs et les erreurs éventuelles sont corrigées automatiquement.
4
Testez et téléchargez
Essayez le plugin sur un serveur de test depuis l'éditeur, ajustez-le si besoin, puis téléchargez le .jar.

Idées de premier plugin à copier-coller

Message de bienvenue

Plugin Paper 1.21.4 : à la première connexion d'un joueur, afficher le titre « Bienvenue {joueur} » et lui donner un pain et une épée en pierre ; ensuite, un simple message dans le chat. Textes dans config.yml.

Point de spawn

Plugin Spigot 1.20.4 : /setspawn (permission monserveur.setspawn) enregistre la position dans config.yml ; /spawn téléporte après 3 secondes, annulé si le joueur bouge.

Kit de départ avec délai

Plugin Paper 1.21.1 : /kit debut donne une armure en fer et 16 steaks, une fois par 24 heures par joueur, avec le temps restant affiché. Objets et délai dans config.yml.

Annonces automatiques

Plugin Purpur 1.21.4 : toutes les 10 minutes, diffuser un message tiré d'une liste de config.yml (codes couleur &). /annonces reload (permission annonces.admin) relit la configuration.

Protection du spawn

Plugin Paper 26.1.2 : interdire de casser ou poser des blocs à moins de 50 blocs du spawn du monde principal, sauf permission spawn.bypass, avec un avertissement. Rayon dans config.yml.

Questions fréquentes

Faut-il savoir coder en Java pour créer un plugin Minecraft ?

Pour la voie classique, oui : il faut connaître les bases de Java et de l'API Bukkit ou Paper. Avec Spaleforce, non : vous décrivez le plugin en français, notre IA écrit le code et le compile.

Quelle version de Java faut-il pour un plugin Minecraft ?

Java 17 pour 1.18 à 1.20.4, Java 21 à partir de 1.20.5 ; pour 26.x, celle exigée par votre serveur. Sur Spaleforce, le niveau de Java est choisi automatiquement.

Où placer le fichier .jar d'un plugin ?

Dans le dossier plugins/ du serveur, pendant que celui-ci est arrêté. Au redémarrage, le plugin se charge et crée son propre dossier de configuration ; vérifiez ensuite avec /plugins qu'il apparaît en vert.

Quelles versions de Minecraft et quels serveurs sont pris en charge ?

Minecraft Java de 1.16 à 26.3 (dont 1.21 à 1.21.11, 26.1.1, 26.1.2, 26.2 et 26.3), pour Paper, Purpur, Pufferfish, Leaf, Folia, Spigot et Bukkit. Les versions 1.8 à 1.15 ne sont pas proposées.

Pourquoi mon plugin ne se charge-t-il pas ?

Consultez la console ou logs/latest.log au démarrage. Les causes les plus fréquentes sont une dépendance manquante (Vault, PlaceholderAPI…), une version de serveur différente de la cible, ou un plugin compilé pour une version de Java plus récente que celle du serveur.

Est-ce gratuit ?

Oui pour commencer, sans carte bancaire : 5 générations ou modifications par jour, 2 h d'attente entre deux générations. Pro (20 €/mois) et Ultimate (50 €/mois) relèvent ces quotas.

Puis-je utiliser le plugin sur un serveur commercial ?

Avec Pro ou Ultimate, oui : le plugin ne contient aucune mention Spaleforce et l'usage commercial est autorisé, sans redevance. En gratuit, la mention « Powered by Spaleforce » intégrée au plugin doit être conservée.

Outils et guides associés

Générateur de plugins Minecraft Générateur de plugin Minecraft IA gratuit Créer un plugin Minecraft sans coder Comment créer un plugin Minecraft (guide 2026)Tester un plugin Minecraft en ligne Idées de plugin Minecraft : 42 idées pour 2026

Créez votre premier plugin Minecraft maintenant

Choisissez la version de votre serveur, décrivez ce que le plugin doit faire et récupérez un .jar compilé à déposer dans plugins/. Gratuit pour commencer, sans carte bancaire.

Créer mon plugin avec l'IA

Mis à jour le 17 septembre 2026