[{"data":1,"prerenderedAt":32},["ShallowReactive",2],{"doc-fr-installer-plugin-pocketmine":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":22,"docGroup":16,"docGroupIcon":29,"link_en":30,"bodyHtml":31},"\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-bedrock\u002Finstaller-plugin-pocketmine","installer-plugin-pocketmine","Comment installer un plugin sur PocketMine-MP ?","Découvrez comment installer facilement un plugin au format .phar ou .zip sur votre serveur PocketMine-MP depuis le panel gaming Winheberg ou via SFTP pour les gros fichiers.","jeux","minecraft-bedrock","tabler:file-text","2026-07-24","Winheberg",57,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-bedrock\u002Finstaller-plugin-pocketmine.webp",[16,17,18,19,20,21],"pocketmine","minecraft","plugin","configuration","sftp","gaming-panel",[23,24,25,26,27,28],"installer plugin pocketmine","upload sftp winheberg","plugin .phar pocketmine-mp","panel gaming winheberg","devtools pocketmine","serveur minecraft bedrock","tabler:brand-minecraft","\u002Fen\u002Fdocs\u002Fminecraft-bedrock\u002Finstall-plugin-pocketmine","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>L'un des plus grands atouts de PocketMine-MP réside dans son architecture modulaire. Grâce à son système de plugins, vous pouvez personnaliser intégralement votre environnement Minecraft Bedrock : intégration d'une économie virtuelle, mise en place de serveurs Faction, gestion fine des permissions ou encore protection des zones et revendications de terrains (\u003Cem>claims\u003C\u002Fem>).\u003C\u002Fp>\n\u003Cp>Afin d'enrichir votre expérience de jeu sans compromettre la stabilité de votre infrastructure, il est essentiel d'adopter une méthodologie d'installation rigoureuse et de vous approvisionner auprès de sources vérifiées. Ce guide vous accompagne pas à pas dans le déploiement de vos extensions sur votre serveur hébergé chez Winheberg.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Un serveur PocketMine-MP actif sur votre panel de gestion Winheberg.\u003C\u002Fli>\n\u003Cli>Un client SFTP tiers (tel que \u003Ca href=\"https:\u002F\u002Ffilezilla-project.org\u002F\">FileZilla\u003C\u002Fa> ou \u003Ca href=\"https:\u002F\u002Fwinscp.net\u002F\">WinSCP\u003C\u002Fa>) pour le transfert des fichiers volumineux (supérieurs à 100 Mo).\u003C\u002Fli>\n\u003Cli>Une sauvegarde récente de votre instance, générée via l'onglet \u003Cstrong>Backups\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Avant l'intégration de toute nouvelle extension, effectuez impérativement une sauvegarde depuis l'onglet \u003Cstrong>Backups\u003C\u002Fstrong>. Un plugin corrompu ou incompatible peut altérer l'intégrité de vos mondes ou de vos configurations. Nos équipes ne pourront restaurer des données n'ayant pas fait l'objet d'une sauvegarde préalable.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Identifier des plateformes de téléchargement de confiance\u003C\u002Fh2>\n\u003Cp>Afin de vous prémunir contre les scripts malveillants ou optimisés de manière défectueuse (susceptibles de saturer les ressources CPU\u002FRAM), utilisez exclusivement les banques de données officielles :\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Poggit\u003C\u002Fstrong> (\u003Ca href=\"https:\u002F\u002Fpoggit.pmmp.io\u002F\">poggit.pmmp.io\u003C\u002Fa>) : C'est la plateforme de référence officielle pour PocketMine-MP. Les plugins y subissent une phase de révision et sont indexés selon leur compatibilité avec l'API de votre serveur.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>GitHub\u003C\u002Fstrong> (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002F\">github.com\u003C\u002Fa>) : Privilégiez cette option pour les extensions open-source spécifiques ou les versions de développement. Téléchargez uniquement les fichiers compilés disponibles dans la section \u003Cstrong>Releases\u003C\u002Fstrong> des dépôts officiels.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>2. Accéder au Gestionnaire de fichiers\u003C\u002Fh2>\n\u003Cp>L'intégration d'une extension nécessite une interaction directe avec l'arborescence de votre serveur.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Connectez-vous à votre panel de gestion sur \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">panel.winheberg.com\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>Sélectionnez votre instance PocketMine-MP.\u003C\u002Fli>\n\u003Cli>Dans le menu latéral gauche, cliquez sur l'onglet \u003Cstrong>File manager\u003C\u002Fstrong> (Gestionnaire de fichiers).\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-bedrock\u002Finstaller-plugin-pocketmine-1781100549511-0e6e22c159112c65fe03ed07.webp\" alt=\"Accès à l'onglet File Manager sur le panel de gestion Winheberg\" width=\"800\" \u002F>\n\n\u003Ch2>3. Ouvrir le répertoire des plugins\u003C\u002Fh2>\n\u003Cp>Depuis la racine de votre espace de stockage (\u003Ccode>\u002F\u003C\u002Fcode>), localisez et ouvrez le dossier suivant :\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">plugins\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Cet espace est l'unique répertoire configuré pour l'initialisation et la lecture de vos extensions par le moteur du serveur.\u003C\u002Fp>\n\u003Ch2>4. Téléverser l'extension\u003C\u002Fh2>\n\u003Cp>Selon le format de distribution fourni par le développeur, appliquez la méthode appropriée :\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Méthode standard (Fichier \u003Ccode>.phar\u003C\u002Fcode>)\u003C\u002Fstrong> : Glissez-déposez directement le fichier \u003Ccode>.phar\u003C\u002Fcode> au sein du dossier \u003Ccode>\u002Fplugins\u003C\u002Fcode>, ou utilisez le bouton d'importation (\u003Cem>Upload\u003C\u002Fem>) intégré au panel.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Méthode de développement (Archive \u003Ccode>.zip\u003C\u002Fcode>)\u003C\u002Fstrong> : L'interface web ne prenant pas en charge le téléversement de dossiers bruts, le code source doit être importé compressé. Déposez votre archive \u003Ccode>.zip\u003C\u002Fcode>, puis utilisez l'action \u003Cstrong>Unarchive\u003C\u002Fstrong> pour l'extraire sous forme de dossier. Cette méthode nécessite la présence préalable du plugin \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpmmp\u002FDevTools\">DevTools\u003C\u002Fa> dans votre répertoire.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Si la taille de votre extension excède 100 Mo, le protocole HTTP du panel web peut interrompre le transfert. Utilisez alors un client SFTP en récupérant vos identifiants de connexion dans l'onglet \u003Cstrong>Settings\u003C\u002Fstrong> de votre panel de jeu.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fminecraft-bedrock\u002Finstaller-plugin-pocketmine-1781100703513-62a68a58e70c986992b3b9b9.webp\" alt=\"Téléversement d'un fichier de plugin au format .phar dans le dossier plugins\" width=\"800\" \u002F>\n\n\u003Ch2>5. Valider la compatibilité de l'API\u003C\u002Fh2>\n\n\u003Cp>Lors de la première initialisation, ouvrez votre flux console pour valider l'adéquation entre l'API requise par le plugin et celle de votre binaire PocketMine-MP.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Si la version d'API déclarée dans le fichier manifeste \u003Ccode>plugin.yml\u003C\u002Fcode> (interne à l'extension) ne correspond pas aux exigences de votre cœur de serveur, l'extension sera ignorée et une alerte critique sera émise dans les journaux. Il conviendra alors de mettre à jour PocketMine-MP ou de vous procurer une révision adaptée du plugin.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>6. Initialiser et charger l'extension\u003C\u002Fh2>\n\u003Cp>Dirigez-vous vers l'onglet \u003Cstrong>Console\u003C\u002Fstrong> de votre panel de jeu, puis cliquez sur le bouton \u003Cstrong>Restart\u003C\u002Fstrong>. Lors de la phase de démarrage, le serveur va compiler l'extension et générer de manière autonome un répertoire de configuration modifiable dans le chemin \u003Ccode>\u002Fplugins\u002Fplugin_data\u002F[NomDuPlugin]\u002F\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>Spécifications des formats de distribution\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Format de fichier\u003C\u002Fth>\n\u003Cth>Cas d'usage recommandé\u003C\u002Fth>\n\u003Cth>Prérequis\u003C\u002Fth>\n\u003Cth>Avantage principal\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>.phar\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Environnement de production \u002F Public\u003C\u002Ftd>\n\u003Ctd>Aucun (Natif)\u003C\u002Ftd>\n\u003Ctd>Vitesse de lecture optimisée, fichier unique et intègre\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Archive \u003Ccode>.zip\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Environnement de développement \u002F Édition\u003C\u002Ftd>\n\u003Ctd>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpmmp\u002FDevTools\">DevTools\u003C\u002Fa> actif\u003C\u002Ftd>\n\u003Ctd>Permet la modification directe du code source PHP après extraction\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Ch3>❌ Redémarrages en boucle de l'instance (\u003Cem>Crash Loop\u003C\u002Fem>)\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Accédez à votre Gestionnaire de fichiers et supprimez le fichier \u003Ccode>.phar\u003C\u002Fcode> ou le dossier de la dernière extension installée.\u003C\u002Fli>\n\u003Cli>Relancez le serveur pour valider le retour à la stabilité de l'infrastructure.\u003C\u002Fli>\n\u003Cli>Analysez les fichiers de traces (\u003Cem>logs\u003C\u002Fem>) pour identifier l'origine du conflit de code avant toute nouvelle tentative.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Le plugin est absent ou marqué en rouge dans l'index\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Contrôlez la conformité de l'API dans le fichier \u003Ccode>plugin.yml\u003C\u002Fcode> par rapport à la version de votre serveur.\u003C\u002Fli>\n\u003Cli>Vérifiez dans vos journaux de démarrage l'absence d'une dépendance logicielle manquante (un autre plugin requis pour le fonctionnement du premier).\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Échec ou coupure lors du téléversement web\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Pour tout fichier dont le volume est important, privilégiez une liaison SFTP via FileZilla ou WinSCP.\u003C\u002Fli>\n\u003Cli>Vos paramètres de connexion hôte et port sont accessibles en permanence dans l'onglet \u003Cstrong>Settings\u003C\u002Fstrong> de votre panel.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques d'administration\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Principe de précaution\u003C\u002Fstrong> : Ne faites jamais l'impasse sur la création d'un point de restauration (\u003Cem>Backup\u003C\u002Fem>) avant d'altérer vos dossiers applicatifs.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Déploiement unitaire\u003C\u002Fstrong> : Intégrez vos extensions une à une. Cette isolation permet d'identifier instantanément le binaire responsable en cas de panne.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Audit des processus\u003C\u002Fstrong> : Exécutez la commande \u003Ccode>plugins\u003C\u002Fcode> directement dans votre console. Les extensions fonctionnelles s'affichent en vert, tandis que les modules en anomalie apparaissent en rouge.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Hygiène logicielle\u003C\u002Fstrong> : Purgez régulièrement vos dossiers de configurations résiduels dans \u003Ccode>plugin_data\u003C\u002Fcode> pour les extensions que vous n'utilisez plus.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d'aide ?\u003C\u002Fh2>\n\u003Cp>Si votre infrastructure présente une instabilité persistante après l'ajout d'un module, le retrait du fichier concerné depuis votre espace de stockage permet généralement de restaurer les fonctionnalités nominales du serveur.\u003C\u002Fp>\n\u003Cp>Pour toute anomalie technique complexe, blocage SFTP ou erreur de routage d'API, nos équipes se tiennent à votre disposition. Vous pouvez soumettre un ticket d'assistance auprès de notre département Technique depuis votre espace client sur \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">billing.winheberg.com\u003C\u002Fa> en rattachant votre abonnement PocketMine-MP pour une expertise personnalisée.\u003C\u002Fp>\n\u003Cp>Bonne configuration et bon jeu sur votre infrastructure PocketMine-MP 🎮\u003C\u002Fp>\n",1788993137000]