Installer des plugins et des mods

Un serveur Minecraft nu fait peu de choses : pas de grades, pas de protection de constructions, pas de minijeux. Tout cela s’ajoute sous forme de plugins ou de mods. Cette page explique comment les installer depuis panel.cloudfive.xyz, et surtout comment retrouver le fautif quand le serveur ne démarre plus.

Elle suppose un serveur déjà en place : si ce n’est pas le cas, voyez Installer un serveur Minecraft.

Différence entre plugin et mod

Les deux ajoutent des fonctions, mais ils ne s’installent pas au même endroit et n’exigent pas la même chose de vos joueurs.

	Plugin	Mod
Moteur requis	Paper, Purpur (dérivés de Bukkit)	Forge, NeoForge, Fabric
Dossier	plugins/	mods/
Côté joueur	rien à installer	le même chargeur et les mêmes mods, presque toujours
Modifie le jeu	commandes, permissions, règles	blocs, objets, dimensions, mécaniques

Un plugin se greffe sur le serveur sans toucher au jeu : vos joueurs se connectent avec un client Minecraft normal. C’est ce qu’il faut pour un serveur public — grades, protection de zones, économie, anti-triche, boutique.

Un mod modifie le jeu lui-même. Il ajoute du contenu que le client doit connaître : vos joueurs devront installer la même liste. C’est ce qu’il faut pour jouer à un modpack.

Attention

Les deux ne cohabitent pas. Un serveur Paper ignore le dossier mods/, un serveur Fabric ignore le dossier plugins/. Le choix se fait au niveau du moteur : voir Versions, Paper, Forge et Fabric.

Où télécharger des fichiers fiables

Un plugin ou un mod est un fichier .jar : du code qui s’exécute sur votre serveur, avec accès à vos fichiers et à votre base de données. La provenance n’est pas un détail.

Les dépôts de référence :

• Modrinth — plugins et mods, pour Paper comme pour Fabric et NeoForge.
• Hangar, le dépôt publié par l’équipe de PaperMC — plugins.
• SpigotMC — le catalogue historique de plugins, très large.
• CurseForge — mods et modpacks, surtout Forge et NeoForge.
• La page de publication du projet elle-même, quand l’auteur distribue depuis son propre dépôt de code.

Trois réflexes avant de télécharger :

1. Vérifiez la version annoncée : un plugin « 1.20 » sur un serveur 1.21 ne se chargera peut-être pas.
2. Regardez la date de dernière mise à jour : un projet abandonné cassera à la prochaine montée de version.
3. Lisez les dépendances : beaucoup de plugins exigent un second plugin, de type bibliothèque, pour démarrer.

Danger

N’installez jamais un .jar reçu par message privé, trouvé sur un site de redistribution de plugins payants, ou proposé en « version débloquée ». Ces fichiers contiennent régulièrement de quoi voler vos accès. Vous êtes responsable de ce qui tourne sur votre serveur, et une instance compromise finit signalée à abuse@cloudfive.xyz.

Installer et charger un plugin

1. Téléchargez le fichier .jar du plugin depuis un dépôt de confiance, dans la version qui correspond à celle de votre serveur.

2. Arrêtez le serveur depuis le panel (Démarrer, arrêter et redémarrer). On n’ajoute pas un plugin à chaud.

3. Ouvrez le gestionnaire de fichiers (guide) et entrez dans le dossier plugins/. Créez-le s’il n’existe pas.

4. Envoyez le .jar dans ce dossier, sans le renommer ni le décompresser. Pour plusieurs fichiers, le SFTP est plus confortable (Accéder à son serveur en SFTP).

5. Démarrez le serveur en gardant la console ouverte (Console et logs).

6. Cherchez dans la console la ligne d’activation du plugin, du type Enabling MonPlugin v2.1.0. Puis, en jeu ou dans la console, tapez plugins : le plugin doit apparaître en vert dans la liste.

Un plugin en rouge dans cette liste est installé mais désactivé : la console vous dit pourquoi, quelques lignes après son chargement.

Un seul à la fois

Installez vos plugins un par un, en redémarrant entre chaque. C’est plus long de dix minutes, et cela vous évite une soirée à chercher lequel des huit nouveaux fichiers a cassé le serveur.

Installer un mod côté serveur

La procédure est la même, avec le dossier mods/ au lieu de plugins/ — et une contrainte supplémentaire.

1. Assurez-vous que le serveur tourne bien sur le chargeur attendu par le mod : Forge, NeoForge ou Fabric, dans la bonne version du jeu.

2. Arrêtez le serveur et sauvegardez-le (Sauvegardes du serveur de jeu). Un mod de contenu écrit dans votre monde : son retrait laisse des trous.

3. Déposez les .jar dans mods/. Ajoutez les dépendances exigées — sur Fabric, la plupart des mods réclament Fabric API.

