Parcourir la documentation

Ajouter un plugin sur un serveur Minecraft

FreshPerf permet de rechercher et d'installer des plugins directement depuis le panel pour les logiciels serveur compatibles.

Les plugins sont principalement utilisés avec des serveurs tels que Paper, Spigot, Purpur et d'autres logiciels compatibles Bukkit.


1. Vérifier le type de serveur

Ouvrez votre serveur Minecraft, puis cliquez sur Versions.

FreshPerf affiche les différents logiciels serveur disponibles.

Pour utiliser des plugins Bukkit, choisissez un logiciel compatible, par exemple :

  • Paper.
  • Spigot.
  • Purpur.

Un serveur Vanilla ne charge pas les plugins Bukkit.

Si vous changez de type de serveur, arrêtez d'abord le serveur et sauvegardez vos données.


2. Arrêter le serveur

Avant d'installer ou de retirer un plugin, cliquez sur Arrêter et attendez que le statut indique Arrêté.

Cela évite les problèmes de fichiers en cours d'utilisation.


3. Ouvrir le catalogue de plugins

Dans votre serveur :

  1. cliquez sur Mods et plugins.
  2. ouvrez Explorer.
  3. choisissez Plugins.

Vous accédez au moteur de recherche intégré.

Capture d'écran 2026-08-17 220906

Le catalogue peut regrouper plusieurs sources, notamment :

  • Modrinth.
  • CurseForge.
  • Hangar.
  • SpigotMC.

4. Rechercher un plugin

Utilisez la barre :

Rechercher des plugins...

Vous pouvez filtrer les résultats par source.

Cliquez ensuite sur le plugin souhaité afin d'ouvrir sa fiche et de choisir une version compatible avec votre serveur.


5. Installer le plugin

Depuis la fiche du plugin :

  1. choisissez une version compatible.
  2. lancez l'installation.
  3. attendez la confirmation.
  4. redémarrez ensuite le serveur.

FreshPerf place le plugin dans l'emplacement approprié pour votre logiciel serveur.


6. Vérifier les plugins installés

Dans Mods et plugins, ouvrez l'onglet Installés.

Cette page affiche les mods et plugins actuellement présents sur votre serveur.

Vous pouvez également vérifier manuellement le dossier :

/plugins/

depuis l'onglet Fichiers.


7. Configurer le plugin

Après le premier démarrage, de nombreux plugins créent leur propre dossier dans :

/plugins/NomDuPlugin/

Vous pouvez y trouver des fichiers tels que :

config.yml
messages.yml

Pour éviter les conflits :

  1. arrêtez le serveur.
  2. modifiez les fichiers souhaités.
  3. enregistrez.
  4. redémarrez le serveur.

8. Vérifier la console

Ouvrez Console après le redémarrage.

Recherchez des erreurs liées au nom du plugin.

Un plugin peut ne pas se charger si :

  • sa version est incompatible.
  • une dépendance est manquante.
  • le serveur n'utilise pas un logiciel compatible.
  • la version de Java n'est pas adaptée.

Installation manuelle

Si un plugin n'est pas proposé dans le catalogue FreshPerf :

  1. téléchargez son fichier .jar depuis une source officielle ou reconnue.
  2. arrêtez le serveur.
  3. ouvrez Fichiers ou connectez-vous en SFTP.
  4. placez le .jar dans :
/plugins/
  1. redémarrez le serveur.

Ne décompressez pas le fichier .jar.