Overview
Booster Rewards replaces boost-announcement bots. It posts messages for new and lost boosts, gives rewards, and lets boosters make their own coloured role. It is off until you switch it on.
In Discord, open Server Settings, System Messages, and keep Send a message when someone boosts this server on. The bot reads that message to see when a member who is already boosting adds another boost. You can hide Discord's message by choosing a channel nobody reads. Without it, Extra boost messages and rewards will not fire.
The bot needs Manage Roles (with its role above every reward role), plus permission to view and send messages in your announcement channel.
Setup & Configuration
- Log in to the RustyWorks website, open Servers Configure, pick your server and select Booster Rewards & Announcements.
- Follow the Setup checklist: Booster Rewards switched on, an announcement channel chosen, at least one announcement on, boosters get a reward (optional), and the bot has everything it needs.
- Press Save changes. The bot picks it up within about 15 seconds.
- Staff commands: /booster test, /booster grant and /booster resync.
- All settings are on the website.
Where to announce
| Setting | What it does |
|---|---|
| Announcement channel | The main channel for new boosts, lost boosts, level-ups and milestones |
| Use the server's system channel as a fallback | If no channel is chosen, post in the channel Discord uses for welcome messages |
| Staff log channel (private) | The bot reports rewards paid, problems and milestones here. Optional |
Any message can use its own channel instead, set in the Messages tab.
Messages
There are seven announcements. Each can be switched on or off, sent to its own channel, and styled as an embed or plain text.
| Message | Sent when |
|---|---|
| New boost | A member boosts the server, or starts boosting again |
| Extra boost | A member who is already boosting adds another boost |
| Lost boost | A member stops boosting or leaves the server |
| Boost removed (member unknown) | The boost count dropped but Discord did not say who |
| Server level up | The server reaches a higher level |
| Server level down | The server falls to a lower level |
| Loyalty milestone | A member has kept boosting for a milestone you set |
New boost, Lost boost and Loyalty milestone can also be sent as a private message (DM) to the member. DMs are off by default.
| Message setting | Limits |
|---|---|
| Channel for this message | Leave empty to use the main channel |
| Ping role | Optional. The role is mentioned above the message |
| Delete after | 0 to 86400 seconds. 0 keeps it forever. Resets if the bot restarts |
| Format | Embed, or Plain text only |
| Text above the embed | Up to 2000 characters. Put {user} here so the member gets a notification |
| Title | Up to 256 characters |
| Description | Up to 4000 characters |
| Color | A hex colour. Default pink #ff73fa |
| Thumbnail | The member's picture, the server icon, a custom link, or none |
| Large image | None, or a custom https:// link |
| Author line | None, the member, the server, or custom text up to 256 characters |
| Footer text and icon | Text up to 2048 characters. Icon: server, member or none |
| Show the time | On by default |
| Extra fields | Up to 6. Name up to 256 characters, text up to 1024. A field whose text is empty is hidden |
| Reactions | Up to 3 emoji. Normal emoji, or a custom one like <:name:123456789012345678> |
Use Send a test to post exactly what the preview shows, with sample data. A test gives nothing away. Use Reset this message to the default to put the wording back. The three Look & feel presets (Classic embeds, Minimal one-liners, Big celebration) restyle all seven messages at once. Your channels, ping roles and switches are kept.
Variables
| Group | Variables |
|---|---|
| Member | {user}, {username}, {displayname}, {userid}, {avatar} |
| Server | {server}, {serverid}, {servericon}, {membercount} |
| Server boosts | {boosts}, {tier}, {tiername}, {oldtiername}, {nexttier}, {boostsneeded}, {progress}, {nextgoal}, {boosters} |
| This boost | {count}, {boostword}, {userboosts}, {rewards} |
| Booster history | {days}, {totaldays}, {since}, {sincerel}, {streaks} |
| Milestone | {milestone}, {milestonelabel} |
| Lost boost | {reason}, {reasontext}, {lostcount}, {lostword} |
| Time | {time}, {timerel} |
Anything empty is left out, and an empty line disappears.
Rewards
Rewards are given automatically and the bot tells the member in the announcement (use {rewards}).
| Reward | When it is given |
|---|---|
| First boost | When a member starts boosting |
| Extra boost | When a member who is already boosting adds another boost |
| Loyalty milestones | Each one once per streak, when the member has boosted for that many days in a row |
| Regular reward | Keeps coming for as long as they boost |
| Setting | Default and limits |
|---|---|
| Anti-abuse cooldown | 30 days (0 to 365). Stops boost, unboost, boost being paid twice |
| Loyalty milestones | Up to 12. Each is 1 to 3650 days, with an optional label up to 40 characters, and choices to Announce (on by default) and Send a DM (off by default) |
| Regular reward: pay every | 7 days (1 to 365) |
| Regular reward: stop after | 0 to 1000 payouts. 0 keeps paying as long as they boost |
Each reward can hold:
| Part | Limits |
|---|---|
| Roles | Up to 10 |
| Currency | Up to 10 entries. An amount of 1 to 1,000,000,000 on a chosen Rust server, or all your linked servers |
| Items | Up to 10 entries. A name up to 60 characters, a command up to 300 characters, and a quantity of 1 to 10000. The command needs {event_user} so the game knows which player gets it, for example inventory.giveto {event_user} scrap 500 |
Roles are added straight away. Currency and items go to the player's linked game account. Items go to the player's bag and are claimed in game with /eco bag. If the member has not linked, the reward waits and is paid when they link, when they use /booster claim, on a 10-minute retry, or with Pay now on the website.
Losing a boost
| Setting | Choices |
|---|---|
| Reward roles are removed | After a grace period (recommended, default), Straight away, or Never |
| Grace period | 24 hours by default (1 to 720). If they boost again in time nothing is lost and nothing is paid twice |
The bot only removes roles it gave. Roles you gave by hand are never touched.
Members who were already boosting
When the bot first notices someone who was boosting before it was set up, or while it was offline, They receive can be:
| Choice | Result |
|---|---|
| Nothing, just remember them | Only tracked |
| The reward roles only (recommended, default) | Roles, no currency or items |
| The full first-boost reward | Everything |
They are imported silently with no announcement, and loyalty milestones are never paid back-dated. Never reward these members takes up to 50 user IDs, for bots, owners or test accounts.
Custom booster role
Members make their own role with /booster role. The role is deleted when they stop boosting, after the grace period.
| Setting | Default and limits |
|---|---|
| Let boosters make their own role | Off |
| Put their role just under | Pick a role. Roles higher in the list win for colour. The bot's own role must be above it |
| Longest role name | 24 characters (3 to 32) |
| Must have been boosting for | 0 days (0 to 365). 0 means straight away |
| Let them choose a colour | On |
| Blocked words in role names | Up to 100 words. Disguised spellings such as "a d m i n" are caught too |
Boosters tab and tools
The Boosters tab lists everyone the bot has seen boosting, with search and order choices. Tools there:
| Tool | What it does |
|---|---|
| Give a reward by user ID | Gives a booster reward that was missed |
| Scan the member list for boosters | Finds anyone the bot missed while it was offline. Needs Booster Rewards switched on and saved |
| Rewards waiting | Lists currency and items that could not be paid yet. Use Try to pay everyone now, Pay now or Cancel |
| Take back roles, Delete custom role, Reset record | Per-booster clean-up |
An Activity list keeps 90 days of what the booster system did, with problems shown in red. Backup & copy settings exports and imports everything as a file. Re-pick channels and roles if you import into a different server.
Commands & Usage
| Command | What it does | Who can use it |
|---|---|---|
| /booster test | Sends a test announcement | Staff |
| /booster grant | Gives a member a booster reward | Staff |
| /booster resync | Re-reads who is boosting | Staff |
| /booster status | Shows how long you have boosted and what you have earned | Everyone |
| /booster list and /booster leaderboard | Current boosters and the longest supporters | Everyone |
| /booster role | Creates or changes your own booster role | Boosters |
| /booster claim | Collects rewards that were waiting for a link | Boosters |
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| No announcement | Booster Rewards is off, no channel is set, or that message is switched off | Check the Setup checklist |
| "Extra boost" never fires | Discord's own boost message is switched off | Turn on Send a message when someone boosts in System Messages |
| Roles were not given | The bot lacks Manage Roles, or its role is below the reward role | Move the bot's role above every reward role |
| Currency or items did not arrive | The member has not linked their account | They link with /user link, then /booster claim, or press Pay now |
| Discord does not report per-user boost counts | Counts are inferred | Use Scan the member list if numbers look wrong |
| Settings were lost on import | Channel and role IDs belong to the old server | Re-pick them after import |
Checked against RustyWorks on 29 Oct 2026.
Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.