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 System

  • Activity Tracking: Gain XP from messages and voice
  • Cooldown System: Prevent spam for XP
  • Role Multipliers: Different XP rates per role
  • Channel Filtering: Exclude certain channels

Level Progression

  • Tier Roles: Automatic role assignment at levels
  • Custom Rewards: Configurable role rewards
  • Rank Display: Show current level and progress
  • Leaderboard: Top active members

Advanced Features

  • Voice XP: Gain XP from voice channel time
  • Bonus Events: Temporary XP multipliers
  • Role Persistence: Maintain levels across leaves/rejoins
  • Anti-Abuse: Detection of XP farming

Management Tools

  • XP Adjustment: Manually add/remove XP
  • Role Synchronization: Fix role assignments
  • Reset Options: Clear XP for users
  • Audit Logging: Track all XP changes

Commands

Command Description Permissions
/tiers rank View your current rank None
/tiers leaderboard View top members None
/tiers add <user> <xp> Add XP to user Manager
/tiers remove <user> <xp> Remove XP from user Manager
/tiers reset <user> Reset user’s XP Manager

Configuration

  • Enabled: Toggle the tiers system
  • XP Rate: Base XP per message
  • Cooldown: Time between XP gains
  • Voice Multiplier: XP rate in voice channels
  • No XP Roles: Roles that don’t gain XP
  • No XP Channels: Channels that don’t give XP

Role Rewards

Configure automatic role assignment:

  • Level Thresholds: XP required for each tier
  • Role IDs: Which roles to assign
  • Stacking: Whether to keep previous roles

Anti-Abuse Measures

  • Rate Limiting: Maximum XP per time period
  • Duplicate Detection: Prevent copy-paste farming
  • Channel Hopping: Voice channel abuse prevention
  • Audit Trails: Log suspicious activity

Integration

Works with:

  • Economy: XP bonuses for economic activity
  • Reputation: Helper XP multipliers
  • Moderation: XP penalties for violations
  • Verification: Post-verification XP

Best Practices

  1. Balanced Rates: Set appropriate XP gain rates
  2. Meaningful Rewards: Make tier roles valuable
  3. Community Goals: Encourage positive activity
  4. Regular Review: Adjust thresholds as community grows
  5. Transparency: Explain how XP works

Technical Details

XP Calculation

  • Base XP: 10-100 per message (configurable)
  • Voice XP: Per minute in voice channels
  • Multipliers: Role and event bonuses
  • Deductions: Penalties for violations

Persistence

  • Database Storage: All XP data persisted
  • Backup System: Regular data backups
  • Migration: Handle role changes smoothly
  • Recovery: Restore lost progress

Troubleshooting

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