Installation de plugins

Apprenez à installer et gérer les plugins sur votre serveur.


title: Installation de plugins description: Apprenez à installer et gérer les plugins sur votre serveur. category: plugins

Installation de plugins

Les plugins permettent d'étendre les fonctionnalités de votre serveur Minecraft. Ce guide vous explique comment installer, configurer et gérer vos plugins sur Stakx.

Qu'est-ce qu'un plugin ?

Un plugin est un module logiciel qui ajoute des fonctionnalités à votre serveur Minecraft :

  • Nouvelles commandes : Téléportation, économie, protection
  • Mécaniques de jeu : Jobs, quêtes, PvP amélioré
  • Gestion : Modération, sauvegarde, statistiques
  • Fun : Mini-jeux, cosmétiques, effets spéciaux

Types de serveur compatibles

Paper/Spigot (Recommandé)

  • Support natif des plugins Bukkit/Spigot
  • Performances optimisées
  • Large écosystème de plugins

Forge

  • Utilise des "mods" plutôt que des plugins
  • Modifications plus profondes du jeu
  • Compatible uniquement avec les clients modifiés

Fabric

  • Système de mods moderne et léger
  • Excellentes performances
  • Écosystème plus restreint

Installation via l'interface Stakx

1. Accéder au gestionnaire de plugins

  1. Connectez-vous à votre tableau de bord Stakx
  2. Sélectionnez votre serveur
  3. Cliquez sur l'onglet "Plugins"
  4. Vous accédez au gestionnaire de plugins intégré

2. Parcourir les plugins disponibles

Le gestionnaire propose plusieurs catégories :

🛡️ Protection et sécurité

  • WorldGuard : Protection des zones
  • CoreProtect : Historique des modifications
  • LuckPerms : Gestion des permissions

🎮 Gameplay

  • EssentialsX : Commandes essentielles
  • Citizens : NPCs intelligents
  • MythicMobs : Créatures personnalisées

🏪 Économie

  • Vault : API économique (requis pour beaucoup de plugins)
  • ChestShop : Magasins automatiques
  • Jobs : Système d'emplois

🎯 PvP et mini-jeux

  • KitPvP : Arènes de combat
  • BedWars : Jeu de destruction de lit
  • SkyWars : Combat en îles flottantes

3. Installer un plugin

  1. Rechercher : Utilisez la barre de recherche
  2. Sélectionner : Cliquez sur le plugin souhaité
  3. Lire : Consultez la description et les prérequis
  4. Installer : Cliquez sur "Installer"
  5. Redémarrer : Le serveur redémarre automatiquement

Installation manuelle

1. Télécharger le plugin

Sources fiables pour télécharger des plugins :

  • SpigotMC (spigotmc.org) - Site officiel
  • Bukkit (dev.bukkit.org) - Site historique
  • GitHub - Plugins open source
  • Modrinth - Plateforme moderne

⚠️ Attention : Évitez les sites non officiels qui peuvent contenir des malwares.

2. Uploader le fichier

  1. Allez dans "Gestionnaire de fichiers"
  2. Naviguez vers le dossier plugins/
  3. Cliquez sur "Upload"
  4. Sélectionnez votre fichier .jar
  5. Redémarrez le serveur

Configuration des plugins

Fichiers de configuration

Chaque plugin crée ses fichiers de configuration dans plugins/<nom_du_plugin>/ :

plugins/
├── EssentialsX/
│   ├── config.yml
│   ├── kits.yml
│   └── worth.yml
├── WorldGuard/
│   ├── config.yml
│   └── worlds/
└── LuckPerms/
    ├── config.yml
    └── storage/

Édition des configurations

  1. Via l'interface : Utilisez l'éditeur de fichiers intégré
  2. Format YAML : Respectez l'indentation (espaces, pas de tabulations)
  3. Sauvegarde : Toujours sauvegarder avant modification
  4. Reload : Utilisez /reload ou redémarrez le serveur

Exemple de configuration

# config.yml d'EssentialsX
# Désactiver certaines fonctionnalités
disable-features:
  - kit
  - mail
  - repair