4. Démarrez et suivez la console. Un chargeur de mods énumère ce qu’il charge, et nomme précisément ce qui manque.

5. Distribuez à vos joueurs la même liste de mods et le même chargeur. Sans cela, ils seront refusés à la connexion.

Certains mods sont uniquement côté serveur — typiquement les mods d’optimisation. Leur page le précise ; dans ce cas, vos joueurs n’ont rien à faire.

Note

Un mod qui a besoin d’un port supplémentaire, comme une passerelle pour joueurs Bedrock, demande une allocation en plus de celle du jeu. Voyez Ports et allocations, et au besoin demandez-la par ticket.

Configurer un plugin après premier démarrage

Un plugin n’a pas de configuration avant d’avoir démarré une fois : c’est lui qui crée ses fichiers. D’où l’ordre à respecter.

• Répertoireplugins/

  • MonPlugin.jar
  • RépertoireMonPlugin/ créé au premier démarrage

    • config.yml
    • messages.yml
    • Répertoiredata/

      • …

1. Démarrez le serveur une fois avec le plugin installé, puis arrêtez-le. Le dossier de configuration existe maintenant.

2. Ouvrez plugins/MonPlugin/config.yml dans l’éditeur du panel et modifiez les valeurs utiles. Les commentaires du fichier expliquent la plupart des clés.

3. Enregistrez, puis redémarrez le serveur pour appliquer.

4. Vérifiez en jeu. Si la commande du plugin répond « permission refusée », c’est normal : il reste à vous donner les droits.

Ces fichiers sont en YAML. Trois règles suffisent : l’indentation se fait avec des espaces, jamais de tabulations ; « oui » et « non » s’écrivent true et false ; une valeur contenant un deux-points se met entre guillemets.

Pour les droits, deux approches : les opérateurs, qui donnent tout (Whitelist et opérateurs), et un plugin de permissions, qui donne des grades fins. Si votre plugin stocke des données, il peut demander une base MySQL : voir Créer et gérer une base de données.

Attention

Après une mise à jour d’un plugin, relisez son config.yml. Les nouvelles clés ne sont pas toujours ajoutées à un fichier existant, et une clé absente est remplacée par une valeur par défaut qui n’est pas forcément celle que vous voulez.

Diagnostiquer un conflit ou un crash

La console dit presque toujours la vérité. Encore faut-il la lire dans le bon sens.

1. Rouvrez la console et remontez jusqu’à la première erreur, pas la dernière. Les suivantes sont souvent des conséquences.

2. Cherchez la ligne commençant par Caused by : c’est la cause réelle. Le nom du plugin ou du mod responsable apparaît juste autour, dans le chemin de la classe.

3. Si la console est trop courte, ouvrez logs/latest.log, et crash-reports/ sur un serveur modé.

4. Quand rien ne ressort, procédez par moitiés : sortez la moitié de vos .jar du dossier, redémarrez, recommencez sur la moitié fautive. Trois ou quatre essais suffisent.

5. Le fautif identifié, cherchez s’il existe en version plus récente avant de le remplacer.

Quelques messages qui reviennent souvent :

Dans la console	Ce que ça veut dire
Unsupported API version	le plugin est trop ancien pour votre version du jeu
Could not load ... missing dependency	une dépendance n’est pas installée
UnsupportedClassVersionError	la version de Java ne correspond pas au fichier
A single server tick took ... seconds	un plugin ou un mod bloque le serveur ; voir Améliorer les performances
Ambiguous plugin name	deux .jar du même plugin sont présents

Danger

Ne retirez pas un mod de contenu d’un monde déjà joué sans sauvegarde. Les blocs et les objets qu’il apportait disparaissent, et les zones concernées peuvent devenir illisibles. Sauvegardez d’abord, retirez ensuite.

Si ça ne marche pas

Le plugin n’apparaît pas dans la liste. Le fichier n’est pas au bon endroit : il doit être directement dans plugins/, pas dans un sous-dossier, et porter l’extension .jar. Un .zip téléchargé par erreur ne sera jamais chargé.

Le serveur boucle au démarrage, ou rame depuis l’ajout. Arrêtez-le depuis le panel, sortez le dernier .jar ajouté, redémarrez. Si le ralenti persiste sans lui, le problème est ailleurs : Améliorer les performances.

Les joueurs sont déconnectés à l’entrée sur un serveur modé. Chargeur, version et liste de mods doivent être identiques des deux côtés. Un seul mod en trop côté serveur suffit à refuser tout le monde.

Vous êtes bloqué. Collez les vingt lignes de console autour de la première erreur dans un ticket de support, avec le moteur, la version et le nom du fichier concerné. Le Discord CloudFive sert pour un avis rapide, le ticket laisse une trace.