(Guide) How to create your pex config.

Welcome to a guide to Permissions Ex.




How to Install Permissions Ex.


To get started in downloading permissions ex, open this link in a new tab http://dev.bukkit.org/bukkit-plugins/permissionsex/
when you download permissions ex you will get 3 jars, if you do not know, jars are the files that your server uses to run, from bukkit to your plugins,all of them are jars, so to cap that you download.

• PermissionsEx.jar
• Modifymyworld.jar
• Chatmanager.jar

Once you have downloaded those three, you can delete Chatmanager.jar, it is not needed, to replace chatmanager you will need to download essentials chat if you do not already have it, you can get if from here by left clicking and opening in a new tab http://dev.bukkit.org/bukkit-plugins/essentials/files/194-essentials-2-11-1/, one you have downloaded the essentials pack, read on to the next step.

Move the PermissionsEx.jar, Modifymyworld.jar and the essentials chat into your plugin's folder located in your servers directory, from there, start up your server, then once it has loaded close it, you have installed Pex and essentials chat on your server and you are now ready to configure it.


How to configure your config.yml.


First, open up the permissions.yml file in your permissions ex file, I am going to use a example Permissions Ex file that you can get from either https://github.com/PEXPlugins/PermissionsEx/wiki/Basic-Permissions-Setup#wiki-file-backend-example or you can copy the example below.


groups:
default:
prefix: '&0(&8Guest&0)&7 '
default: true
options:
rank: '1000'
permissions:
- modifyworld.chat
Member:
prefix: '&0(&8M&7ember&0)&7 '
permissions:
- modifyworld.*
options:
rank: '900'
VIP:
prefix: '&0(&eVIP&0)&7 '
permissions:
- -modifyworld.mobtarget.monster.creeper
- modifyworld.*
options:
rank: '800'
Moderator:
prefix: '&0(&1Moderator&0)&7 '
permissions:
- -modifyworld.mobtarget.*
- modifyworld.*
options:
rank: '100'
Admins:
prefix: '&0(&4Admins&0)&7 '
permissions:
- -modifyworld.mobtarget.*
- modifyworld.*
- permissions.*
options:
rank: '1'
users:
AnotherPlayer:
group:
- default
YourPlayerName:
group:
- Admins



Okay so now you have your example permissions ex config, lets break it down into 2 parts, the groups and the users, the groups are where the ranks are set up, and the users is where you can define certain permission nodes for certain ranks or change a players rank.

How to set up a rank.


I am going to build the rank of the default rank in the example so you can keep track of me, first I am going to name the rank.

Guest: <----
default: true
options:
rank: '1000'
permissions:
- modifyworld.chat

I renamed the default rank to guest, even though I renamed it, it is still classed as the default rank not because of its position on the config but because underneath the name it says default: true, this as you would think it says, makes the rank a default rank, if this was set to false, there would be no rank for players who have never joined your server rank to be, so you have to make sure, one rank has the default class set to true.

Rank Options


The next part of setting up the Guest rank is options, in the options there is a class called rank:, in this case the guest rank is set to '1000', that would mean it is the lowest rank out of all the ranks, the way the ranks are set up as in basically the peasants to the king aka Owner, and these ranks have numbers that represent their rank so 1 would be owner and the lower class ranks would be a higher number.

Prefix



From there we set up the Prefix, if you do not know already the prefix is what the players rank looks like, to set the prefix you use the symbol & followed by a number or letter, there are assigned letters that you can use such as 2 which is green or 3 which is aqua, for a full list open this link in a new tabhttp://ess.khhq.net/mc/, now that you have a full list of colors, lets make a prefix, lets use the prefix &7[&8Guest&7]&l, this would format automatically ingame to [Guest] Playername, you can change it up adding things like bold letters but note, to add bold letters you need to put the &l (l = bold) before you would put any other color code in so for example it would be &L&7[ ect. its not hard and once you get the hang of it, it will become second nature.

Permission Nodes



The next part is permissions, I am going to use the basic permissions that you would need. I will start with modifymyworld because they are a necessity with pex, you can get the modifymyworld permission nodes from here.


Guest: <----
default: true
options:
rank: '1000'
permissions:
- modifyworld.*
- -modiflymyworld.login (I am not allowing the guest rank to log in if there server is whitelisted.)

Now with modiflymyworld taken care of I will add essentials, just copy and paste the essentials permission nodes I have or you can find them at http://wiki.ess3.net/doc/permissions

Guest:
prefix: '&7[&8Guest&7]*8 '
default: true
options:
rank: '1000'
permissions:
- modifyworld.*
- -modiflymyworld.login
- essentials.pay
- essentials.warps
- essentials.warp
- essentials.home
- essentials.sethome
- essentials.kit
- essentials.kits
- essentials.kit.spawn
- essentials.kits.spawn
- essentials.msg
- essentials.warp.list
- essentials.tpdeny
- essentials.tpahere
- essentials.tpaccept
- essentials.tpa
- essentials.delhome
- essentials.spawn
- essentials.ping
- essentials.whois
- essentials.nick
- essentials.me
- essentials.ignore
- essentials.mail
- essentials.mai.send
- essentials.help
- essentials.getpos
- essentials.balance.top
- essentials.kitt

Thats it, its pretty simple, now if you want to add moderators just go to the websitehttp://wiki.ess3.net/doc/permissions, copy and paste what permission nodes you would like then for administrators add the permission node *-*.


Usefull commands.

pex group <group> prefix [newprefix] Sets the prefix of a rank.

pex group <group> suffix [newsuffix] Sets the suffix, (not important)

pex group <group> delete Deletes a rank.

pex group <group> remove <permission> [world] Removes a permission.

pex group <group> add <permission> [world] adds a permission

Pex promote user Promotes a user to a higher rank.

Pex demote user Demotes a user to a lower rank.







And that is basicly it.

Some more helpful permission nodes.

(factions) http://www.massivecraft.com/factions
(Mcmmo) https://github.com/mcMMO-Dev/mcMMO/wiki/List-of-permissions
(Mutliverse) https://github.com/Multiverse/Multiverse-Core/wiki/Permissions

I hope that helps you and that you have learnt a lot from this, don't forget to give it a like.




- NanoSkill