> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Main Roles

> Designate and protect your most critical server roles from abuse and compromise.

The **Main Roles** system is a unique security layer that extends Antinuke protection specifically to your server's most important roles. By registering a role as a "Main Role", ZEON enforces strict, unbypassable protections on that role across the server.

<Note>
  **Required Permission:** `is_server_owner` — Only the Server Owner and Extra Owners can configure Main Roles.
</Note>

***

## What Does a Main Role Do?

When you register a role as a Main Role, two powerful background security filters automatically activate to protect it:

### 1. Permission Stripping (Anti-Abuse)

If a rogue admin or compromised account attempts to give a Main Role (or the `@everyone` role) dangerous permissions (like `Administrator`, `Ban Members`, or `Manage Webhooks`), the **Default Protection Filter** will instantly strip those dangerous permissions away. This prevents attackers from turning a harmless role into an admin role.

### 2. Mention Spam Protection

If a user attempts to mass-ping a Main Role, the **Anti-Mention Filter** will automatically trigger. It will instantly delete the message (even if it was sent via an unauthorized external User App or Webhook) and punish the attacker based on your `mention_spam` limits.

***

## Commands

You can register up to **10 Main Roles** per server.

| Command                  | Description                                            |
| :----------------------- | :----------------------------------------------------- |
| `.mainrole add @role`    | Registers a role as a protected Main Role              |
| `.mainrole remove @role` | Removes a role from the Main Role protection list      |
| `.mainrole show`         | Displays a paginated list of all registered Main Roles |
| `.mainrole reset`        | Clears the entire list of Main Roles                   |

<Warning>
  **Hierarchy Requirement:** In order for the bot to protect a Main Role and strip dangerous permissions from it, the bot's own role must be placed **higher** in the server hierarchy than the Main Role you are protecting.
</Warning>