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
- Connectez-vous à votre tableau de bord Stakx
- Sélectionnez votre serveur
- Cliquez sur l'onglet "Plugins"
- 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
- Rechercher : Utilisez la barre de recherche
- Sélectionner : Cliquez sur le plugin souhaité
- Lire : Consultez la description et les prérequis
- Installer : Cliquez sur "Installer"
- 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
- Allez dans "Gestionnaire de fichiers"
- Naviguez vers le dossier
plugins/
- Cliquez sur "Upload"
- Sélectionnez votre fichier
.jar
- 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
- Via l'interface : Utilisez l'éditeur de fichiers intégré
- Format YAML : Respectez l'indentation (espaces, pas de tabulations)
- Sauvegarde : Toujours sauvegarder avant modification
- 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
- Vérifiez les logs dans la console
- Contrôlez les dépendances (autres plugins requis)
- Validez la version (compatible avec votre serveur)
- Testez les permissions des fichiers
Conflits entre plugins
- Identifiez le conflit via les logs d'erreur
- Désactivez temporairement un plugin
- Consultez la documentation des plugins
- Contactez le support si nécessaire
Performance dégradée
- Utilisez un profiler comme spark
- Identifiez les plugins gourmands
- Optimisez les configurations
- Supprimez les plugins inutiles
Sécurité des plugins
Vérifications avant installation
- Source fiable : Téléchargez uniquement depuis des sites reconnus
- Code open source : Préférez les plugins dont le code est visible
- Communauté active : Vérifiez les avis et le support
- 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
- Listez vos plugins mensuellement
- Supprimez les inutiles
- Mettez à jour vers les dernières versions
- 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
- Documentation Stakx : Guides spécifiques
- Discord Stakx : Support communautaire
- Forums des plugins : Aide spécialisée
- 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 !