Skip to main content
ZEON uses a layered permission hierarchy to determine who is allowed to run specific commands. This system operates independently from Discord’s built-in permissions and gives server owners fine-grained control over bot access.

​
The Hierarchy

Permissions are checked from the highest level down. A user at a higher level automatically inherits all permissions from the levels below them.

1. Server Owner

The actual Discord server owner. Full access to everything, cannot be overridden.

2. Extra Owner

Users added via .extraowner add. Full access to everything except managing the Extra Owner list (max 5).

3. Trusted User

Users added via .trusted add. Access to most configuration commands (max 15).

4. Admin

Users with Administrator permission + a top role higher than the bot’s highest role. Access to general module commands.

5. Everyone

All server members. Access to basic utility commands only.
  • Only the actual Server Owner can manage the Extra Owner list. Extra Owners cannot add or remove other Extra Owners.
  • Trusted Users cannot manage Extra Owners — only the Server Owner can do that.
  • The Admin level requires both the Administrator permission and a role positioned higher than the bot’s top role in the role hierarchy.

​
How It Works

Every command in the bot is gated by one of these permission checks. When you run a command, the bot checks your identity against these levels in order:
1

Server Owner Check

Are you the Discord server owner? If yes, you pass every check automatically.
2

Extra Owner Check

Are you in the Extra Owners list for this server? If yes, you are treated like the server owner for bot commands.
3

Trusted User Check

Are you in the Trusted Users list? If yes, you can use most configuration and moderation commands.
4

Admin Check

Do you have the Administrator permission AND is your top role higher than the bot’s? If yes, you can use general module commands.
5

Denied

If none of the above match, access is denied and an error embed is shown.
The specific check used depends on the command. Critical commands like .extraowner require Server Owner level, while module commands like .boostgreet set use the Admin level check (which also passes for all higher levels).