permissions.yml

The structure of the permissions file is not very complicated. This should be familiar for PEX (or other similar permissions plugins for bukkit/spigot) users. The basic structure should look like this:

groups:
  Builder:
    rank: 1000
    default: true
    display: '&7[Builder]'
    prefix: '&7[B]'
    suffix: ''
    inheritances: []
    permissions: []
  Mod:
    rank: 500
    default: false
    display: '&1[Mod]'
    prefix: '&1[M]'
    suffix: ''
    inheritances:
    - Builder
    permissions:
    - bungeeperms.promote
    - bungeeperms.demote
    - bungeeperms.user.groups
  Admin:
    rank: 1
    default: false
    display: '&4[Admin]'
    prefix: '&4[A]'
    suffix: ''
    inheritances:
    - Builder
    - Mod
    permissions:
    - bungeeperms.*

Group nodes

• default: if this is a default group (automatically added to user on first join)
• inheritances: list of inherited groups (also recursive)
• permissions: the permissions of this group
• rank: the lower the number the higher the rank
• weight: the weight of a group (used for main group detection); order same as rank property
• display: the display text of a group
• prefix: the prefix of a group
• suffix: the suffix of a group

User nodes

• groups: the groups the player is in.
• timedgroups: the timed groups the player is in.
• permissions: the extra permissions of the user
• timedpermissions: the extra timed permissions of the user
• display: the display text of the user
• prefix: the prefix of the user
• suffix: the suffix of the user

Note in BP4 the permissions.yml is split into 2 files for groups and users respectively: permissionsusers.yml and permissionsgroups.yml.