Tutorials

Achievement Milestones (Counted)

Use /achievements create for stat-based badges and /achievements create_event for event badges.

Example: Message Milestone Badge

/achievements create
name:Message Bronze
description:Awarded for sending 100 messages
icon_path:assets/badges/msg_bronze.png
type:messages
threshold:100
tier:1

Event Achievements

There are two event patterns:

  • first_* events: one winner per server.
  • counted events: many winners per server.

Reaction Milestones

Use reactions_count with custom target counts:

/achievements create_event event_type:reactions_count target_count:1000
/achievements create_event event_type:reactions_count target_count:10000
/achievements create_event event_type:reactions_count target_count:100000
/achievements create_event event_type:reactions_count target_count:1000000

First-Event Example

/achievements create_event event_type:first_reaction

Suggested Workflow

  1. Create badge assets first.
  2. Create event/stat definitions.
  3. Test with a private channel or test server.
  4. Verify award display in /achievements my_badges.