# Paramètres de téléportation
teleport:
  delay: 3
  cooldown: 60
  safety: true

# Économie de départ
starting-balance: 1000

Plugins essentiels recommandés

1. EssentialsX

Fonctionnalités : Commandes de base, téléportation, économie

/home set <nom>     # Définir un home
/spawn              # Retourner au spawn
/money              # Voir son argent
/kit <nom>          # Récupérer un kit

2. WorldGuard

Fonctionnalités : Protection des zones, gestion des flags

//wand                    # Obtenir l'outil de sélection
//pos1 //pos2            # Sélectionner une zone
/rg define <nom>         # Créer une région
/rg flag <région> pvp deny  # Interdire le PvP

3. LuckPerms

Fonctionnalités : Gestion avancée des permissions

/lp user <joueur> permission set <permission>  # Donner une permission
/lp group create <groupe>                       # Créer un groupe
/lp user <joueur> parent set <groupe>          # Assigner un groupe

4. CoreProtect

Fonctionnalités : Logging et rollback

/co inspect           # Mode inspection
/co lookup u:<joueur> t:1h  # Voir l'historique
/co rollback u:<joueur> t:1h  # Annuler les modifications

Gestion des plugins

Commandes utiles

/plugins              # Lister les plugins actifs
/plugin reload <nom>  # Recharger un plugin
/plugin disable <nom> # Désactiver un plugin
/plugin enable <nom>  # Activer un plugin

Résolution de problèmes

Plugin ne s'active pas

  1. Vérifiez les logs dans la console
  2. Contrôlez les dépendances (autres plugins requis)
  3. Validez la version (compatible avec votre serveur)
  4. Testez les permissions des fichiers

Conflits entre plugins

  1. Identifiez le conflit via les logs d'erreur
  2. Désactivez temporairement un plugin
  3. Consultez la documentation des plugins
  4. Contactez le support si nécessaire

Performance dégradée

  1. Utilisez un profiler comme spark
  2. Identifiez les plugins gourmands
  3. Optimisez les configurations
  4. Supprimez les plugins inutiles

Sécurité des plugins

Vérifications avant installation

  1. Source fiable : Téléchargez uniquement depuis des sites reconnus
  2. Code open source : Préférez les plugins dont le code est visible
  3. Communauté active : Vérifiez les avis et le support
  4. Mises à jour : Assurez-vous que le plugin est maintenu

Permissions des plugins

# Exemple de permissions dans LuckPerms
permissions:
  - essentials.home        # Utiliser /home
  - essentials.sethome     # Définir des homes
  - worldguard.region.info # Voir les infos des régions

Audit régulier

  1. Listez vos plugins mensuellement
  2. Supprimez les inutiles
  3. Mettez à jour vers les dernières versions
  4. Surveillez les alertes de sécurité

Développement de plugins

Prérequis

  • Java (JDK 17+)
  • IDE (IntelliJ IDEA recommandé)
  • Maven/Gradle pour la gestion des dépendances
  • API Spigot/Paper pour le développement

Structure basique

public class MonPlugin extends JavaPlugin {
    @Override
    public void onEnable() {
        getLogger().info("Plugin activé !");
        // Initialisation du plugin
    }
    
    @Override
    public void onDisable() {
        getLogger().info("Plugin désactivé !");
        // Nettoyage
    }
}

Ressources utiles

  • SpigotMC Wiki : Documentation officielle
  • Paper Javadocs : API Paper complète
  • Bukkit Forums : Communauté et aide
  • GitHub : Exemples de plugins open source

Support et dépannage

Logs et débogage

Les logs se trouvent dans logs/latest.log :

# Erreurs courantes
[ERROR]: Could not load 'plugins/MonPlugin.jar'
[WARN]: Plugin MonPlugin is loading before its dependencies
[INFO]: MonPlugin enabled successfully

Ressources d'aide

  1. Documentation Stakx : Guides spécifiques
  2. Discord Stakx : Support communautaire
  3. Forums des plugins : Aide spécialisée
  4. Support technique : Contact direct avec l'équipe

Maintenant que vous maîtrisez l'installation et la gestion des plugins, découvrez comment optimiser les performances de votre serveur !