[{"data":1,"prerenderedAt":32},["ShallowReactive",2],{"doc-en-install-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_fr":30,"bodyHtml":31},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Finstall-plugin-pocketmine","install-plugin-pocketmine","How to Install a Plugin on PocketMine-MP","Learn how to easily install plugins (.phar or .zip format) on your PocketMine-MP server using the Winheberg gaming panel or SFTP for large files.","jeux","minecraft-bedrock","tabler:file-text","2026-07-24","Winheberg",57,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Finstall-plugin-pocketmine.webp",[16,17,18,19,20,21],"pocketmine","minecraft","plugin","configuration","sftp","gaming-panel",[23,24,25,26,27,28],"install pocketmine plugin","sftp upload winheberg","pocketmine-mp phar plugin","winheberg gaming panel","devtools pocketmine","minecraft bedrock server","tabler:brand-minecraft","\u002Fdocs\u002Fminecraft-bedrock\u002Finstaller-plugin-pocketmine","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>One of the greatest strengths of PocketMine-MP lies in its modular architecture. Thanks to its plugin system, you can fully customize your Minecraft Bedrock environment: integrating a virtual economy, setting up Faction systems, fine-tuning permissions, or securing zones and land claims.\u003C\u002Fp>\n\u003Cp>To enrich your gaming experience without compromising the stability of your infrastructure, it is essential to adopt a rigorous installation methodology and source your files from verified platforms. This guide will walk you through deploying extensions on your server hosted at Winheberg.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active PocketMine-MP server on your Winheberg management panel.\u003C\u002Fli>\n\u003Cli>A third-party SFTP client (such as \u003Ca href=\"https:\u002F\u002Ffilezilla-project.org\u002F\">FileZilla\u003C\u002Fa> or \u003Ca href=\"https:\u002F\u002Fwinscp.net\u002F\">WinSCP\u003C\u002Fa>) for transferring large files (over 100 MB).\u003C\u002Fli>\n\u003Cli>A recent backup of your instance, generated via the \u003Cstrong>Backups\u003C\u002Fstrong> tab.\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>Before integrating any new extension, always perform a backup from the \u003Cstrong>Backups\u003C\u002Fstrong> tab. A corrupted or incompatible plugin can alter the integrity of your worlds or configurations. Our teams will not be able to restore data that has not been previously backed up.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Identify Trusted Download Platforms\u003C\u002Fh2>\n\u003Cp>To protect your server against malicious or poorly optimized scripts (which can saturate CPU\u002FRAM resources), exclusively use official repositories:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Poggit\u003C\u002Fstrong> (\u003Ca href=\"https:\u002F\u002Fpoggit.pmmp.io\u002F\">poggit.pmmp.io\u003C\u002Fa>): This is the official reference platform for PocketMine-MP. Plugins undergo a review process and are indexed according to their compatibility with your server's API.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>GitHub\u003C\u002Fstrong> (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002F\">github.com\u003C\u002Fa>): Use this option for specific open-source extensions or development versions. Only download compiled files available in the \u003Cstrong>Releases\u003C\u002Fstrong> section of the official repositories.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>2. Access the File Manager\u003C\u002Fh2>\n\u003Cp>Integrating an extension requires direct interaction with your server's file structure.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Log in to your management panel at \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">panel.winheberg.com\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>Select your PocketMine-MP instance.\u003C\u002Fli>\n\u003Cli>In the left side menu, click on the \u003Cstrong>File manager\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Finstall-plugin-pocketmine-1781100549511-0e6e22c159112c65fe03ed07.webp\" alt=\"Accessing the File Manager tab on the Winheberg management panel\" width=\"800\" \u002F>\n\n\u003Ch2>3. Open the Plugins Directory\u003C\u002Fh2>\n\u003Cp>From the root of your storage space (\u003Ccode>\u002F\u003C\u002Fcode>), locate and open the following folder:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">plugins\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>This space is the only directory configured for the initialization and reading of your extensions by the server engine.\u003C\u002Fp>\n\u003Ch2>4. Upload the Extension\u003C\u002Fh2>\n\u003Cp>Depending on the distribution format provided by the developer, apply the appropriate method:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Standard Method (\u003Ccode>.phar\u003C\u002Fcode> file)\u003C\u002Fstrong>: Drag and drop the \u003Ccode>.phar\u003C\u002Fcode> file directly into the \u003Ccode>\u002Fplugins\u003C\u002Fcode> folder, or use the \u003Cstrong>Upload\u003C\u002Fstrong> button integrated into the panel.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Development Method (\u003Ccode>.zip\u003C\u002Fcode> archive)\u003C\u002Fstrong>: Since the web interface does not support uploading raw folders, source code must be imported compressed. Upload your \u003Ccode>.zip\u003C\u002Fcode> archive, then use the \u003Cstrong>Unarchive\u003C\u002Fstrong> action to extract it as a folder. This method requires the prior presence of the \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpmmp\u002FDevTools\">DevTools\u003C\u002Fa> plugin in your directory.\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>If your extension size exceeds 100 MB, the web panel's HTTP protocol may interrupt the transfer. In this case, use an SFTP client by retrieving your connection credentials from the \u003Cstrong>Settings\u003C\u002Fstrong> tab of your game panel.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Finstall-plugin-pocketmine-1781100703513-62a68a58e70c986992b3b9b9.webp\" alt=\"Uploading a .phar plugin file into the plugins folder\" width=\"800\" \u002F>\n\n\u003Ch2>5. Validate API Compatibility\u003C\u002Fh2>\n\u003Cp>During the first initialization, open your console stream to validate the match between the API required by the plugin and your PocketMine-MP binary.\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>If the API version declared in the \u003Ccode>plugin.yml\u003C\u002Fcode> manifest file (internal to the extension) does not match your server core requirements, the extension will be ignored and a critical alert will be issued in the logs. You will then need to update PocketMine-MP or obtain a suitable revision of the plugin.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>6. Initialize and Load the Extension\u003C\u002Fh2>\n\u003Cp>Head over to the \u003Cstrong>Console\u003C\u002Fstrong> tab of your game panel, then click the \u003Cstrong>Restart\u003C\u002Fstrong> button. During the startup phase, the server will compile the extension and autonomously generate a modifiable configuration directory in the path \u003Ccode>\u002Fplugins\u002Fplugin_data\u002F[PluginName]\u002F\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>Distribution Format Specifications\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>File Format\u003C\u002Fth>\n\u003Cth>Recommended Use Case\u003C\u002Fth>\n\u003Cth>Prerequisites\u003C\u002Fth>\n\u003Cth>Main Advantage\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>.phar\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Production \u002F Public Environment\u003C\u002Ftd>\n\u003Ctd>None (Native)\u003C\u002Ftd>\n\u003Ctd>Optimized reading speed, single and intact file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>.zip\u003C\u002Fcode> Archive\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Development \u002F Editing Environment\u003C\u002Ftd>\n\u003Ctd>Active \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpmmp\u002FDevTools\">DevTools\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Allows direct modification of PHP source code after extraction\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Ch3>❌ Server Crash Loops\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Access your File Manager and delete the \u003Ccode>.phar\u003C\u002Fcode> file or folder of the last installed extension.\u003C\u002Fli>\n\u003Cli>Restart the server to validate that the infrastructure returns to a stable state.\u003C\u002Fli>\n\u003Cli>Analyze the log files to identify the origin of the code conflict before any new attempt.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Plugin is Missing or Marked Red in the Index\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check API compliance in the \u003Ccode>plugin.yml\u003C\u002Fcode> file against your server version.\u003C\u002Fli>\n\u003Cli>Check your startup logs for any missing software dependency (another plugin required for the first one to function).\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Upload Failure or Interruption via Web Interface\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>For any large file, prefer an SFTP connection using Filezilla or WinSCP.\u003C\u002Fli>\n\u003Cli>Your host and port connection parameters are permanently accessible in the \u003Cstrong>Settings\u003C\u002Fstrong> tab of your panel.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques d'administration\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Precautionary Principle\u003C\u002Fstrong>: Never skip creating a restoration point (\u003Cstrong>Backup\u003C\u002Fstrong>) before altering your application folders.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unitary Deployment\u003C\u002Fstrong>: Integrate your extensions one by one. This isolation allows you to instantly identify the responsible binary in case of a failure.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Process Auditing\u003C\u002Fstrong>: Run the \u003Ccode>plugins\u003C\u002Fcode> command directly in your console. Working extensions are displayed in green, while modules with anomalies appear in red.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Software Hygiene\u003C\u002Fstrong>: Regularly purge your residual configuration folders in \u003Ccode>plugin_data\u003C\u002Fcode> for extensions you no longer use.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d'aide ?\u003C\u002Fh2>\n\u003Cp>If your infrastructure shows persistent instability after adding a module, removing the concerned file from your storage space usually restores the server's nominal functionalities.\u003C\u002Fp>\n\u003Cp>For any complex technical anomaly, SFTP lockouts, or API routing errors, our teams are at your disposal. You can submit a support ticket to our Technical department from your client area at \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">billing.winheberg.com\u003C\u002Fa> by attaching your PocketMine-MP subscription for personalized expertise.\u003C\u002Fp>\n\u003Cp>Happy configuring and have a great game on your PocketMine-MP infrastructure 🎮\u003C\u002Fp>\n",1788993141907]