Configure experience

Experience tracks member progression inside a Clan Labs community. Staff can award, remove, or set experience; ranks can use configured thresholds; and members can view supported leaderboards and profiles.

Explore Roblox group XP and quota tracking for the progression workflow and dashboard demo.

Before you startCopy link to Before you start

• Ranks are configured in the intended order.
• Staff permission requirements for experience changes are reviewed.
• The plan includes the experience features you intend to use.
• Discord role and Roblox rank automation prerequisites are ready if progression should change them.
• You are an Owner or the Discord server owner.

StepsCopy link to Steps

1. Open Settings → Experience.
2. Set the member-facing name used for the experience system.
3. Under Progress calculation, choose how profiles calculate the percentage toward the next rank:
   • Total experience (default) divides all accumulated experience by the next rank's requirement.
   • Current rank (start at 0%) measures only the experience earned between the current and next rank requirements.
4. Choose the completed and empty progress segments. Edit the example values to preview the percentage and bar; these example values are not saved as member or rank data.
5. Configure the primary-community and Discord boost bonuses when they apply to your community policy.
6. Save the settings.
7. Open Manage → Ranks and set the progression thresholds for each automated rank.
8. Confirm whether the plan includes automatic rank progression before relying on it.
9. Review the permission requirements for ordinary experience changes and direct set operations.

Check the resultCopy link to Check the result

The configured name, progress calculation and progress segments appear in supported member profiles and experience commands. Authorised staff can use the configured /xp command name to add, remove, or set experience, and eligible automatic progression follows the rank thresholds.

1. Record a test member’s current experience and rank.
2. Award a small value.
3. Confirm the profile and leaderboard update.
4. If the threshold is crossed, confirm the intended rank and Discord role behavior.
5. Review the audit entry.

• Limit direct set access; it can bypass the normal progression history.
• Use small test values and keep a record of the expected result.
• Avoid overlapping or decreasing rank thresholds.
• Investigate unexpected bulk changes in the audit log.

Common errorsCopy link to Common errors

• The command is unavailable — check the current plan, trial, command configuration, and disabled channel list.
• A staff member cannot set experience — direct set operations have a higher default requirement than ordinary award operations.
• The progress percentage is unexpected — check the selected calculation and the current and next rank thresholds. Current rank starts from the current rank's requirement; Total experience includes all accumulated experience.
• Experience changes but rank does not — review thresholds, automatic progression entitlement, Open Cloud, and rank hierarchy.
• Progression is frozen — an active suspension can block experience bonuses or rank progression.

Next, configure quotas or learn the experience and quota workflow.