Milestones

Levlix provides two milestone systems that track progress and reward engagement: User Milestones for individual achievements and Server Milestones for community-wide collaborative goals. Both systems award Levlix Points upon completion.

User Milestones

User milestones track your personal activity across five categories and reward you as you hit specific thresholds.

Activity Categories

Each category has multiple levels. Every level requires a higher activity threshold and awards a larger point reward. Activity is tracked automatically. There is nothing to configure or enable as a user.

Viewing Your Milestones

/milestones overview

Opens an interactive view with navigation buttons to switch between an overview of all categories and detailed breakdowns of each one. The view includes:

• Progress bars for each category
• Current level and next level target
• Points earned and points available
• Motivational messages based on your progress
• Activity-specific tips

Options:

Viewing All Milestone Definitions

/milestones list

Lists every milestone level for every category, including the requirement amount and point reward. Your current level is highlighted, and completed levels are marked with a checkmark.

Milestone Leaderboard

/milestones leaderboard

Shows the top 10 members ranked by total milestone levels across all categories. If you are not in the top 10, your rank is displayed separately at the bottom.

Server Milestones

Server milestones are community-wide goals created by administrators. The entire server contributes collectively, and every contributor earns a reward when the target is reached.

How It Works

1. An administrator creates a milestone with a title, type, target amount, and reward.
2. The milestone becomes active immediately. Member activity that matches the milestone type counts as contributions.
3. When the total contributions reach the target, the milestone is completed.
4. Every member who contributed can claim the reward.

Milestone Types

User Commands

View Active Server Milestones

/server-milestone list

Shows all active server milestones with:

• Title and type
• Progress bar and percentage
• Your personal contribution amount and percentage
• Reward amount
• Expiration date (if set)

Options:

View Milestone Details

/servermilestones server-milestone-details milestone_id: 1 show_top_contributors: True

Shows detailed information about a specific milestone, including the full description, status, creation date, and expiration. When show_top_contributors is enabled, displays a ranked list of the top 20 contributors with trophy icons for the top 3.

Claim a Reward

/server-milestone claim milestone_id: 1

Claims your point reward for a completed server milestone. You must have contributed at least once to be eligible.

View Your Contributions

/servermilestones my-server-milestones

Shows every server milestone you have contributed to, grouped by active and completed. Unclaimed rewards are highlighted with a claim prompt. Displays total statistics at the bottom.

Admin Commands

All admin commands require Administrator permission.

Creating a Server Milestone

/server-milestone create title: "10K Messages Challenge" description: "Let's reach 10,000 messages together!" milestone_type: Messages target_amount: 10000 reward_per_contributor: 200 expires_days: 30

Listing Server Milestones

/server-milestone list
/server-milestone list include_completed: True milestone_type: Messages

Editing a Server Milestone

/server-milestone edit milestone_id: 1 title: "Updated Title" target_amount: 15000 reward_per_contributor: 300 is_active: True

All parameters except milestone_id are optional. Only provide the fields you want to change. Completed milestones cannot be edited.

Deleting a Server Milestone

/server-milestone delete milestone_id: 1

Permanently removes the milestone and all associated contribution data.

Viewing Milestone Details (Admin)

/server-milestone details milestone_id: 1 show_contributors: True

Same as the user details command but includes the creator name and reward claim statistics.

Updating Progress Manually

/server-milestone update-progress milestone_id: 1 user_id: "123456789" amount: 50

Used for custom milestone types where activity is not tracked automatically. The user_id parameter accepts a Discord user ID as text. Use the server ID for anonymous contributions.

Permissions Reference

Tips for Administrators

• Set achievable targets first. A milestone that takes two weeks to complete builds momentum. One that takes three months feels unreachable.
• Rotate activity types. Alternate between message, voice, and reaction milestones so every type of community member gets a chance to contribute.
• Use expiration dates. Time-limited milestones create urgency that drives participation.
• Combine with events. Run a server milestone during a seasonal event for compounding engagement.
• Announce completions. Use the Notification System to celebrate when a milestone is reached.
• Monitor contributions. Use /server-milestone details with show_contributors: True to identify your most active community members.

Important Notes

• User milestones are tracked automatically. No setup is required. Members earn progress simply by participating.
• Server milestones count activity from the creation date forward. Pre-existing activity is not retroactively counted.
• Custom milestones require manual progress updates by an administrator. All other types are tracked automatically.
• Rewards must be claimed. Completed milestones do not auto-distribute rewards. Members must use /server-milestone claim to receive their points.
• Contribution percentages are calculated relative to the total progress, not the target. If a milestone is at 5,000/10,000 and you contributed 500, your percentage is 10% of the current total.