Comprehensive role management with scheduled assignments, temporary roles, Discord clan tag-based roles, and cross-server syncing.

Features

Scheduled Role Assignments
Add or remove roles at specific times with optional recurring schedules.

| Schedule Type | Description |
|---------------|-------------|
| Once | One-time execution |
| Daily | Repeats every 24 hours |
| Weekly | Repeats every 7 days |
| Monthly | Repeats on same day each month |

| Target Type | Description |
|-------------|-------------|
| User | Single specific user |
| Role | All members with a specific role |
| Everyone | All members in the server |

Temporary/Timed Roles
Assign roles for a limited duration, then automatically reverse:
- If original action was add → role is removed on expiry
- If original action was remove → role is added on expiry

Use cases: Temporary mutes, trial access, event roles, punishment durations.

Tagged Roles (Clan Tag Integration)
Automatically assign roles based on Discord clan tags:
- Monitors user's primaryGuild.tag
- Adds role if tag matches, removes if not
- Checks on member join/update events
- Incremental processing every 30 seconds

Cross-Server Role Syncing
Synchronize role assignments between multiple Discord servers:

| Sync Type | Description |
|-----------|-------------|
| One-way | Source → Target only |
| Bidirectional | Source ↔ Target (both ways) |

Use cases: Multi-server communities, partner servers, staff sync, VIP access.

Background Processing

| Task | Frequency | Purpose |
|------|-----------|---------|
| Role Processor | 30 seconds | Process scheduled, temporary, and tagged roles |

Notes
- Tagged roles use Discord's primaryGuild feature (clan tags)
- Tag matching is exact and case-sensitive
- Role syncs require bot to be in both servers
- Bidirectional syncs can cause loops if misconfigured