PocketMine Introduction



# ❓ What is PocketMine ❓

PocketMine is a Bedrock server type, an alternative to our `Bedrock Dedicated` server type, which is also able to run plugins.

|| ⚠ NOTE ⚠: `Bedrock Dedicated` is not able to run plugins. It is the Vanilla version of Bedrock Minecraft, meaning the game itself without any additions. You can only run a Bedrock server with plugins using PocketMine.

This type executes a .phar file to generate all necessary data to start a Bedrock Server. Probably one of the first modes to emerge, PocketMine also has a long history of updates that dates back to the early days of Bedrock Multiplayer.

Its stable updates are infrequent but provide the player with light and fast play and can be considered a great lightweight mode to play with your friends using plugins.
There is no way to use command blocks on PocketMine.

—

###### Possible Connections

* Minecraft Pocket Edition – MCPE – (Android and IOS)
* Minecraft Windows 10 Edition – Win10 – (From Microsoft Store)

—

###### Useful PocketMine-MP Links

* [PocketMine GitHub](https://github.com/PocketMine/PocketMine-MP)
* [PocketMine Plugins](https://poggit.pmmp.io/plugins)
* [PocketMine-MP Website](https://pmmp.io/)

—

# Change Your Server to PocketMine

To get PocketMine running on your server you will have to change your `Server Type` to the option with the same name and let a new world be generated.

||| ⚠ NOTE ⚠: We have a guide explaining how to change the `Server Type` [here](https://help.ggservers.com/en-us/article/how-to-change-your-server-type-and-version-ve6dtm/) if needed.

Also, we suggest you start the process with a backup of any important files!

||| ⚠ NOTE ⚠: [Here](https://help.ggservers.com/en-us/article/how-to-connect-to-your-server-using-filezilla-yl0q5r/) is our guide explaining how to use FileZilla to download any important files.

—

To change your `Server Type` to `PocketMine` you will have to follow the next steps:

1. Log in to your Multicraft panel [here](https://mc.ggservers.com/site/login) and stop your server.


—

2. Scroll down and click on the `Server Type` option, then select `PocketMine-MP`.


—

3. Generate a new world.

If you want to keep your current world, we recommend clicking `Yes` here. This will create a completely new world and save your current world in case you want to go back to that version of Minecraft and play on it.


Click `Ok` when you see this popup.


—

4. Start Your Server

You can now open your PocketMine server by clicking the `Start` button.


Now you just changed your server to PocketMine.

—

# ️ Server Settings ️

Check out the next box. This is an example of a Pocketmine `server.properties` file.

“`

server-ip=
server-port=19132
max-players=48
level-name=world5
motd=PocketMine-MP Server
white-list=off
announce-player-achievements=on
spawn-protection=16
gamemode=0
force-gamemode=off
hardcore=off
pvp=on
difficulty=2
generator-settings=
level-seed=
level-type=DEFAULT
enable-query=on
enable-rcon=off
rcon.password=
auto-save=on
view-distance=8
xbox-auth=on
language=eng

“`

### What does each option do?

* **server-ip**: Sets a server IP Address.
* **server-port**: Sets a server port.
* **max-players**: Sets a max player count.
* **level-name**: Sets the actual level name.
* **motd**: Can be seen on Minecraft.
* **white-list**: Add a white list to server.
* **announce-player-achievements**: If player is logged on XBOX him can get announce about achievements.
* **spawn-protection**: Set the Spawn Protection size.
* **gamemode**: Sets the server game mode.
* **force-gamemode**: Forge a game mode on the server.
* **hardcore**: Enable hardcore.
* **pvp**:
* **difficulty**: Sets the server difficulty.
* **generator-settings**:
* **level-seed**: Sets the actual level seed.
* **level-type**: Sets the actual level type.
* **enable-query**:
* **enable-rcon**:
* **rcon.password**: Sets the rcon password.
* **auto-save**:
* **view-distance**:
* **xbox-auth**: Enable XBOX connections.
* **language**: Sets the actual language.

—

# How Do I Get Admin Privileges on My Server

To get admin privileges on your server and be able to use all commands you need to:

1. Log into your Multicraft Control Panel [here](https://mc.ggservers.com/site/login).

—

2. Make sure you’re on your server’s page. On the left-hand side of your Control Panel click ‘Console’.


—

3. In the text box above the console, type `op `, then either click on `Send` or press the `Enter` key.

|| ⚠ NOTE ⚠: You need to replace `` with your actual username.

**Example:**

“`
op ggservers
“`


||| Should you make changes to who has OP permissions on your server, please use the `/deop ` command. This command can be executed by any OP player in-game and it can also be executed via the console to remove the OP privileges from a player.

—

# ⌨ PocketMine Commands ⌨

1.
###### `/ban`

Prevents the specified player from using this server.

—

2.
###### `/ban-ip`

Prevents the specified IP address from using this server.

—

3.
###### `/banlist`

View all players banned from this server.

—

4.
###### `/defaultgamemode`

Set the default game mode.

—

5.
###### `/deop`

Takes the specified player’s operator status.

—

6.
###### `/difficulty`

Sets the game difficulty.

—

7.
###### `/dumpmemory`

Dumps the memory.

—

8.
###### `/effect`

Adds/Removes effects on players.

—

9.
###### `/enchant`

Adds enchantments on items.

—

10.
###### `/gamemode`

Changes the player to a specific game mode.

—

11.
###### `/gc`

Fires garbage collection tasks.

—

12.
###### `/give`

Gives the specified player a certain amount of items.

—

13.
###### `/help`

Shows the help menu.

—

14.
###### `/kick`

Removes the specified player from the server.

—

15.
###### `/kill`

Commit suicide or kill other players.

—

16.
###### `/list`

Lists all online players.

—

17.
###### `/me`

Performs the specified action in chat.

—

18.
###### `/op`

Gives the specified player operator status.

—

19.
###### `/pardon`

Allows the specified player to use this server.

—

20.
###### `/pardon-ip`

Allows the specified IP address to use this server.

—

21.
###### `/particle`

Adds particles to a world.

—

22.
###### `/plugins`

Gets a list of plugins running on the server.

—

23.
###### `/reload`

Reloads the server configuration and plugins.

—

24.
###### `/save-all`

Saves the server to disk.

—

25.
###### `/save-off`

Disables server autosaving.

—

26.
###### `/save-on`

Enables server autosaving.

—

27.
###### `/say`

Broadcasts the given message as the sender.

—

28.
###### `/seed`

Shows the world seed.

—

29.
###### `/setworldspawn`

Sets a worlds’ spawn point. If no coordinates are specified, the player’s coordinates will be used.

—

# ✔️ Setting Up a Whitelist ✔️

A whitelist is used to keep a list of players who are allowed to join a server. Any other player that tries to join and is not on the list will be disconnected.

|| ⚠ NOTE ⚠: The actual whitelist is saved in your server files inside the `white-list.txt` file. We do not recommend editing that file manually but to use the following commands. Modifying that file can make the server crash when it’s started.

To manage your whitelist on your PocketMine server you will use the following commands:

1.
###### `/whitelist `

Enable or disable the whitelist.

**Example**:

`/whitelist off`

Disable the whitelist.

—

2.
###### `/whitelist `

Add or remove a specific player from the whitelist.

**Example**:

`/whitelist add player1`

Will add player1 to our whitelist.

—

3.
###### `/whitelist list`

Will show all players from your whitelist.

—

4.
###### `/white-list reload`

Will reload your whitelist according to your `white-list.txt` file.

—

# How to Install Plugins

First, please note that PocketMine does not work with Bukkit/Spigot plugins. It specifically needs PocketMine plugins, which are `.phar` files and which can be found [here](https://poggit.pmmp.io/plugins).

After downloading the plugins you want, just use Filezilla to upload them to your `plugins` folder of the server.


|| ⚠ NOTE ⚠: [Here](https://help.ggservers.com/en-us/article/how-to-connect-with-filezilla-yl0q5r/) is our guide for using Filezilla.

||| We recommend you also take a look [here](https://help.ggservers.com/en-us/article/pocketmine-recommended-plugins-3sk5qh/) at our guide for recommended plugins for PocketMine. You will find recommended plugins for anything from essentials commands to anti-cheat and minigames plugins.

—

# How to Get Mobs on Your Server

To get mobs working on PocketMine, you’ll need to set up the PureEntitiesX plugin which can be found [here](https://poggit.pmmp.io/p/PureEntitiesX/0.6.3).


Just download it and drop it into your server `plugins` folder using Filezilla, then restart the server.


|| ⚠ NOTE ⚠: [Here](https://help.ggservers.com/en-us/article/how-to-connect-with-filezilla-yl0q5r/) is our guide for using Filezilla.

—

# Setting Up Permissions

For managing permissions better on the PocketMine server we suggest you use a permission plugin, like PurePerms.

||| [Here](https://help.ggservers.com/en-us/article/how-to-set-up-permissions-using-pureperms-on-your-pocketmine-server-ujopi8/) is our guide for setting up and configuring PurePerms, please take a look.

—

# ️ Setting Up Your Custom World ️

Please note that PocketMine has a unique world type. If you want to upload a world, you can only use a world that was previously generated with PocketMine.

|| ⚠ NOTE ⚠: You cannot upload your single player world to your PocketMine because it was not generated with PocketMine but with the Vanilla version of the Bedrock game. You also cannot upload a world generated previously with the `Bedrock Dedicated` server type to a PocketMine server.

If you have a world that was generated previously via PocketMine you can upload it to your server files as our guide explains [here](https://help.ggservers.com/en-us/article/how-to-upload-your-custom-world-on-a-bedrock-dedicated-server-bwwamw/).

—

| If you find any issues setting up and using PocketMine please feel free to contact us on live chat or via the ticket system [here](https://ggservers.com/billing/submitticket.php).

—

# ❕ Useful Links ❕

– [Pocketmine Recommended Plugins](https://help.ggservers.com/en-us/article/pocketmine-recommended-plugins-3sk5qh/#1-permission-plugins)
– [How to Set Up Permissions Using PurePerms on Your PocketMine Server](https://help.ggservers.com/en-us/article/how-to-set-up-permissions-using-pureperms-on-your-pocketmine-server-ujopi8/)
– [How to Upload Your Custom World on a Bedrock Server](https://help.ggservers.com/en-us/article/how-to-upload-your-custom-world-on-a-bedrock-dedicated-server-bwwamw/)