Skip to main content

✨ XP & Levels

The XP system rewards members for participating in chat. Members earn XP per message, level up as they accumulate it, and can unlock roles at the milestones you define: all visible on a server leaderboard.

Overview​

When configured, the agent can:

  • Award XP per message, with a per-member cooldown to prevent farming
  • Announce level-ups in a channel of your choice, or right where the member leveled up
  • Grant role rewards when members reach an XP total, or award XP when members receive a role
  • Publish a server leaderboard members can check with /leaderboard, and their own rank with /rank

Configuration​

To configure XP and levels:

  1. Open your workspace in the Fren One webapp.
  2. In the sidebar under Channels, select the Discord server you want to configure. Its pages open beneath it.
  3. Select Gamification, then the XP & Levels tab.
  4. Toggle "Enable Experience Points (XP) System" on.

Earning​

Controls how members earn XP from chat activity.

OptionDescription
XP per MessageXP awarded for each qualifying message. Default: 10.
Cooldown (seconds)Minimum time between XP awards per member. Default: 60. Set to 0 for no cooldown.

Levels​

Members level up as they earn XP. The Levels toggle (default: on) controls whether level-ups are announced.

OptionDescription
Level-Up Announcement ChannelWhere level-up announcements are posted. Leave unset to announce in the channel where the member leveled up.
Level-Up MessageThe announcement text, e.g. {user} has reached level {level}! 🎉
VariableInserts
{user}A clickable @mention of the member who leveled up.
{level}The level they just reached.

Role rewards​

Role rewards tie roles to XP milestones. Select "Add Reward" to create one; each reward works in one of two directions, chosen with Reward Type:

Reward TypeDescription
Reach an XP total → grant this roleThe agent grants the selected Role once a member's total XP reaches the XP threshold. Default threshold: 100.
Gets this role → award XPThe agent awards XP to award when a member receives the selected Role, however they got it.

Each role can have one reward. Existing rewards can be edited or deleted from the list; deletions stay pending until you save, with an Undo option.

Leaderboard​

Below the settings, a read-only leaderboard shows the top 20 members by XP: rank, name, level, and total XP. It's the same standing members see in Discord.

How it works in Discord​

XP is message-only: voice activity doesn't earn XP. Each qualifying message awards the configured XP, and the per-member cooldown ensures rapid-fire messages don't farm extra points. When a member crosses a level boundary, the agent posts the level-up message to the announcement channel, falling back to the channel the member leveled up in.

Members check their own standing with /rank and the server ranking with /leaderboard. Admins can adjust balances directly with /xp add and /xp remove.

When a threshold reward triggers, the agent grants the role automatically. This requires the agent's role to sit above the granted role in your server's role hierarchy.

Saving your changes​

This page uses a batched save: edits stay local until you select Save in the bar that appears at the bottom of the page. Leaving the page with unsaved changes shows a warning first.

Best practices​

Designing an XP economy
  • Keep the cooldown at or near the 60-second default, with no cooldown, message spam becomes the fastest way to level.
  • Space role-reward thresholds out so early roles come quickly and later ones feel earned.
  • Use a "Gets this role → award XP" reward to give one-time XP bonuses for achievements you grant by hand.
  • Pair XP with 🗺️ Quests and 🎯 Quizzes so members have more ways to earn than chatting alone.
Troubleshooting

Members aren't earning XP?

  • Check that "Enable Experience Points (XP) System" is toggled on and saved.
  • Remember the cooldown: only one XP award per member per cooldown window.
  • Voice activity never earns XP: the system is message-only.

A role reward isn't being granted?

  • The agent's role must be above the reward role in the server's role hierarchy. Move the agent's role up in Discord's role list.
  • Threshold rewards trigger when the member's total XP reaches the XP threshold: check their total with /rank.

Level-ups are announced in the wrong channel?

  • With no Level-Up Announcement Channel set, announcements post wherever the member leveled up. Pick a channel to centralize them.

On this page