Contents
Levlix Boosters Guide
The Boosters module thanks the members who boost your server. It can pay out points, hand out an extra role, post a thank-you card and reward long-term boosters with milestone roles. Everything is configured in the Levlix Dashboard under Engagement → Boosters. The module has no commands.
It covers three things:
- a Boost start reward when someone starts boosting,
- Milestones for members who keep boosting for a long time,
- a Boost end cleanup when someone stops.
The Boosters Module card at the top of the Boosters page switches the whole module off again. While it is off, Levlix pays nothing, posts nothing and removes nothing. Boost start and Milestones also have their own switches, Reward boost starts and Reward milestones. Both start off, so nothing happens until you turn on the parts you want.
Boost start
When a member starts boosting, Levlix can do any of the following. Each part is optional.
| Setting | Description |
|---|---|
| Points | Points credited to the booster's points balance. Leave it empty or enter 0 to hand out no points |
| Booster role | A role the booster receives for as long as they boost |
| Thank-you card | Posts a card in the Card channel you pick, mentioning the booster |
| Message | Your own text for the card, up to 2000 characters. Leave it empty to use the default text in the server language |
In the message you can use {user} for the mention of the booster and {server} for the server name. Below your text the card lists the points and the booster role the member received.
Under the message field the dashboard shows a preview of the card with sample values and your name. An empty message previews the default text, and the preview updates as you type. Send test posts one card into the saved channel, marked as a test, with you as the booster. A test never pings anyone and grants no rewards. Changes on the page are saved automatically, and Send test saves anything still pending before it posts.
The card is written in the server language and carries the In my language button, which shows any reader a private copy in their own language.
Once per 30 days
A member receives the points and the card at most once every 30 days. Someone who boosts, stops and boosts again a few days later does not collect the points twice and gets no second card. This keeps the reward from being farmed by switching a boost off and on. The booster role is still given back on the new boost, because it belongs to whoever is boosting right now.
Switching the module on later
If your server already has boosters when you switch the module on, they do not all get paid at once. Only boosts that began within the last 24 hours receive the start reward. Older boosters are not paid retroactively, but they are taken into account for milestones (see below).
Milestones
Milestones reward members for how long they have been boosting without a break. There are four steps, and each one has its own role:
| Milestone | Boost duration |
|---|---|
| Tier 1 | 1 month |
| Tier 2 | 3 months |
| Tier 3 | 6 months |
| Tier 4 | 12 months |
A month counts as 30 days. Each tier has its own switch, role and points value, so you can use only the steps you want. Each milestone is paid once per boost, and members keep the roles of the tiers they already reached. If a member stops boosting and starts again later, the count starts over from the new boost.
Why duration and not boost counts
Milestones follow how long a member has been boosting, like the booster badges in Discord itself. They do not follow how many boosts someone has. Discord does not tell bots how often a member boosted, only since when they have been boosting, so a count-based milestone could not be reliable.
Existing boosters catch up
Milestones are checked every hour. Members who already boosted for a long time when you switch the module on receive every milestone they have already earned at the next check. Nobody has to boost again to collect them.
Boost end
When a member stops boosting, Levlix can remove the roles it handed out for boosting. This is controlled by Take the roles back and is on by default. The hourly check also catches boosts that ended while Levlix was offline or while the module was off, and removes those roles then.
Roles you cannot choose
Not every role can be a booster reward:
- Discord's own Server Booster role and @everyone are not offered in the role pickers. Discord manages them and Levlix cannot hand them out or take them away.
- Roles with dangerous permissions, such as Administrator, Manage Roles or Ban Members, cannot be saved. A reward must never be a way to hand out control of the server. If a role gains such a permission later, Levlix stops handing it out, but it can still take it back when a boost ends.
- A role at or above the Levlix role, or one you could not hand out yourself, cannot be saved either.
More XP for boosters
The Boosters module does not change how much XP a member earns. To give boosters an XP multiplier, use an XP role boost with Discord's Server Booster role. Open Economy → Rewards and add the role to the XP Boost Roles card, or follow the link in the info box on the Boosters page. The details are in the XP & Leveling guide.
Required permissions
Levlix needs the following in your server:
- Manage Roles, and its own role placed above every role it should hand out or remove. Drag the Levlix role up in Server Settings → Roles if a role is missing or cannot be assigned.
- Send Messages in the channel you pick for the thank-you card.
If a role could not be given, for example because a permission was missing, Levlix tries that role again every hour for as long as the member keeps boosting and the role is still set for that reward. Only the role is retried: the points and the card are not sent a second time. Once the boost ends, or you remove or change the role, the retry stops.
Setup at a Glance
- Open the Levlix Dashboard, go to Server → Modules and switch on Boosters.
- Open Engagement → Boosters in your server's sidebar.
- Turn on Reward boost starts, choose the points and a booster role, switch on the Thank-you card, pick a card channel and write your own message if you like.
- Check the card with the preview and Send test.
- Turn on Reward milestones, then switch on the tiers you want and pick a role for each.
- Under Boost end, decide whether Take the roles back should stay on.