InfiniTeaInfiniTea Docs
Setup & Configuration

Leveling System

InfiniTea's Leveling System tracks member activity across multiple dimensions and rewards progression with roles, rank cards, and achievements. The system is organized into dedicated configuration panels for granular control.

System Overview

The leveling system tracks XP independently for six activity types:

  • Message Activity: XP from sending messages in text channels.
  • Voice Activity: XP from time spent in voice channels.
  • Reaction Activity: XP from adding reactions.
  • Engagement Activity: XP from interactive participation.
  • Community Reputation: XP from receiving /give_rep from other members.
  • Staff Reputation: XP from receiving /give_staff_rep from administrators.

Each type can be independently configured with its own rates, thresholds, and channel restrictions.

Configuration Panels

The leveling system is split into dedicated panels in the dashboard:

XP Rates

Configure base XP amounts, growth curves, event intervals, and channel allow/blocklists per activity type. Controls how quickly members level up.

XP Drops

Configure automatic bonus XP events that spawn in active channels. Includes lottery multipliers and per-activity drop settings.

Role Rewards

Assign Discord roles automatically when members reach XP level thresholds. Supports per-activity rewards and shared aggregation (Sum, Average, Median) across multiple types.

Rank Card

Customize the visual rank card design and configure jump link buttons. Includes a full visual editor for colors, layouts, and backgrounds.

Achievements

Create unlockable badges with configurable triggers (activity, ember, tenure, time-window). Independent progression system that complements XP leveling.

Slash Commands

  • /rank or /card — View your rank card with current level, XP, and leaderboard position.
  • /leaderboard — View the server leaderboard. Optional user parameter for individual stats.
  • /post_leaderboard (Manage Messages) — Post a static leaderboard with refresh button. Supports up to 9 activity types including Ember leaderboards.
  • /xp add|remove|reset (Administrator) — Manually adjust member XP.
  • /drop (Administrator) — Trigger a manual XP drop for testing.
  • /give_rep <user> — Give 1 community reputation to a member.
  • /give_staff_rep <user> (Administrator) — Give 1 staff reputation to a member.
  • /sync role-rewards (Administrator) — Force immediate role reward sync.

Context Menu Commands

  • View Rank Card (right-click user) — Show a member's rank card.
  • Give Reputation (right-click user) — Give 1 community rep.
  • Give Staff Reputation (right-click user, Administrator) — Give 1 staff rep.

Tips

  • Start with moderate XP rates and adjust after observing how quickly members progress during the first week.
  • Use channel blocklists to prevent XP farming in spam, bot, or AFK channels.
  • Voice XP intervals should be longer than message intervals since voice is passive participation.
  • Combine role rewards with channel permissions to create progressive access as members level up.