Guide

Comment créer un plugin Paper

Mis à jour le 7 octobre 2026

Paper est le logiciel de serveur Minecraft le plus utilisé pour les plugins : il exécute les plugins Spigot et ajoute par-dessus une API plus large et plus rapide. Un plugin Paper est un projet Java (ou Kotlin) compilé avec paper-api. Voici ce qu'il faut, à la main ou avec une IA qui le compile pour vous.

Un exemple pour commencer.

Générer ceci avec Codexe

Étape par étape

  1. 1.Choisir la version de Minecraft

    Utilisez la version de votre serveur. Elle détermine la version de Java : Java 17 avant la 1.20.5, Java 21 à partir de la 1.20.5, Java 25 pour la 26.x.

  2. 2.Créer le projet

    Un projet Gradle ou Maven avec la dépendance paper-api pour cette version, depuis le dépôt PaperMC, dans la portée provided/compileOnly.

  3. 3.Écrire la classe principale

    Une classe qui étend JavaPlugin, avec onEnable() pour enregistrer les commandes et les écouteurs.

  4. 4.Décrire le plugin au serveur

    plugin.yml (name, version, main, api-version, commands, permissions). Paper prend aussi en charge paper-plugin.yml, avec ses propres règles de chargement.

  5. 5.Compiler et tester

    Compilez le .jar, placez-le dans le dossier plugins/ d'un serveur de test Paper, démarrez-le et vérifiez les erreurs dans la console.

Paper ou Spigot ?

Le code écrit pour l'API Spigot fonctionne sur Paper, mais pas l'inverse : Paper ajoute des événements et des méthodes (par exemple les composants de texte Adventure et de nombreuses API asynchrones) que Spigot n'a pas. Écrivez pour Paper si votre serveur tourne sous Paper ; écrivez pour Spigot si le plugin doit aussi fonctionner sur des serveurs Spigot.

La voie rapide

Sur Codexe, choisissez un plugin Bukkit/Spigot/Paper, écrivez « Paper » et la version dans la demande, puis décrivez ce qu'il fait. Codexe configure le projet et la bonne version de Java, le compile, corrige les erreurs de build et vous laisse rejoindre un serveur de test Paper avec le plugin installé.

Problèmes courants

  • UnsupportedClassVersionError : le plugin a été compilé avec une version de Java plus récente que celle du serveur.
  • NoSuchMethodError / NoClassDefFoundError : le plugin utilise une API qui n'existe pas dans la version du serveur, ou une dépendance n'a pas été intégrée (shade) dans le .jar.
  • Le plugin se charge mais les commandes ne font rien : la commande est absente de plugin.yml ou l'exécuteur n'est pas enregistré.

Questions

Les plugins Paper fonctionnent-ils sur Purpur ou Folia ?

Purpur est un fork de Paper, donc les plugins Paper y fonctionnent. Folia change la gestion des threads : un plugin doit être écrit pour son planificateur par région pour tourner sur Folia.

Puis-je écrire un plugin Paper en Kotlin ?

Oui. Codexe peut générer un projet Gradle Kotlin avec build.gradle.kts pour la même API Paper.

Créez un plugin Paper maintenant

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

“Un plugin Paper 1.21.4 appelé Bounties : /bounty set <player> <amount> avec l'économie Vault, le tueur reçoit la récompense, /bounty list affiche le top 10, les primes sont conservées après les redémarrages, messages dans config.yml.”

Générer ceci avec Codexe
Comment créer un plugin Paper (Minecraft) | Codexe