Aller au contenu

Guide pas à pas

Comment installer un plugin sur un serveur Minecraft

Place le fichier .jar du plugin dans le dossier plugins de ton serveur, puis redémarre-le. En local (Paper, Spigot, Bukkit), copie le .jar dans plugins et relance le serveur. Chez un hébergeur qui donne accès aux fichiers, passe par son gestionnaire de fichiers, puis redémarre. Aternos n'accepte que les plugins de son catalogue : un .jar généré par Minax n'y passe pas.

Installer un plugin Minecraft tient en quelques étapes, toujours les mêmes. Ce guide couvre l'installation sur serveur local (PaperMC, Spigot, Bukkit), chez un hébergeur qui donne accès aux fichiers (Apex, OMGServ, BisectHosting), et ce qu'Aternos accepte ou refuse.

  • .jar uniquement : pas de mods (les mods, c'est Forge et Fabric)
  • Fonctionne sur Paper, Spigot, Bukkit et leurs forks
  • Aucune ligne de commande nécessaire
  • Serveur local, ou hébergeur qui accepte tes propres plugins

Étape 1 : vérifier que ton serveur accepte les plugins

Les plugins .jar ne fonctionnent que sur des serveurs basés sur l'API Bukkit : Paper, Spigot, Bukkit, Purpur, Folia. Si tu utilises Minecraft vanilla, Forge ou Fabric, il te faut des mods, pas des plugins.

  • Paper / Purpur : recommandé, performances optimales
  • Spigot : stable, compatibilité maximale
  • Bukkit : historique, encore supporté
  • Forge / Fabric : pas de plugins, des mods .jar dans /mods

Étape 2 : télécharger le .jar

Télécharge le fichier directement depuis Minax (bouton Télécharger sur la page du plugin) ou depuis SpigotMC, Modrinth ou GitHub Releases. Vérifie la version de Minecraft annoncée : un plugin Paper 1.21 ne tournera pas en 1.8.

Étape 3 : déposer le plugin dans le bon dossier

Sur un serveur local : place le .jar dans le dossier plugins/ à côté de spigot.jar ou paper.jar. Si le dossier n'existe pas, lance le serveur une fois pour qu'il se crée.

Chez un hébergeur qui donne accès aux fichiers (Apex, BisectHosting, OMGServ, et bien d'autres) : utilise le gestionnaire de fichiers du panneau ou un client FTP comme FileZilla. Le chemin est généralement /plugins.

Sur Aternos, c'est différent : il n'installe que les plugins de son catalogue et refuse ceux que tu téléverses toi-même. Un plugin fabriqué par Minax n'y passe donc pas. Pour ton propre plugin, prends ton PC, un hébergeur qui donne accès aux fichiers, ou exaroton, l'offre payante de l'équipe d'Aternos, qui l'accepte.

Étape 4 : redémarrer le serveur

Un /reload déstabilise souvent les plugins déjà en place (tâches orphelines, fuites de mémoire, état incohérent). Coupe complètement le serveur, relance-le, puis regarde la console : tu dois y voir [MonPlugin] Enabled.

Résoudre les erreurs classiques

Si le plugin ne charge pas, la console affiche presque toujours la cause :

  • Could not load 'plugins/X.jar' : version de Minecraft / Java incompatible
  • UnsupportedClassVersionError : ton Java est trop ancien (Java 21 pour la 1.21, Java 25 pour la 26.x)
  • Plugin already initialized : un autre plugin a le même nom, supprime le doublon
  • NoClassDefFoundError : un plugin dépendant manque (Vault, PlaceholderAPI, etc.)

Questions fréquentes

Combien de plugins peut-on installer sur un serveur Minecraft ?

Techniquement plusieurs centaines. En pratique, 20 à 50 plugins bien choisis tournent sans problème sur Paper. Surveille le TPS avec /tps.

Comment supprimer un plugin proprement ?

Arrête le serveur, supprime le .jar du dossier plugins/, supprime si tu veux le dossier plugins/MonPlugin/ qui contient ses réglages, puis redémarre.

Puis-je installer des plugins sur Aternos ?

Seulement ceux de son catalogue. Aternos refuse les plugins que tu téléverses toi-même, pour des raisons de sécurité : un plugin fabriqué par Minax n'y passe donc pas. Pour ton propre plugin, il te faut ton PC, un hébergeur qui donne accès aux fichiers du serveur, ou exaroton, l'offre payante de l'équipe d'Aternos, qui l'accepte.

Mon plugin demande Vault ou PlaceholderAPI, où les trouver ?

Ce sont des plugins gratuits qui s'installent de la même manière. Télécharge-les sur SpigotMC et dépose-les avant celui qui en a besoin.

Prêt à créer ton plugin Minecraft ?

Description en français, .jar compilé, sans une ligne de Java. Le compte est gratuit. Crédits payés une fois, sans abonnement : 50 crédits à 17,99 € TVA incluse.

Trouver un plugin sur Minax