Skip to main content
Bloom can post a message every time someone boosts your server, filled in with their name, your server details, and the current boost count.

Defaults

Quick start

1

Set the booster channel

Run !booster #boosts. Bloom confirms the channel and enables booster messages. Bloom must be able to Send Messages and Embed Links there.
2

Choose a message

Run !booster template to pick a ready-made design, or !booster paste to supply your own embed code. Bloom previews it and asks you to confirm before saving.
3

Preview it

Run !boostertest. Bloom renders the message using your own account as the sample booster.

Configuring the message

Administrator
Configures the booster message. Run with no argument to see the current status. Aliases: setbooster, boostermsg.
  • !booster #channel sets the channel and enables booster messages.
  • !booster template lists ready-made designs and saves the one you pick.
  • !booster paste prompts you to send your own embed code, previews it, and saves it on confirmation.
  • !booster test previews the saved message using your account as the sample.
  • !booster enable and !booster disable turn announcements on or off without deleting the configuration.
  • !booster convert upgrades a legacy message to the modern format.
Administrator
Renders the saved booster message as it would appear for a real boost, using your own account. Alias: testbooster.
Booster messages use the same $e{...} embed format as the rest of Bloom, and support every welcome variable plus the boost specific tokens. See Variables and placeholders for the full list and Embed syntax for the format itself.
A booster announcement that pings the member

Auto-delete booster messages

Administrator
Deletes each announcement a set time after it is sent, to keep the channel clean.
  • Accepted values: a duration such as 30s, 5m, or 1h. The minimum is 5 seconds and the maximum is 1 hour.
  • Use off to disable it, so announcements stay in the channel.

Legacy format and conversion

Bloom accepts two message formats. The modern format uses $e{...} blocks. An older YAML format writes one key: value per line. Both work.
Administrator
Converts a saved YAML message to the modern $e{...} format, previews the result, and saves it on confirmation. Your original is left unchanged if you cancel.

Personal roles for boosters

Announcing a boost and giving the booster a role of their own are separate features. To let boosters create and style their own role, see Booster and custom roles.

Troubleshooting

Check !booster with no arguments. A channel must be set and a message saved before anything sends, and Bloom needs Send Messages and Embed Links in that channel.
A token that does not exist for booster messages is left as written or filled with nothing. Check your tokens against the booster message variables.
Self-destruct is on. Run !booster selfdestruct off to keep announcements in the channel.
boostertest uses your own account as the sample. Tokens that depend on the boost itself, such as the new boost count, show your server’s live values rather than the values at the moment of a real boost.

Booster and custom roles

Let boosters build a personal role with their own name and color.

Welcome messages

The same message format and commands, for members joining.

Variables and placeholders

Every token a booster message can use.

Embed syntax

The format booster messages are written in.