> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ggservers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Set Up Permissions Using PurePerms on Your PocketMine Server

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/banner10_1mgbruh.png)

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/pocketmine-h_1j7qie8.png)

This article will show you how to properly set up permissions on your PocketMine server using the PurePerms plugin.

|| ⚠ NOTE ⚠: You can only set permissions on a PocketMine server as it can run plugins. The Bedrock Dedicated Template is not able to run plugins so you can not set up a Permissions Plugin.

Before we start, we need to understand the meaning of the arguments for each command that we will use:

- ❓ The ones between ' <> ' are necessary for the command to work, you need to fill that campus with the correct argument.
- ❓ The ones between ' [] ' are not necessary for the command and usually are extra features. You can use the command leaving those spaces empty and it will still work.

---


![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/1_yaqoah.png)

# 🌲 What is PurePerms? 🌲

PurePerms is a Permission plugin that only works on PocketMine and lets you manage Permissions on your server.

[Here](https://poggit.pmmp.io/p/PurePerms) you can find more details about PurePerms on its official page.

---

# 🔌 How to Set Up PurePerms 🔌

First, you will have to download the PurePerms plugin [here](https://poggit.pmmp.io/p/PurePerms). After doing so, you need to use Filezilla to upload the plugin to the `plugins` folder of the server. 

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/2_raqa5o.png)

After uploading the plugin you need to restart the server for it to load the plugin.

||| [Here](https://help.ggservers.com/en-us/article/how-to-connect-with-filezilla-yl0q5r/) is our guide for using Filezilla. Also, [here](https://help.ggservers.com/en-us/article/how-to-install-plugins-on-your-server-1yxw90a/) is our guide for installing plugins into your server.

---

# 🔩 How to Configure PurePerms 🔩

To configure PurePerms you will have to create groups, add permissions for commands to each group, then add players into groups.

---

### General Commands

1.
###### `/fperms`

Allows you to find permissions for a specific plugin.

---

2.
###### `/ppinfo`

Shows info about PurePerms.

---

3.
###### `/ppreload`

Reloads all PurePerms configurations.

---

### Managing Groups

To manage your groups you will use the following commands:

1.
###### `/addgroup <group>`

Adds a new group to the group's list.

---

2.
###### `/addparent <target_group> <parent_group>`

Adds a group to another group inheritance list.

---

3.
###### `/defgroup <group> [world]`

Allows you to set the default group.

---

4.
###### `/groups`

Shows a list of all groups.

---

5.
###### `/grpinfo <group> [world]`

Shows info about a group.

---

6.
###### `/listgperms <group> <page> [world]`

Shows a list of all permissions from a group.

---

7.
###### `/rmgroup <group>`

Removes a group from the group's list.

---

8.
###### `/rmparent <target_group> <parent_group>`

Removes a group from another group inheritance list.

---

9.
###### `/setgperm <group> <permission> [world]`

Adds a permission node to the group.

---

10.
###### `/unsetgperm <group> <permission> [world]`

Removes a permission node from the group.

---

### Managing Users

To manage your Users you will use the following commands:

1.
###### `/listuperms <player> <page> [world]`

Shows a list of all permissions from a user.

---

2.
###### `/setuperm <player> <permission> [world]`

Adds a permission node to the user.

---

3.
###### `/unsetuperm <player> <permission> [world]`

Removes a permission node from the user.

---

4.
###### `/usrinfo <player> [world]`

Shows info about a user.

---

# 📑 Setting Up Prefixes and Suffixes 📑

If you want to be able to set prefixes and suffixes for groups or players, you will need to add a separate plugin called `PureChat` that will provide this feature in concordance with `PurePerms`.

You can find more details about this plugin on its official page [here](https://poggit.pmmp.io/p/PureChat/1.4.11) 

To add the plugin to your server just download it from [here](https://poggit.pmmp.io/p/PureChat/1.4.11) and then use Filezilla to upload it to your `plugins` folder.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/13_yujxfb.png)

After doing so, you will have to restart the server in order for it to load the new plugin.

||| [Here](https://help.ggservers.com/en-us/article/how-to-connect-with-filezilla-yl0q5r/) is our guide for using Filezilla. Also, [here](https://help.ggservers.com/en-us/article/how-to-install-plugins-on-your-server-1yxw90a/) is our guide for installing plugins into your server.

---

### Commands

1.
###### `/setsuffix <player> <suffix>`

Set a player's suffix.

2.
###### `/setprefix <player> <prefix>`

Set a player's prefix.

3.
###### `/setnametag <group> <world> <format>`

Set the default nametag of a group.

4.
###### `/setformat <group> <world> <format>`

Set default chat format.

--- 

# 🧬 Example 🧬

Let's say that we want to set up four groups with the following permissions:

- **default**: no permissions, default group;

- **VIP**: permission to use `/tp` command;

- **admin**: permissions to use `/tp` and `/gamemode`;

- **owner**: all permissions;

---

Now, to configure the plugin you will need to use the following list of commands:

|| ⚠ NOTE ⚠: If you are using commands in the Multicraft console you need to do it without the `/` at the beginning.

1. `/addgroup default`

Add the `default` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/3_15nw49v.png)

---

2. `/addgroup VIP`

Add the `VIP` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/4_dnhgsn.png)

---

3. `/addgroup admin`

Add the `admin` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/5_jf1ndi.png)

---

4. `/addgroup owner`

Add the `owner` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/6_hi6m9a.png)

---


5. `/defgroup default`

Set the `default` group as the default one.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/7_1k0ohsd.png)

---


6. `/setgperm VIP pocketmine.command.teleport`

Add the `pocketmine.command.teleport` permissions to the `VIP` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/8_1xvj1oa.png)

---


7. `/setgperm admin pocketmine.command.gamemode`

Add the `pocketmine.command.gamemode` permissions to the `admin` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/9_mi5ig7.png)

---


8. `/addparent admin VIP`

Set the parent group `VIP` for the `admin` group. This means that the `admin` group will have access to all permissions that the `VIP` groups have.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/10_mzdnku.png)

---


9. `/setgperm owner *`

Add the `*` permission to the `VIP` group.

|| ⚠ NOTE ⚠: To give access to a group to all existing permissions you need to give it access to `*`.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/11_nviahr.png)

---


10. `/setgroup MyUsername owner`

Let's add ourselves to the `owner` group.

![](https://storage.crisp.chat/users/helpdesk/website/ba33bb39ceb6d800/12_1it4xt0.png)

||| You can find the full permissions list for the default PocketMine commands [here](https://web.archive.org/web/20200817072832/https://github.com/PocketMine/PocketMine-MP/blob/master/src/pocketmine/permission/DefaultPermissions.php).

Now you just created the four groups and also added yourself to the `owner` group.

---

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

---

# ❕ Useful Links ❕

- [How to Download Your World on Your Bedrock Server](https://help.ggservers.com/en-us/article/how-to-download-your-world-on-your-bedrock-server-1w6cgrg/)
- [How to Install Plugins Into Your Server](https://help.ggservers.com/en-us/article/how-to-install-plugins-on-your-server-1yxw90a/)
- [How to connect with FileZilla](https://help.ggservers.com/en-us/article/how-to-connect-with-filezilla-yl0q5r/)