Permissions
Ayana offers a advanced permission system putting you in control of how Ayana will function on your server. There are some key things you need to understand so you can setup your perms correctly. So please take the time to read this page and understand how permissions work. It is well worth the time.
Permission Nodes
Permission nodes represent Ayana commands and features that you can control. Each permission node can be in one of three states per permission level. These states are:
| State | Description |
|---|---|
State Granted | Description The permission node is in the granted(allowed) state |
State Revoked | Description The permission node is in the revoked(denied) state |
State Neutral | Description The permission node hasn’t been overridden |
Neutral
Permission nodes that haven’t been Granted or Revoked on a given permission level are in their neutral state. Such permission nodes will not affect, or override other permission levels.
Permission Levels
Permission levels define where permission nodes take effect on. This allows you to deny a permission for the entire server but allow it for certain users. The permission level order from least specific to most specific is as follows:
| Level | Description |
|---|---|
Level Server | Description Affects the entire server |
Level Channel | Description Affects all users executing commands in a specific channel |
Level Role | Description Affects all users possessing a specific role |
Level User | Description Affects a specific user |
Advanced Levels
There are also two advanced permission levels that exist, but are rarely used. You will probably not need these two. These two levels are the most specific levels in Ayana.
| Channel | Description |
|---|---|
Channel Role Channel | Description Affects all users possessing a specific role executing commands in a specific channel |
Channel User Channel | Description Affects a specific user in a specific channel |
Permission Inheritance
Each permission level in a non-neutral state overrides all permission levels above it, (i.e: Channel overrides Server; User overrides Role, Channel and Server)
If a permission node is in it's neutral state on all permission levels, then the permission nodes default will be used. A permission nodes default is defined by the Developers of Ayana, these defaults are setup to be secure, safe, and not give away unnecessary permissions. Some examples of this are:
- 1:The guild.ban permission is defaulted to revoked, so unless a Server Administrator grants this permission, nobody can use the ban command.
- 2:The music.all permission is defaulted to granted, so anyone can use Ayana's music system