Role ReactorAdmin
Temp Roles
Manage temporary role assignments. Assign roles that automatically expire after a set time, perfect for events, timeouts, or temporary access.
Quick Start
Perfect for:
- Event winners - Give VIP access for a limited time
- Moderation - Temporary timeouts or restrictions
- Trial periods - Let users try premium features
- Special occasions - Holiday roles or celebration access
Subcommands
assign
Assign a temporary role to users
list
List all active temporary roles
remove
Remove a temporary role early
Parameters
Assign Subcommand
users (required)
Comma-separated list of user IDs or mentions
role (required)
The role to assign temporarily
duration (required)
How long the role should last (e.g., 1h, 2d, 1w, 30m)
reason (optional)
Reason for assigning the temporary role
notify (optional)
Send DM notification to users (default: false)
notify-expiry (optional)
Send DM notification when role expires (default: false)
List Subcommand
user (optional)
The user to check (leave empty for all users)
Remove Subcommand
users (required)
Comma-separated list of user IDs or mentions
role (required)
The temporary role to remove
reason (optional)
Reason for removing the temporary role
Step-by-Step Examples
- Assign a temporary role:
/temp-roles assign
users:@User1,@User2
role:@VIP
duration:7d
reason:"Event winners"
notify:true
notify-expiry:true- The bot will assign the role and automatically remove it after the duration.
- List all temporary roles:
/temp-roles list- List for specific user:
/temp-roles list user:@username- Remove a temporary role early:
/temp-roles remove
users:@User1,@User2
role:@VIP
reason:"Early removal requested"Duration Formats
- Minutes:
30m,120m - Hours:
1h,6h,24h - Days:
1d,7d,30d - Weeks:
1w,2w,4w
Permissions Required
- Administrator: Required to manage temporary roles
- Manage Roles: Required to assign/remove roles from users
Troubleshooting
- Role not removed after duration: Ensure the bot is online and has Manage Roles permission.
- User not found: Double-check user IDs or mentions.
- Invalid duration: Use supported formats (e.g., 1h, 2d, 1w).
- Permission denied: You need Administrator permissions to manage temporary roles.
Related Commands
Best Practices
- Use for time-limited access or moderation actions.
- Enable notifications to keep users informed.
- Test with short durations first.
- Regularly monitor active temporary roles.