Documentation / Levels and XP / Overview
On this page
Overview What XP & Levels is A Mokito Premium feature What is inside The XP & Levels pages The /profile command What it shows Leaderboards When Premium lapses

XP & Levels — Overview Premium

A member engagement system that rewards activity with XP, levels, level-up announcements, level reward roles, and a set of mini-games — all bundled under one Premium-only category.

Overview

XP & Levels is a Mokito Premium feature that turns ordinary server chatter into a progression system. As members send messages, they earn XP. XP translates into levels via a fixed curve. When a member crosses a level, Mokito can post a level-up announcement in a channel you choose and grant a role you have configured as a reward. On top of the message-based XP, four mini-games (Coin Flip, Daily, Counting, Guess the Word, and Trivia) let members earn extra XP through play.

What XP & Levels is

At its core, the system is five things:

A Mokito Premium feature

The entire XP & Levels category is Premium-only. There is no free tier and no freemium split — every sub-feature (XP earning, announcements, rewards, and all five mini-games) requires Mokito Premium. In a server without Premium, the bot does not award XP and the mini-games are dormant. All stored configuration is retained and resumes the moment the server re-subscribes.

Who can configure. Only the server owner and managers (and Mokito admins) can open any XP & Levels settings page. Everyone else receives an access-denied response. Members get read-only views such as the leaderboards and /profile.

What is inside

The XP & Levels category in the guild dashboard has eight sub-pages, listed alphabetically in the sidebar:

PageWhat it does
Coin FlipChannel restrictions for the /coin-flip wager command.
CountingConfigure a cooperative counting channel (mode, rules, milestones, goal).
DailyThe XP range and channel restrictions for the /daily bonus command.
Guess the WordConfigure the definition-guessing game (channel, XP range, timeout, blacklist).
Invite TrackerTrack invite counts and post a top-10 leaderboard to a channel.
RewardsMap levels to roles and choose stack or replace mode.
TriviaConfigure the multiple-choice question game (channel, XP range, cooldown).
SettingsThe level-up message template, the announcement channel, and the XP rate limit.

Members also have a separate Leaderboards area in the member dashboard (read-only) with a Levels & XP board, plus per-game boards for Guess the Word, Trivia, Counting, and the Invite Tracker.

The XP & Levels pages

Each sub-page follows the same pattern: a configuration form that only owners and managers can edit, with a live preview or status card where relevant. The documentation breaks the category into the following pages:

The /profile command

Any member of a Premium server can run /profile to see their own XP profile as a Discord embed. The response is ephemeral — only the caller sees it, so it never clutters the channel. The command takes no arguments and always shows the invoker's own profile.

If the server does not have Premium, the command replies with an ephemeral message explaining that XP & Levels is a Premium feature.

What it shows

The embed contains the following fields, all about the invoking member:

FieldWhat it shows
LevelThe member's current level.
Total XPThe member's accumulated XP.
Server RankThe member's rank on the server's XP leaderboard (#1 is the top member).
Messages SentHow many qualifying messages the member has sent. Wagers and daily claims do not count.
Avg XP / MessageThe member's average XP earned per message.
XP to Next LevelHow much more XP the member needs to reach the next level.
Progress barA 10-block bar showing progress from the current level to the next, with a percentage.

The embed title uses the member's Discord username, the thumbnail is the member's Discord avatar, and the footer shows the server name.

/profile
» (ephemeral embed — only you see it)
   BippyMiester's XP Profile
   Level: 7   Total XP: 1,240   Server Rank: #3
   Messages Sent: 58   Avg XP / Message: 21.4
   XP to Next Level: 180
   ▰▰▰▰▱▱▱▱▱▱  40%
   XP & Levels · Mokito Test Server

Leaderboards

Members can view leaderboards from the member dashboard. The Levels & XP leaderboard shows the top 15 members by total XP, with an Olympic-style podium for the top 3 (gold center, silver left, bronze right), a "Your Rank" pod showing the logged-in member's own rank, level, total XP, and progress, and ranked cards for positions 4–15. The member's own row is highlighted. Guess the Word has a matching leaderboard ranked by correct guesses; the other games have their own boards. Members who have left the server still appear (their user ID is used as a fallback name).

When Premium lapses

If the server's Premium subscription lapses, XP & Levels behaves gracefully: