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 project in the Fren One webapp.
  2. Select the Discord server you want to configure.
  3. In the sidebar under Agent Configuration, 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