Autorole
Autorole
Overview
The autorole command allows server administrators to configure, view, and manage automatic role assignment for new members joining the server. When set up, specified roles will be automatically assigned to new members upon joining.
Syntax
,autorole <subcommand> [parameters]
Subcommands
Set
Sets the role that will be automatically assigned to new members.
,autorole set <role>
| Parameter | Type | Required | Description |
|---|---|---|---|
| role | Role Mention/ID | ā | The role to automatically assign to new members |
Show
Displays the currently configured auto-role for the server.
,autorole show
Remove
Removes the configured auto-role setting.
,autorole remove
Command Aliases
- Main command:
ar - Set:
s - Show:
sh,v,view - Remove:
r,del,rm,d
Response
The command provides embedded responses for each operation:
- Set: Confirms the role that has been set as the auto-role
- Show: Displays the currently configured auto-role and its details
- Remove: Confirms the removal of the auto-role configuration
Permissions
Bot Needs:
- Manage Roles
- Send Messages
- Embed Links
User Needs:
- Manage Roles
Examples
,autorole set @Member # Sets the "Member" role as auto-role
,autorole set 123456789 # Sets role by ID as auto-role
,autorole show # Shows current auto-role configuration
,autorole remove # Removes auto-role configuration
Common Issues
| Error | Cause | Solution |
|---|---|---|
| "Invalid role" | Role mention/ID is incorrect or role doesn't exist | Verify the role exists and use a valid mention or ID |
| "No auto-role is currently set" | No auto-role has been configured | Set an auto-role using the set subcommand |
| "The previously set auto-role no longer exists" | Configured role was deleted | Set a new auto-role |
Notes
- Only one auto-role can be configured at a time
- The bot must have a role higher than the auto-role to assign it
- Role hierarchy must be considered when setting up auto-roles
- Auto-role configuration is server-specific
Last Updated: 2024-12-04