Configuration guide

Booster Rewards & Announcements

Announce new and lost boosts, give roles, currency and items to boosters, and let boosters make their own role. This page covers every tab, setting and limit.

Time
20 minutes
You need
Owner, Administrator or Manage Server
Applies to
Per Discord server

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.

Keep Discord's own boost message 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

On the website
  • 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.
In Discord
  • 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.

Stuck on this step?

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.