Tiers Cog

The Tiers cog implements a custom experience point (XP) and leveling system. Members gain XP through activity and unlock roles and perks as they progress through tiers.

Features

XP and Leveling

  • Activity-based XP awarded per message
  • Configurable XP ranges per message
  • Cooldown system prevents spam-gaming
  • Per-user and per-channel XP exclusions

Automatic Role Rewards

  • Assign roles at XP thresholds
  • Sync roles if assignments change
  • Role persistence across server leaves

Management

  • Antibot message spam protection
  • Role synchronization on member rejoin
  • Blacklist users or channels from XP system
  • Manager oversight of tier operations

Commands

Command Description
/tiers Main tiers system commands

The tiers system uses configuration for management rather than direct commands.

Configuration

Customize your tiers/leveling system:

  • Enabled - Toggle the tiers system
  • Log Channel - Channel where tier activities are logged
  • No XP Roles - Roles that don’t gain XP
  • No XP Channels - Channels where XP is not awarded
  • Min XP Per Message - Minimum XP per message
  • Max XP Per Message - Maximum XP per message
  • Manager Roles - Roles that can manage tiers
  • Blacklisted Users - Users excluded from tiers system

Role Rewards

Assign roles automatically at XP thresholds. Configure tier levels and corresponding roles via /config cog Tiers.

Troubleshooting

  • XP Not Gaining: Check role and channel settings
  • Role Not Assigned: Verify role hierarchy
  • Leaderboard Issues: Recalculate rankings
  • Performance: Monitor database load