Parcourir la documentation

Ajouter un mod sur un serveur Minecraft

FreshPerf intègre un explorateur permettant de rechercher et d'installer des mods depuis le panel.

Les mods nécessitent généralement un chargeur compatible tel que Fabric, Forge ou NeoForge.

1. Choisir un serveur compatible avec les mods

Ouvrez l'onglet Versions de votre serveur.

Pour les mods, les choix courants sont :

  • Fabric.
  • Forge.
  • NeoForge.

Le chargeur doit correspondre au mod que vous souhaitez installer.

Un mod Fabric ne fonctionne pas automatiquement avec Forge, et inversement.

2. Arrêter le serveur

Avant toute installation :

  1. cliquez sur Arrêter.
  2. attendez que le serveur soit complètement arrêté.
  3. effectuez une sauvegarde du monde si vous modifiez une installation existante.

3. Ouvrir le catalogue de mods

Dans la barre de navigation :

  1. cliquez sur Mods et plugins.
  2. ouvrez Explorer.
  3. sélectionnez Mods.

Capture d'écran 2026-08-17 221012

FreshPerf permet notamment de rechercher des contenus provenant de :

  • Modrinth.
  • CurseForge.

4. Rechercher le mod

Utilisez la barre :

Rechercher des mods...

Sélectionnez ensuite le mod voulu.

Avant de l'installer, vérifiez :

  • la version Minecraft.
  • le chargeur requis.
  • les éventuelles dépendances.
  • si le mod doit aussi être installé sur le client du joueur.

5. Installer le mod

Depuis la fiche du mod :

  1. choisissez une version compatible.
  2. lancez l'installation.
  3. attendez la fin du téléchargement.
  4. démarrez le serveur.

6. Vérifier le contenu installé

Ouvrez :

Mods et plugins → Installés

Vous pouvez également consulter les fichiers depuis Fichiers.

Selon votre chargeur, les mods sont généralement placés dans :

/mods/

7. Vérifier les logs de démarrage

Après l'installation, ouvrez Console.

Si le serveur ne démarre pas, recherchez des messages tels que :

Missing dependency
Incompatible mod
Unsupported version

Les causes fréquentes sont :

  • une dépendance absente.
  • un mauvais chargeur.
  • une version de Minecraft incorrecte.
  • une version Java incompatible.
  • un mod client installé côté serveur.
  • deux mods incompatibles.

8. Installer le mod côté joueur si nécessaire

De nombreux mods doivent être présents à la fois :

  • sur le serveur.
  • sur le client de chaque joueur.

Les joueurs doivent alors utiliser une configuration compatible avec celle du serveur.

Certains mods, notamment d'optimisation ou d'administration, peuvent être uniquement côté serveur.

Installation manuelle

Si le mod n'est pas disponible dans l'explorateur FreshPerf :

  1. téléchargez le .jar depuis la page officielle du mod.
  2. arrêtez le serveur.
  3. ouvrez Fichiers ou utilisez SFTP.
  4. placez le fichier dans :
/mods/
  1. ajoutez les dépendances nécessaires.
  2. redémarrez le serveur.