Setup & Configuration
Top Member Roles
Top Member Roles creates time-windowed leaderboards that automatically assign and remove special roles based on member activity rankings. The most active members in your community receive recognition roles that update in real time as rankings change.
How It Works
InfiniTea tracks member activity across configurable metrics and maintains rolling leaderboards. Members who rank in the top positions receive designated roles automatically. When a member falls out of the top ranks, the role is removed and reassigned to the new top performer.
This creates a dynamic, competitive element that rewards consistent engagement without manual intervention from staff.
Leaderboard Configuration
- Choose activity types: Select which activities count toward the leaderboard (messages sent, voice time, reactions given, etc.). You can weight multiple activity types for a combined score.
- Set the time window: Configure the leaderboard period. Options typically include hourly, daily, weekly, and monthly windows. A weekly window balances between rewarding consistency and giving new members a fair chance.
- Set leaderboard size: Choose how many top members are tracked (e.g., top 3, top 5, top 10). Smaller leaderboards make the reward more exclusive.
- Save your configuration.
Role Rewards
- Select reward roles: Choose which roles to award to top-ranked members. You can assign different roles per rank position (e.g., gold for 1st, silver for 2nd, bronze for 3rd).
- Configure stacking behavior: Decide whether members can hold multiple rank roles simultaneously (if they qualify across different leaderboards) or whether only the highest applies.
- Save. Roles are assigned and removed automatically as the leaderboard updates.
How Role Transitions Work
- When the leaderboard recalculates at the end of each window, roles are redistributed based on new rankings.
- Members who drop out of the top ranks lose the reward role immediately.
- New top performers receive the role within seconds of the recalculation.
- All role changes are logged if you have Logging configured.
Inactivity Detection
If available on your plan, you can configure inactivity detection:
- Detection window: Set how long a member can be inactive before triggering an action.
- Actions: Configure what happens when inactivity is detected (send a DM reminder, log to a staff channel, or remove certain roles).
- This helps identify members who may have abandoned the server and keeps your active community metrics accurate.
Best Practices
- Use weekly or monthly windows for sustainable competition. Hourly or daily windows can feel frantic and may discourage casual members.
- Make reward roles visually distinct (custom color, displayed separately) so the recognition is visible to the whole community.
- Announce the Top Member system to your community so members understand what the special roles mean.
- Monitor for gaming behavior (spam messages to inflate counts) and adjust activity type weights if needed.