Aller au contenu
Fichiers et contenus

Installer un plugin ou un mod

Déposer un .jar dans le bon dossier, redémarrer, vérifier qu'il se charge — et quoi faire s'il casse tout.

Dernière mise à jour : 1er août 2026

Vérifie d'abord ton type de serveur

Un serveur Minecraft ne charge des extensions que si son logiciel le prévoit :

Ton serveurExtensions acceptéesDossier
Paper, Spigot, Bukkit, PurpurPluginsplugins
Forge, Fabric, NeoForgeModsmods
VanillaAucune
Si tu es en Vanilla et que tu veux des plugins, il faut changer de type de serveur : voir Changer la version ou le type de serveur. Un mod Forge ne fonctionnera jamais sur un serveur Paper, et inversement.

Installer le fichier

  1. Télécharge le .jar depuis le site officiel du plugin, en prenant bien la version qui correspond à celle de ton serveur.
  2. Sur la fiche du serveur, onglet Console, clique sur Arrêter et attends l'état Hors ligne.
  3. Clique sur Fichiers en haut de la fiche.
  4. Ouvre le dossier plugins (ou mods). S'il n'existe pas, crée-le : champ Nouveau dossier puis bouton Créer.
  5. Dépose le .jar dans la zone Envoyer un fichier et clique sur Envoyer. Pour un fichier volumineux avec un lien direct, utilise plutôt les champs https://... et nom.ext suivis de Télécharger.
  6. Reviens sur la fiche du serveur et clique sur Démarrer.
  7. Surveille la console : le plugin annonce son chargement (par exemple Enabling MonPlugin v1.2).
Ne renomme jamais un plugin en .jar.jar ou sans extension : il sera ignoré en silence.

Configurer le plugin

La plupart des plugins créent leur configuration au premier démarrage, dans plugins/NomDuPlugin/config.yml. Il faut donc démarrer une première fois avant de pouvoir régler quoi que ce soit.

  1. Arrêter le serveur.
  2. Fichiers, puis ouvre plugins et le dossier du plugin.
  3. Éditer le fichier, modifie, puis Sauvegarder.
  4. Démarrer.
Les fichiers .yml sont sensibles à l'indentation : uniquement des espaces, jamais de tabulation. Une seule tabulation empêche le plugin — et parfois le serveur entier — de démarrer.

Installer plusieurs mods (modpack)

  • Un modpack est un lot de .jar à déposer dans mods. Tous doivent viser la même version du jeu et le même chargeur (Forge ou Fabric).
  • Les modpacks pèsent souvent plus que la limite d'envoi du navigateur : passe par le SFTP.
  • Un modpack demande beaucoup de RAM. Surveille la tuile Mémoire de la console et, au besoin, augmente la RAM depuis la page Configurer ou par ticket.

Le serveur ne démarre plus après l'ajout

  1. Ouvre l'onglet Console et cherche le nom du fichier fautif après ERROR ou Caused by:.
  2. Fichiers, dossier plugins ou mods, bouton Supprimer sur ce fichier.
  3. Démarrer. Si le serveur repart, le coupable est identifié : cherche une version compatible.

Le détail des autres causes est dans Mon serveur ne démarre pas.

À lire aussi

Ça ne résout pas ton problème ?

Ouvre un ticket en précisant le nom de ton serveur, le message d'erreur exact et ce que tu as déjà essayé.

Ouvrir un ticket
← Toute la documentation