Getting started

Add Bloom to your server

1. Use the invite button on the website.
2. Select the server you want to add Bloom to.
3. Keeping the default permissions is recommended.
4. Authorize the bot.

Prefix

The default prefix is b..

b.prefix <new_prefix>

After changing the prefix, all prefix commands will use your new prefix.

Quick setup

You can either run a guided setup or configure everything manually.

• Guided: b.setup
• Log channels: b.logchannel mod #mod-logs, b.logchannel join #join-leave
• Welcome: b.welcome #welcome
• Jail system: b.jailsetup, b.jailchannel #jail

Command syntax

Basic structure

Bloom commands follow a simple structure:

,command [required] <optional> | alternatives

• no brackets: exact command name (,ban)
• [square brackets]: required arguments
• <angle brackets>: optional arguments
• |: choose one of the options

Common argument types

• Users: @User, user ID, username
• Roles: @Role, role name, role ID
• Channels: #channel, channel ID
• Durations: 30s, 10m, 1h, 1d, 1w
• Flags: things like -s (silent) or purge windows -p1, -p7

Moderation system

Core actions

• Ban: ,ban <user> [reason] [-s]
• Tempban: ,tempban <user> <duration> [reason]
• Kick: ,kick <user> [reason]
• Timeout: ,timeout <user> <duration> [reason]
• Warn: ,warn <user> <reason>

Channel controls

• Purge: ,purge <amount> and subcommands like purge user <@user> <amount>
• Lock / unlock: ,lock [#channel] [reason], ,unlock [#channel]
• Slowmode: ,slowmode <duration|off>

Jail system

A lighter alternative to bans, using a dedicated jail role and channel.

• Setup: ,jailsetup
• Configure: ,jailchannel #jail
• Use: ,jail <user> <duration> [reason], ,unjail <user>

Automoderation & history

• Automod: ,automod <module> <punishment>
• Whitelist: ,automod whitelist <add/remove/list> <type> [id]
• User history: ,history <user> and tools to edit/remove cases.
• Mod stats: ,modstats [moderator]

Embed syntax

Basics

Bloom embeds use a small template language.

$e{key: value}

For normal message content outside the embed:

{message: Your text here}

Common properties

• title – embed title
• description – main text
• color – hex color
• footer – footer text
• thumbnail – small image
• image – large image
• author – author line
• timestamp – true to add current time
• field – add fields

Fields

Fields use a pipe-separated format for title / value / inline:

$e{field: Title|Content|true}

The last part is true for inline, false for full width.

Example

{message: Hey, welcome!}
$e{title: Rules}
$e{description: Please read the rules below.}
$e{color: #8ea8c3}
$e{field: Rule 1|Be kind|true}
$e{field: Rule 2|No spam|true}
$e{timestamp: true}

Create and send embeds with the ,embed command family.

Last.fm integration

Link your account

• Link: ,login <lastfm_username>
• Now playing: ,np [user], ,music
• Recent tracks: ,recent [user]

Stats and info

• Top stats: ,topartists, ,topalbums, ,toptracks
• Profile: ,fmprofile [username]
• Track / album / artist info: ,trackinfo, ,albuminfo, ,artistinfo

Custom embeds

You can combine Last.fm data with embed templates.

,customembed $e{title: Now playing}
$e{description: {track} by {artist}}
$e{color: #8ea8c3}

Variables like {track}, {artist}, {album}, {cover} are replaced dynamically.

Auto-responders & auto-reacts

Auto-responders

Respond automatically when certain text is sent.

• Add: ,autoresponder add <trigger> | <response> [flags]
• Remove: ,autoresponder remove <trigger>
• List: ,autoresponder list

Useful flags:

• --notstrict – match parts of a message
• --delete – delete the original message
• --reply – reply instead of sending a new message
• --sd<seconds> – auto delete the response

Auto-reacts & auto-threads

• Auto-react: ,autoreact add <trigger> <emoji>, plus remove/list helpers.
• Auto-thread: ,autothread <#channel> [auto_lock_minutes]

Sticky messages

Overview

Sticky messages are re-posted at the bottom of a channel as new messages come in, so important information stays visible.

• Add: ,stickymessage add #channel <text>
• Add with embed: ,stickymessage add #channel embed <embed_name>
• Remove: ,stickymessage remove #channel
• List: ,stickymessage list

Server customization

Server profile options

Server owners can make Bloom feel more native to their space.

• Avatar: ,custom avatar [image]
• Banner: ,custom banner [image]
• Bio: ,custom bio [text]

Frequently asked questions

Permissions

For full functionality, Bloom should have:

• Manage Messages
• Kick Members / Ban Members
• Manage Roles
• Send Messages / Embed Links
• Read Message History

The bot is not responding

• Check if the bot is online and has permission in the channel.
• Make sure you are using the correct prefix (default b.).
• Try a simple command like b.help.

Moderation commands fail

• Your role and the bot's role must be above the target's highest role.
• You need the corresponding Discord permission (kick / ban / manage roles).
• Some commands have small cooldowns, so avoid spamming them.

Where can I get help?

Join the support server and open a ticket if you need help or want to suggest something.