Role Management - ZEON Documentation

ZEON provides comprehensive role management tools, from simple single-user assignments to full-scale mass role operations across your entire member base.

Single Role Operations

Manage roles for individual members.

Command	Description
`.role add <role> <member>`	Adds a role to a member.
`.role remove <role> <member>`	Removes a role from a member.
`.role temp <member> <role> <duration>`	Gives a temporary role that auto-removes after the duration (max `7 days`).
`.role create <name>`	Creates a new empty role with the specified name.
`.role delete <role>`	Permanently deletes a role from the server.
`.role rename <role> <name>`	Renames an existing role.
`.role colour <role> <colour>`	Changes a role’s color (accepts hex codes like `#FF5733`).
`.role icon <role> [emoji/url]`	Sets an icon for a role. Accepts emojis, image URLs, or message attachments. Leave empty to remove the icon.

Dangerous Role Protection: ZEON will refuse to assign roles that have dangerous permissions (like Administrator, Ban Members, etc.) to prevent accidental privilege escalation.

Mass Role Operations

Apply or remove a role from large groups of members at once. These operations show an estimated completion time and require confirmation before executing.

Adding Roles

Command	Description
`.role humans <role>`	Adds the role to all human (non-bot) members.
`.role bots <role>`	Adds the role to all bot members.
`.role all <role>`	Adds the role to every member in the server.

Removing Roles

Command	Description
`.rrole humans <role>`	Removes the role from all human members.
`.rrole bots <role>`	Removes the role from all bot members.
`.rrole all <role>`	Removes the role from every member in the server.

Task Management

Command	Description
`.role taskcancel`	Cancels the currently running mass role operation in this server.

Only one mass role task can run per server at a time. If you start a new one while another is running, it will be rejected. Use .role taskcancel to abort a stuck task.