How to correctly configure PermissionsEX.

I've noticed that many users struggle to set up PermissionsEX on their server. They either don't know how or just misconfigure it,

Here is an example of an incorrectly configured permissions.yml

Code:

groups:
  rankname:
    default: true
    permissions:
    - permission.one
    - permwission.two
    permission.three
permission.four
    options:
      rank: '1'
    prefix: '[Rankname]'
users:
  example:
    group:
    - rankname

(Replace 'rankname' with the name of your rank)

Now to depict the errors:
' - permwission.two' is spelt incorrectly meaning the permission you are trying to grant will fail.
' permission.three' does not contain a hyphen. (-)
'permission.four' does not contain the required 4 spaces then a hyphen (-).
NEVER EVER USE 'TAB' WHEN SETTING SPACES! This breaks plugins.
It's simple errors like this that can break entire permissions systems. These are YAML errors.

Example of a good permissions.yml

Code:

groups:
  rankname:
    default: true
    permissions:
    - permission.one
    - permission.two
    - permission.three
    - permission.four
    options:
      rank: '1'
    prefix: '[Rankname]'
users:
  example:
    group:
    - rankname

All these are spelt correctly and will be able to be parsed as YAML.

PermissionsEX supports full colour/formatting codes.
http://www.minecraftwiki.net/wiki/Formatting_codes

I recommend pasting your entire permissions.yml in this online parser to check for errors.
http://yaml-online-parser.appspot.com/

Hope this can help,

 

It's short and precise, which is hopefully letting the guys read it

 

Actually your forgetting one important thing!

Code:

groups:
  rankname:
    default: true
    permissions:
    - permission.one
    - permission.two
    - permission.three
    - permission.four
    options:
      rank: '1'
      rank-ladder: bg
    prefix: '[Rankname]'
users:
  example:
    group:
    - rankname

[EDIT] Its the rank-ladder and users.

 

And the tabs as well. Maybe a word on that and the indentions in general?

 

When setting this up for the first time, the 'users' part is generated. At least that's what happened with me.

 

That aswell but good try. Just make sure you have everything correct!

 

Tabs? I'm not sure what you mean by that, Or I'm just being stupid.

 

Well no i made mine from scratch so. Plus in a few there will be a tutorial for 1.5.1 on my youtube channel!

 

Added to OP.

 

I mean many people use it instead of the spaces and get YAML errors from that and don't know what happens ;D

 

Derp. Thanks

 

xD never use spaces gets them off

 

Tabs you mean? Never use tabs on a YAML file. However, if a plugin uses .json, for example, Factions, you can mismatch tabs and spaces, it will still pick up the response.

I believe this shouldn't be in "Bukkit Help", but rather "Bukkit Discussion", as for you're not requesting help, but rather a tutorial.

Staff has been alerted for a move.

 

Thanks