--- title: "How to Install a Plugin on PocketMine-MP" description: "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." category: jeux subcategory: minecraft-bedrock docGroup: pocketmine docGroupIcon: tabler:brand-minecraft icon: tabler:file-text date: 2026-07-24 author: Winheberg slug: "install-plugin-pocketmine" order: 57 image: /statics/images/docs/en/gaming/minecraft-bedrock/install-plugin-pocketmine.webp tags: [pocketmine, minecraft, plugin, configuration, sftp, gaming-panel] keywords: [install pocketmine plugin, sftp upload winheberg, pocketmine-mp phar plugin, winheberg gaming panel, devtools pocketmine, minecraft bedrock server] link_fr: "/docs/minecraft-bedrock/installer-plugin-pocketmine" --- ## Contexte 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. 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. ## Prérequis - An active PocketMine-MP server on your Winheberg management panel. - A third-party SFTP client (such as [FileZilla](https://filezilla-project.org/) or [WinSCP](https://winscp.net/)) for transferring large files (over 100 MB). - A recent backup of your instance, generated via the **Backups** tab. > [!WARNING] > Before integrating any new extension, always perform a backup from the **Backups** 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. ## 1. Identify Trusted Download Platforms To protect your server against malicious or poorly optimized scripts (which can saturate CPU/RAM resources), exclusively use official repositories: - **Poggit** ([poggit.pmmp.io](https://poggit.pmmp.io/)): 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. - **GitHub** ([github.com](https://github.com/)): Use this option for specific open-source extensions or development versions. Only download compiled files available in the **Releases** section of the official repositories. ## 2. Access the File Manager Integrating an extension requires direct interaction with your server's file structure. 1. Log in to your management panel at [panel.winheberg.com](https://panel.winheberg.com/). 2. Select your PocketMine-MP instance. 3. In the left side menu, click on the **File manager** tab. Accessing the File Manager tab on the Winheberg management panel ## 3. Open the Plugins Directory From the root of your storage space (`/`), locate and open the following folder: ```text plugins ``` This space is the only directory configured for the initialization and reading of your extensions by the server engine. ## 4. Upload the Extension Depending on the distribution format provided by the developer, apply the appropriate method: - **Standard Method (`.phar` file)**: Drag and drop the `.phar` file directly into the `/plugins` folder, or use the **Upload** button integrated into the panel. - **Development Method (`.zip` archive)**: Since the web interface does not support uploading raw folders, source code must be imported compressed. Upload your `.zip` archive, then use the **Unarchive** action to extract it as a folder. This method requires the prior presence of the [DevTools](https://github.com/pmmp/DevTools) plugin in your directory. > [!NOTE] > 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 **Settings** tab of your game panel. Uploading a .phar plugin file into the plugins folder ## 5. Validate API Compatibility During the first initialization, open your console stream to validate the match between the API required by the plugin and your PocketMine-MP binary. > [!IMPORTANT] > If the API version declared in the `plugin.yml` 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. ## 6. Initialize and Load the Extension Head over to the **Console** tab of your game panel, then click the **Restart** button. During the startup phase, the server will compile the extension and autonomously generate a modifiable configuration directory in the path `/plugins/plugin_data/[PluginName]/`. ## Distribution Format Specifications | File Format | Recommended Use Case | Prerequisites | Main Advantage | |---|---|---|---| | **`.phar`** | Production / Public Environment | None (Native) | Optimized reading speed, single and intact file | | **`.zip` Archive** | Development / Editing Environment | Active [DevTools](https://github.com/pmmp/DevTools) | Allows direct modification of PHP source code after extraction | ## En cas de problème ### ❌ Server Crash Loops - Access your File Manager and delete the `.phar` file or folder of the last installed extension. - Restart the server to validate that the infrastructure returns to a stable state. - Analyze the log files to identify the origin of the code conflict before any new attempt. ### ❌ Plugin is Missing or Marked Red in the Index - Check API compliance in the `plugin.yml` file against your server version. - Check your startup logs for any missing software dependency (another plugin required for the first one to function). ### ❌ Upload Failure or Interruption via Web Interface - For any large file, prefer an SFTP connection using Filezilla or WinSCP. - Your host and port connection parameters are permanently accessible in the **Settings** tab of your panel. ## Bonnes pratiques d'administration - **Precautionary Principle**: Never skip creating a restoration point (**Backup**) before altering your application folders. - **Unitary Deployment**: Integrate your extensions one by one. This isolation allows you to instantly identify the responsible binary in case of a failure. - **Process Auditing**: Run the `plugins` command directly in your console. Working extensions are displayed in green, while modules with anomalies appear in red. - **Software Hygiene**: Regularly purge your residual configuration folders in `plugin_data` for extensions you no longer use. ## Besoin d'aide ? 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. 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 [billing.winheberg.com](https://billing.winheberg.com) by attaching your PocketMine-MP subscription for personalized expertise. Happy configuring and have a great game on your PocketMine-MP infrastructure 🎮