Dispatch.IO Logo
Server setup

Achievements

Turn achievements on, pick the banner channel, set the XP bonus and the banner, switch achievements off and set rewards.

Updated on October 22, 2026#succès#achievements

Search the documentation

Type a keyword: a command, a module, a dashboard page…

Achievements are over 190 goals your members unlock by being active: messages, voice, levels, streaks, community, secrets… Each unlock is announced with a banner in the channel of your choice. The Achievements page sets the activation, the channel, the XP bonus, the banner, which achievements are available and their rewards.

It is for administrators: the server owner and members with the Administrator or Manage Server permission. What unlocks, how and when is explained in the Achievements module.

Overview of the page

Open Configuration > Achievements in the menu (under Flames) or the Achievements tile of the modules hub on the server home.

Server Achievements page with the buttons, the figures and the System block
The Achievements page of the Café des Devs server.
  1. Send a test posts a real banner in the achievements channel (see Send a test). See my page opens your public achievements page in a new tab.
  2. Figures: System (Enabled or Disabled), Channel (Set or None), Active achievements (out of 191) and Unlocks (total achievements unlocked on the server).
  3. The System block: activation, channel and XP bonus.

Below these blocks come the Banner and the catalog of achievements, one card per category.

Turn achievements on and pick the channel

SettingWhat it doesDefault
Enable achievementsMembers unlock achievements by being active. The counters (messages, voice, reactions…) only run while the system is on.Off
Achievements channelChannel where unlock banners are posted (text or announcement channel). Without a channel, achievements are unlocked without announcement.None
XP bonusEach member achievement unlocked gives level XP by rarity, when the level system is on.On

The + button next to the channel (Create the channel) creates a succes channel and selects it right away: "Channel #… created and selected.". This channel is saved immediately, without the save bar.

The XP bonus of each rarity is shown under the switch:

RarityDefault XP
Common+25
Uncommon+75
Rare+150
Epic+400
Legendary+1000
Mythic+2500
Note

No burst of banners when you turn it on

When you turn achievements on, what your members already did (level, streak, seniority, invites…) is unlocked silently: no banner, no role, no XP. Only the achievements earned afterwards are announced and rewarded. Details: the silent catch-up.

The Achievements module of the modules hub is the same switch as Enable achievements.

The banner

The Banner block picks the background of your server's achievement banners.

Banner block with the upload zone, the link, the dark veil and the preview by rarity
The banner and its preview (Rare rarity).
  1. Upload a picture: click or drop a file (PNG, JPG, WEBP or GIF, 5 MB max, 1200 × 400 recommended). "Picture uploaded: remember to save."
  2. or paste a picture link (https://…, public address). The Back to the default banner arrow removes the picture.
  3. Dark veil: darkens the picture to keep the text readable. On by default, greyed out while there is no picture.
  4. Preview by rarity: the real banner drawn by the bot, for a sample achievement of each rarity (Rare by default). The badge says Server picture or Default picture.

Background order on a banner:

  1. the member's personal background, if they are Premium (Achievements slot of the personal images);
  2. the picture of this block;
  3. the global Dispatch.IO banner;
  4. the server's welcome image.
MessageCause
"This file is not a picture."The chosen file is not a picture.
"Picture too large (5 MB max)."File over 5 MB, or picture still too heavy after compression.
"Picture link refused (public https, PNG/JPG/WEBP/GIF)."The link is not a public https picture.
"Preview unavailable (the bot may be offline)."The bot did not answer: the preview is drawn by the bot itself.

Choose the available achievements

The catalog lists the 191 achievements, one card per category. They are all on by default, and new achievements added to the bot start on.

Achievements catalog with the search, the type filter and the Messages category unfolded
The catalog: search, filter and the Messages category.
  1. Search: "Search an achievement or a category…" looks in names and descriptions, and opens the matching categories.
  2. Achievement type: All, Members, Account or Server.
  3. For each category: the X / Y on badge and the Enable all switch, which turns the whole category off or back on.
  4. See the … achievements unfolds the list. Each achievement has its medal, name, description, rarity, points, the XP it gives (member achievements, bonus on), its reward role if any, and its own switch.

Secret achievements have the Secret badge: on this page you see their name and condition, but your members only discover them by unlocking them.

TypeUnlocked byCategories
MembersA member, on this serverMessages, Voice, Levels, Streaks, Social, Media, Community, Music, Dispatch.IO, Loyalty, Secrets
AccountThe Discord account, once for every serverAccount (suffix " · Account")
ServerThe whole server, togetherServer (suffix " · Server")

An achievement switched off is no longer unlocked or announced on your server and disappears from the public page. Switching it back on starts a silent catch-up: members who already meet its condition get it without a banner.

Achievement rewards

Each member achievement can give a reward when it is unlocked. On its card, click Add a reward (or Edit the reward). The button is greyed out while the achievement is off.

Reward dialog with the role given and the XP given
The reward of “Golden voice”: the Voix du café role.
FieldWhat it does
Role givenRole given to the member when they unlock the achievement. A role with moderation or administration rights, or above the bot's role, is not given.
XP givenFrom 0 to 100,000. Empty: the rarity's amount. 0: no XP. When the XP bonus is off, only the role is given.

Remove clears the role and the XP, Confirm closes the dialog. The reward is only saved with the rest of the page. The text under the search bar shows the number of rewards set.

Account and server achievements give no reward, and neither does an achievement unlocked by the silent catch-up.

Send a test

The Send a test button posts a real banner in the achievements channel: the one of the sample achievement of the rarity chosen in the preview, in your name, with the configured reward. Nothing is unlocked and nothing is given.

  • A saved channel is required: otherwise "Pick and save an achievements channel first."
  • One test per server every 30 seconds, for all administrators: "Wait a few seconds before another test."
  • Success: "Test banner sent to the achievements channel."

Save

Click Save changes in the bottom bar: "Achievements settings saved.". The bot applies the settings immediately, and the change shows in the Configuration logs ("Mise à jour de la configuration des succès", Levels filter; this label is in French on both sites).

MessageCause
"Could not save the achievements settings."Saving failed: try again.
"You are not allowed to manage this server."Your account cannot manage this server.
"Could not create the channel."The bot could not create the channel (often the Manage Channels permission).
"The test could not be sent."The bot could not post the test banner (channel deleted, permissions).
  • Achievements: rarities, categories, secrets, catch-up and the /achievements command.
  • Leaderboards and rank cards: a member's public achievements page.
  • Levels: the level system that receives the XP bonus.
  • Dashboard: the personal background of achievement banners (Premium).

Updated on October 22, 2026