Guide

Comment créer un plugin Spigot

Mis à jour le 7 octobre 2026

Un plugin Spigot utilise l'API Bukkit/Spigot, donc il fonctionne sur Spigot et sur tous ses forks, Paper compris. C'est ce qui en fait le choix le plus large quand vous ne savez pas où le plugin tournera. Ce guide couvre le projet, le code et le build.

Adaptez l'exemple à votre serveur.

Générer ceci avec Codexe

Étape par étape

  1. 1.Installer Java et un outil de build

    Installez le JDK qui correspond à votre version de Minecraft (17, 21 ou 25) et utilisez Maven ou Gradle.

  2. 2.Ajouter l'API Spigot

    Ajoutez spigot-api pour votre version, depuis le dépôt Spigot, avec la portée provided. Elle n'est nécessaire que pour compiler ; le serveur la fournit à l'exécution.

  3. 3.Écrire les commandes et les écouteurs

    Enregistrez un CommandExecutor avec getCommand("name").setExecutor(...) et les écouteurs d'événements avec registerEvents.

  4. 4.Écrire plugin.yml

    Nom, version, classe principale, api-version (à partir de la 1.13), commandes et permissions.

  5. 5.Compiler et installer

    mvn package, puis copiez le .jar depuis target/ vers le dossier plugins/ du serveur et redémarrez.

Anciennes versions (1.8 à 1.12)

Beaucoup de serveurs de mini-jeux tournent encore en 1.8. L'API est plus ancienne (pas de api-version, noms de matériaux différents), donc un plugin doit être écrit pour cette version, et non copié depuis un tutoriel 1.21. Codexe demande la version et écrit le code pour cette API.

Avec Codexe

Décrivez le plugin et dites « Spigot » avec la version. Codexe génère le projet Maven, le compile, corrige les erreurs et vous laisse le tester sur un serveur de test de cette version avant de le télécharger.

Questions

Ai-je besoin de BuildTools ?

Seulement pour faire tourner un serveur Spigot ou pour utiliser NMS (code interne du serveur). Pour compiler avec l'API normale, la dépendance spigot-api suffit.

Plugin Spigot ou plugin Paper ?

Spigot s'il doit fonctionner partout ; Paper si votre serveur tourne sous Paper et que vous voulez son API supplémentaire. Voir comment créer un plugin Paper.

Créer un plugin Spigot

Ce prompt s'ouvre prêt à être envoyé :

“Un plugin Spigot 1.8.8 appelé Kits : /kit <name> donne un ensemble d'objets configurable avec un délai d'attente par kit, kits définis dans config.yml, permission kits.<name> par kit, délais conservés après les redémarrages.”

Générer ceci avec Codexe
Comment créer un plugin Spigot : configuration, code, build | Codexe