Role ReactorAdmin
Schedule Role
Schedule role assignments for specific times. Create one-time or recurring role schedules for events, meetings, or special occasions.
Subcommands
create
Create a new role schedule
list
List all scheduled and recurring roles
cancel
Cancel a scheduled or recurring role
view
View detailed information about a schedule
Parameters
Create Subcommand
users (required)
Comma-separated list of user IDs or mentions
role (required)
The role to assign
type (required)
Type of schedule (one-time, daily, weekly, monthly, custom)
schedule (required)
When to assign (e.g., 'tomorrow 9am', 'monday 6pm', '15 2pm')
duration (required)
How long the role should last (e.g., 1h, 2d, 1w)
reason (optional)
Reason for the role assignment
List Subcommand
No parameters required
This command lists all scheduled and recurring roles
Cancel Subcommand
id (required)
Schedule ID (shortened format like 2802a998...7f7a)
View Subcommand
id (required)
Schedule ID (shortened format like 2802a998...7f7a)
Schedule Types
- One Time: Assign role once at a specific time
- Daily: Assign role every day at the specified time
- Weekly: Assign role every week on the specified day/time
- Monthly: Assign role every month on the specified date/time
- Custom Interval: Assign role at custom intervals
Step-by-Step Example
- Schedule a one-time role assignment:
/schedule-role create
users:@User1,@User2
role:@EventAttendee
type:one-time
schedule:"tomorrow 9am"
duration:4h
reason:"Conference attendance"Create a weekly meeting role:
/schedule-role create
users:@TeamMember1,@TeamMember2
role:@MeetingTime
type:weekly
schedule:"monday 2pm"
duration:2h
reason:"Weekly team meeting"Custom interval schedule:
/schedule-role create
users:@Moderator1
role:@OnCall
type:custom
schedule:"every 3 days at 8am"
duration:24h
reason:"Moderator rotation"Schedule Format Examples
- Tomorrow:
"tomorrow 9am","tomorrow 2:30pm" - Specific day:
"monday 6pm","friday 9am" - Date and time:
"15 2pm"(15th of current month at 2pm) - Time only:
"9am"(next occurrence at 9am) - Minutes from now:
"120"(in 120 minutes)
Permissions Required
- Manage Roles: Required to assign/remove roles from users
- Administrator: Required to create and manage schedules
Troubleshooting
- Schedule not created: Check bot permissions and schedule format.
- Role not assigned: Ensure the bot's role is above the target role.
- Invalid time format: Use supported time formats (see examples above).
- Schedule not found: Make sure the schedule ID is correct.
Related Commands
Best Practices
- Test schedules with short durations first.
- Use clear, descriptive reasons for role assignments.
- Regularly review and clean up old schedules.
- Consider time zones when scheduling.