When a member levels up, Mokito can post a message in a channel you choose. You control the wording with a template and three tags.
Level-up announcements are an optional but popular part of the XP & Levels system. When a member's XP crosses a level threshold, Mokito posts a message in the channel you have configured, using a template you have written. If you leave the channel blank, members still level up — they just do so silently.
Announcements are configured on the XP & Levels → Settings page. Only the server owner and managers can change them. For how XP is earned and how leveling works, see XP & Leveling.
The level-up message is a free-text field up to 2000 characters (Discord's message cap). You write it once and it is used for every level-up. Three template tags let you inject the member's name and the new level. If you leave the field blank, Mokito uses the default:
🎉 {mention} just reached level {level}!
Three tags are supported. Tags are case-sensitive — use them exactly as written below. Unknown tags (typos) are left in place so you can spot them in the announcement.
| Tag | What it inserts | Example |
|---|---|---|
{user} | The member's Discord username (no mention, no tag). | BippyMiester |
{level} | The new level the member just reached. | 7 |
{mention} | A Discord mention that pings the user who leveled up. | @BippyMiester |
{user}, which just prints a name, {mention} actually pings the member who leveled up. Use it when you want the level-up message to get the member's attention.
The Settings page has a live preview that re-renders against sample data as you type. The sample uses a placeholder username and a placeholder level so you can see exactly how the message will look when it posts. Tags are rendered in the preview, so typos are visible before you save.
The announcement channel is the channel where Mokito posts level-up messages. Type a channel name or paste a channel ID. Only text channels and announcement channels are listed — threads, voice channels, stage channels, forum channels, and category channels cannot be used.
If you leave the channel blank, level-up announcements are disabled. Members still earn XP and level up; they just do so without a public message. Level reward roles are unaffected by this setting.
If you save a channel and that channel is later deleted or becomes inaccessible to Mokito, the Settings page shows an amber warning prompting you to pick a new channel. The saved channel ID remains until you change it — Mokito does not silently clear it — but level-up messages will fail to post until you fix it.
To turn off level-up announcements without deleting your template, clear the channel field and save. The template is preserved; when you re-select a channel and save, announcements resume with the same template.
Level-ups are not announced at the exact moment a message is sent. A background task runs every minute and scans for members whose level has advanced since the last pass. For each member who leveled up:
This means a level-up announcement can lag up to about a minute behind the actual level crossing. If a member crosses multiple levels in one jump, only one announcement is posted — for the highest level reached — but every reward role for every crossed level is still granted.
| Limit | Value |
|---|---|
| Template length | Up to 2000 characters. |
| Supported tags | {user}, {level}, {mention}. Case-sensitive. Unknown tags left in place. |
| Default template | 🎉 {mention} just reached level {level}! |
| Supported channel types | Text channels and announcement channels only. |
| Posting lag | Up to ~1 minute (background task runs every minute). |
| Multi-level jump | One announcement for the highest level reached; all crossed reward roles granted. |
| No channel configured | Announcements disabled. Members still level up. Rewards still granted. |
| Stale channel | Amber warning on the Settings page. Posts fail silently until you pick a new channel. |
| Premium required | Announcements are part of the XP & Levels category, which is Mokito Premium-only. |