PermissionsEx for Dummies

Discussion in 'Server & Community Management' started by Croc, Dec 25, 2015.

  1. Croc's Noob Friendly Guide to PermissionsEx


    Running a Minecraft server is a great experience! It is an opportunity to work on one's leadership skills, while making money on the side. However, Minecraft servers are not all fun and games. They require more work than one might think. The heart of any Minecraft server is the permissions. Without properly configured permissions, chaos would overtake any Minecraft server. In my opinion, setting up and configuring permissions is the best part of setting up a server because it allows the owner to be creative with how he wants his server to run. There are a few different options when it comes to setting up permissions for a Minecraft server and everyone is entitled to his personal preference. Some people like Essentials Group Manager, others swear by zPermissions, or bPermissions, but the one I like is good ol' PEX (PermissionsEx) which is the focus of this tutorial.

    Helpful Tools/Reference links

    To edit the configuration and permissions files, you can use the built-in Multicraft file editor used by most Minecraft server hosts or any basic text editor, preferably one with syntax highlighting. If you are on Windows, a free option is Notepad++. On Mac, you can download TextWrangler free from the Mac App Store.

    PermissionsEx Official Wiki

    Essentials Commands + Permissions Reference

    Minecraft Color Codes:

    Configuration File

    Upon first installing a fresh copy of PermissionsEx, you will want to make a quick configuration change to the following file:


    On line 4, change the Boolean (true/false) value next to "allowOPs" from false to true.

    Setting up ranks

    There are two ways to setup ranks via PermissionsEx—editing the permissions.yml (YOUR_SERVER/plugins/PermissionsEx/permissions.yml) directly or via in-game commands. I highly recommend all beginners setup all their ranks via in-game commands because it prevents common formatting errors, which is the number one mistake I see people make when editing the file directly. Also, simple typing /pex in-game will list every available PermissionsEx command along with a brief description of how to use it. This tutorial will cover how to create ranks and add permissions using in-game commands only.

    The first thing I do when starting to setup permissions from scratch is to create all the permission groups (groups are basically ranks) that I want on the server. Try to create them in order to keep the file neat and more readable, but it is not crucial what order you make them in. Also, it is very helpful to stick with the same naming convention for groups to make life easier later. For instance, if you make a group called "member" with all lowercase, make sure all the other group names are all lowercase too for consistency. Keep in mind, the name of the group does not have to be the same as the prefix (the part shown in chat before the player's username). Personally, I name each group after the prefix, but in all lowercase because I never have to remember whether I called a group "member" or "Member", both of which appear as two different groups to the server under most circumstances.

    To create a group:

    /pex group {nameOfGroup} create

    To delete a group:

    /pex group {nameOfGroup} delete

    Next, I setup the rank order. The rank order defines the actual hierarchy (order) of the ranks. It is important to note that the higher the number, the lower the rank. As a good rule of thumb, keep the absolute highest rank on your server as 1. Also, do not make the second highest rank 2, the third highest rank 3, etc. Instead, space them out by at least increments of 10 so you can add ranks in between two ranks in the future without having to re-setup the rank order completely. For example, on my personal server, my highest rank Owner is rank 1 and my default rank, Astro, is 1000. I have 10 ranks total, so each is 100 apart.

    To set rank order:

    /pex group {nameOfGroup} set rank {rank number}

    Now is the time to talk about group inheritance. This is the trickiest part for noobs to understand when first learning how to setup permissions. Often times, I see people skip setting up inheritance all together due to frustration or lack of understanding. However, inheritance saves so much time in the long run, so it is worth spending a few extra minutes setting it up. Basically, inheritance is like a reverse parent child relationship. Using moderator and admin as an example, if we give moderator a bunch of permissions we do not have to give admin those same permissions because admin is higher than moderator. Moderator is the parent of Admin.

    To set inheritance:

    /pex group {nameOfGroup} parents set {nameOfParentGroup}

    The fourth step is the fun part—setting up those fancy prefixes and suffixes. PermissionsEx has built-in support for Essentials Color Codes. If you are not familiar with these, this site has a handy reference. Remember, in order to get the prefixes to show up in chat, you need a chat plugin such as Essentials Chat or Mineverse Chat among others. If you want spaces in the prefix or suffix, surround it with quotation marks.

    To add an optional prefix:

    /pex group {nameOfGroup} set prefix {prefix}

    To add an optional suffix:

    /pex group {nameOfGroup} set suffix {suffix}

    Last but not least, you are now ready for the most tedious part—adding permissions. I'm assuming many of you will be using the full Essentials suite (minus Group Manager), so you can find a full list of every command and its associated permission node here. For other plugins, they typically list all the permissions on the download page or at the very least a link to the plugin's wiki. For Owner rank, you only need to add one permission—a single asterisk or * symbol. That is simply a variable which means every permission available.

    To add a permission to a group:

    /pex group {nameOfGroup} add {permission node}

    To remove a permission from a group:

    /pex group {nameOfGroup} remove {permission node}

    To add a permission to a specific user:

    /pex user {username} add {permission node}

    To remove a permission from a specific user:

    /pex user {username} remove {permission node}


    In order for the changes to take a effect after adding or removing permssions, you have to run the following command...

    /pex reload


    Yay, you made it through Croc's Noob Friendly Guide to PermissionsEx! Now take your newly obtained knowledge and share it with others.

    If this guide helped you in anyway, a positive rating is greatly appreciated! :)

    Update - January 29, 2018
    A copy of this guide has been permanently hosted at

    #1 Croc, Dec 25, 2015
    Last edited: Jan 29, 2018
    • Like Like x 6
    • Informative Informative x 6
    • Creative Creative x 1
  2. mathhulk

    mathhulk Retired Moderator

    Someone worked really hard on this...
    Not gonna point any fingers...
    Croc, thanks for giving back to the community.
    Love ya man. <3
    • Like Like x 1
  3. You helped me greatly, Thank you very much :)
    • Like Like x 1
  4. Helped a lot. Thanks!
    • Like Like x 1
  5. how do u put someone in a group?
  6. You can do either of the following commands:

    This promotes the user to a specific group (does not have to be consecutive)
    Code (Text):
    /pex user {username} group set {name of group}
    This promotes user to the next highest rank from their current rank
    Code (Text):
    /pex promote {username}
  7. how do i give myself the perms to do /pex in game?
    • Winner Winner x 1
  8. If you are the owner of the server, you can just OP yourself. That's the easiest way.

    Else, just type the following command in console...

    Code (Text):
    pex user {your username} add permissions.manage
    followed by this command...

    Code (Text):
    pex reload
  9. Sinclare

    Sinclare Previously xSinclare

    This is a great thread. Will definitely make sure to forward this to friends who may ask about PermissionsEX! I remember when I first switched from GroupManager to PEX. GM kept breaking and I was forced to switch. At first I was against it, but after learning about it more and more I would recommend it to anyone over any other permissions plugin I have used.
    • Agree Agree x 1
  10. I tried all of the commands but each time it keeps telling me "Sorry you don't have enough permissions." I know that I need to do something with the permissions.yml folder, but I have absolutely no idea how to do that or how to add myself to a group with the console. I'm playing on a mac, so I'm using TextWrangler.
  11. mathhulk

    mathhulk Retired Moderator

    In console, use the command /pex user (your name) add *, which will give you all permissions to PeX and other plugins.
    • Agree Agree x 1
  12. I can't figure out why there is no config file in the permissionsex folder....
  13. That's odd. After installing PEX, you will need to restart the server to generate the default configs.