How to Add Mods to Your Minecraft PocketMine Edition Server

PocketMine-MP does not support classic mods. Instead, the server is extended through plugins – small PHP extensions in .phar format that run exclusively on the server.

Where do I find plugins?

The official plugin platform for PocketMine-MP is Poggit:

• Poggit Release

Install a plugin

1. Download the plugin
   Download the plugin as a .phar file.

2. Stop the server
   Stop your server via the dashboard.

3. Connect via SFTP
   Connect to your server via SFTP or use the file browser in the dashboard.

4. Upload the plugin
   In the main folder of your server, upload the .phar file into the following folder:

   plugins
   

5. Start the server
   Start your server. The plugin is loaded on startup.

Update a plugin

1. Stop the server
   Stop your server via the dashboard.

2. Delete the old version
   Delete the old .phar file of the plugin from the plugins folder.

3. Upload the new version
   Upload the new .phar file into the plugins folder.

4. Start the server
   Start your server so the change takes effect.

Remove a plugin

1. Stop the server
   Stop your server via the dashboard.

2. Delete the plugin
   Delete the .phar file from the plugins folder.

3. Delete the configuration
   Optionally delete the matching subfolder of the plugin in the plugin_data folder.

4. Start the server
   Start your server.

Where are the plugin configuration files?

By default PocketMine-MP collects the configurations of all plugins in the plugin_data folder in the main folder of your server – every plugin gets its own subfolder there.

If you prefer the legacy structure instead, where a plugin's configuration sits directly under plugins/, set the following value in the pocketmine.yml file in the main folder of your server:

plugins:
  legacy-data-dir: true

Resource packs for visuals

Visual changes for all players are applied through resource packs.

1. Stop the server
   Stop your server via the dashboard.

2. Upload the pack
   In the main folder of your server, upload the resource pack as a .zip or .mcpack file into the following folder:

   resource_packs
   

3. Register the pack
   In the resource_packs folder, open the resource_packs.yml file and add the file name including its extension to the resource_stack list:

   resource_stack:
     - MyPack.mcpack
   

4. Start the server
   Start your server.