Achievements

Achievements lets you create unlockable badges for your server with configurable trigger conditions. Members earn achievements by meeting activity thresholds, spending embers, reaching tenure milestones, or completing combinations of goals.

How It Works

Each achievement has one or more triggers that define unlock conditions. When a member's activity satisfies all triggers (using AND/OR logic), the achievement is unlocked and an optional notification is posted. Progress is tracked per-member and persists across sessions.

Configuration

Notification Channel

Select a channel where achievement unlock messages are posted when members earn badges. Leave empty to suppress notifications.

Achievement Types

• Built-in: Pre-defined achievements that can be toggled on or off. These use standard trigger conditions.
• Custom: Fully configurable achievements you create with custom triggers, badges, and conditions.

Creating a Custom Achievement

1. Set a Name and Description for the achievement.
2. Configure Triggers — one or more conditions that must be met:
   • Activity: Requires a count of specific activity events (messages, voice time, reactions, engagement, reputation).
   • Ember Lifetime: Total embers earned over all time.
   • Ember Spent: Total embers spent.
   • Ember Balance: Current ember balance threshold.
   • Time Window: Activity count within a rolling time period (for time-limited challenges).
   • Tenure: Days the member has been in the server.
3. Use AND/OR logic between triggers to create complex unlock conditions.
4. Design the Badge using the visual badge editor (shapes, textures, colors, icons, custom images).

Badge Editor

The achievement badge editor lets you customize the visual appearance of each badge:

• Shape and texture selection
• Banner style and colors
• Icon picker or custom image upload
• Preview before saving

Slash Commands

• /achievements — Open the achievements hub showing your earned badges, progress toward locked achievements, and server-wide statistics. Optional user parameter to view another member's achievements.

Technical Notes

• Achievement progress is evaluated with a cooldown (default 15 seconds between activity checks) to prevent spam.
• Progress tracking is per-user and incremental. Partial progress is saved even before full unlock.
• Achievements cannot be un-earned once unlocked.

Use Cases

• Engagement milestones: Reward members for sending their 1000th message or spending 100 hours in voice.
• Economy goals: Create achievements for spending or earning ember thresholds.
• Loyalty badges: Award tenure-based badges for 30, 90, 365 days in the server.
• Time-limited challenges: Use time window triggers for seasonal or event-based achievements.