Setup and Configuration
Role Rewards
Role Rewards automatically grants Discord roles to members when they reach configured XP level thresholds. Roles can be assigned per activity type or across shared (aggregated) activity, with optional stacking behavior.
How It Works
As members earn XP and level up across tracked activity types, InfiniTea checks their level against configured role reward thresholds. When a member's level meets or exceeds a threshold, the associated role is granted. If stacking is disabled, previous level roles are removed when a higher one is earned.
Configuration
Activity Scope
Role rewards can be configured in two modes:
- Per-Activity: Set role thresholds independently for each activity type (Message, Voice, Reaction, Engagement, Community Reputation, Staff Reputation).
- Shared: Aggregate XP across multiple activity types using a calculation method, then apply shared level thresholds.
Shared Aggregation Methods
When using shared role rewards, choose how XP from multiple activities is combined:
- Sum: Total XP from all selected activities added together.
- Average: Mean XP across selected activities.
- Median: Median value across selected activities.
Adding Role Rewards
For each reward entry, configure:
- Activity Type (or Shared scope)
- Level Threshold: The level at which this role is granted.
- Role: The Discord role to assign.
- Stacking: Whether members keep lower-level roles when earning higher ones, or only hold their highest earned role.
Slash Commands
/sync role-rewards(Administrator) — Immediately sync role reward assignments for all members. Optionalactivity_typefilter andusertarget for focused syncs./give_rep <user>— Give 1 community reputation point to a member (contributes toward Community Rep role rewards)./give_staff_rep <user>(Administrator) — Give 1 staff reputation point to a member.
Context Menu Commands
- Give Reputation (right-click user) — Same as
/give_rep. - Give Staff Reputation (right-click user, Administrator) — Same as
/give_staff_rep.
Use Cases
- Progressive access: Grant channel access roles as members level up (Level 5 = general chat, Level 10 = media, Level 20 = VIP).
- Visual recognition: Assign colored roles at milestones so active members stand out in the member list.
- Staff reputation tracking: Use Staff Reputation rewards to recognize consistently helpful members.
- Multi-activity rewards: Use shared aggregation to reward well-rounded members who participate across multiple activity types.
Permissions Required
- Manage Roles: InfiniTea's role must be above all reward roles in the server hierarchy.