Contexte
Vous souhaitez ajouter de nouvelles fonctionnalités à votre serveur Minecraft Bedrock sous PowerNukkitX (PNX) (comme des systèmes d'économie, des mini-jeux ou des outils d'administration) ?
Le panel Winheberg intègre un Plugins HUB PNX, une bibliothèque simplifiée qui vous permet de rechercher et d'installer des plugins en quelques clics, sans avoir besoin de télécharger des fichiers manuellement ni de les transférer via FTP.
Prérequis
- Un serveur PowerNukkitX Winheberg
- Quelques minutes pour arrêter puis redémarrer le serveur
Étapes d'installation
Voici comment utiliser le catalogue intégré pour ajouter un plugin à votre serveur.
1. Arrêter le serveur et accéder au Hub
Pour éviter toute corruption de données ou erreur de chargement, vous devez éteindre votre serveur avant d'installer un nouveau plugin.
- Connectez-vous à votre panel Winheberg et accédez à votre serveur.
- Depuis l'onglet Console, cliquez sur le bouton rouge Stop pour arrêter le serveur.
- Une fois le serveur hors ligne, regardez dans le menu de gauche. Sous la section CONFIGURATION, cliquez sur Plugins HUB PNX.
2. Rechercher et sélectionner un plugin
Vous voici maintenant dans le catalogue des plugins disponibles pour PowerNukkitX.
- Parcourez la liste ou utilisez la barre de recherche (Search query) et le filtre par catégorie (Category) pour trouver le plugin dont vous avez besoin (ex : AnyVersion, LuckPerms, WorldManager...).
- Cliquez sur l'icône de téléchargement (la flèche pointant vers le bas) située à droite du cadre du plugin que vous souhaitez installer.
3. Installer la version souhaitée
Une fenêtre contextuelle (popup) s'ouvre avec la description détaillée du plugin. Lisez attentivement ces informations, car elles contiennent souvent des instructions importantes ou des prérequis.
- Dans le menu déroulant Plugin version, sélectionnez la version que vous souhaitez installer (il est généralement recommandé de laisser la version la plus récente par défaut).
- Cliquez sur le bouton rouge Install plugin en bas de la fenêtre.
Le panel se charge automatiquement de télécharger le plugin et de le placer dans le bon dossier de votre serveur.
4. Redémarrer le serveur
- Retournez dans l'onglet Console.
- Cliquez sur Start pour démarrer le serveur.
- Observez les logs de la console, vous devriez voir un message indiquant que votre nouveau plugin a bien été chargé et activé.
En cas de problème
❌ Le plugin n'apparaît pas ou ne fonctionne pas en jeu
- Incompatibilité de version : Vérifiez dans la console si un message d'erreur rouge apparaît lors du démarrage. Le plugin installé n'est peut-être pas compatible avec votre version actuelle de PowerNukkitX.
- Dépendance manquante : Certains plugins nécessitent un autre plugin pour fonctionner (par exemple, un plugin de chat peut nécessiter PlaceholderAPI). Lisez bien la description dans le HUB.
❌ Le serveur crash après l'installation
Si le serveur refuse de démarrer après l'ajout d'un plugin, c'est que celui-ci provoque une erreur fatale.
- Allez dans l'onglet Files (Fichiers) du panel.
- Ouvrez le dossier
plugins. - Cochez le fichier
.jardu plugin problématique et supprimez-le (bouton Delete). - Redémarrez le serveur.
Bonnes pratiques
- Lisez les descriptions : Prenez toujours le temps de lire le texte explicatif avant de cliquer sur "Install plugin".
- Installez un par un : Si vous installez plusieurs plugins, faites-le un par un en redémarrant le serveur entre chaque installation. Cela permet d'identifier immédiatement quel plugin pose problème en cas de crash.
Besoin d'aide ?
Si vous ne parvenez pas à faire fonctionner un plugin ou si vous rencontrez des erreurs dans votre console, notre équipe est là. Ouvrez un ticket dans le département Technique depuis votre espace client et renseignez le champ Produit lié avec le serveur concerné, ou passez directement par le support Winheberg.
Votre serveur PowerNukkitX est maintenant prêt à accueillir tous les plugins dont vous avez besoin 🔌
