Skip to main content
Prefix commands are text commands you type in a channel, like !help. This page covers everything about running them: finding your prefix, reading a command’s syntax, targeting members, and the limits that keep things fair.

​
Before you start

1

Bloom is in your server

Someone with the Manage Server permission has added Bloom.
2

Bloom can read and send in the channel

Bloom needs View Channel, Send Messages, and Embed Links in the channel where you run commands. Without Embed Links, Bloom falls back to plain text where it can.

​
The server prefix

A prefix is the character or short text you put in front of a command name so Bloom knows the message is for it. Every server has its own prefix, and administrators can change it, so there is no single prefix that is correct everywhere. Throughout these docs, ! stands for your server’s prefix. If your server uses a different prefix, substitute it. For example, !help means “the word help with your server’s prefix in front of it.”

​
Find your server’s prefix

1

Mention Bloom with nothing after it

Send a message that is only a mention of Bloom, for example @Bloom. Bloom replies with the current prefix, for example: my prefix here is !, you can also mention me as a prefix.
2

Or check the setprefix command

Run !setprefix with no new prefix. Bloom replies with the current prefix and how to change it.
3

Or read the help footer

Run !help. The footer of the help message shows Prefix: <your prefix>.
If you do not know the prefix and cannot find it, send b.help. This exact text always opens Bloom’s help, no matter what the server prefix is, so it is a reliable recovery command.

​
Change the server prefix

​
prefix command
Sets the command prefix for this server. Alias: prefix.
  • Syntax: !setprefix <prefix>
  • You need: Administrator
  • Bloom needs: Send Messages
  • Rules: the prefix must be 5 characters or fewer. Running !setprefix with no argument shows the current prefix instead of changing it.
Example
After this, commands use > instead, for example >help. Bloom replies Prefix has been set to >.

​
Three ways to trigger a command

Put the prefix directly in front of the command name.
Bloom reads ban as the command and the rest as its arguments.

​
Reading command syntax

Every command reference on this site uses the same notation. The prefix is never shown in the syntax line, because it depends on your server. For example, a command documented as warn <user> [reason] is used like this:
Minimal
With the optional reason
The first warns the member with no reason recorded. The second warns them and stores breaking rule 3 as the reason.

​
Targeting a member

Where a command takes a <user>, Bloom accepts any of these:

​
Discovering commands

​
prefix command
Lists commands and shows details for a single command.
  • !help lists command categories and totals.
  • !help <command> shows one command’s description, usage, and examples, for example !help ban.
  • !help <category> lists the commands in a category.
  • b.help opens the same help without needing the prefix.
You can also browse the complete, always current command list on the Bloom website.

​
Rate limits and cooldowns

Bloom applies a couple of light limits so that no single member can flood a channel. They clear on their own after a short time, and Bloom only mentions a limit occasionally rather than on every blocked message.
  • Overall pace. If you run many commands in quick succession, Bloom asks you to slow down for a moment before it accepts more.
  • Per command cooldown. Each command has a short cooldown so it cannot be repeated instantly. Commands that do heavier work, such as image generation, wait a little longer between uses. Premium shortens the cooldown on some of those heavier commands.
When you hit either limit, Bloom replies with a short wait message and removes it after a few seconds. Wait a moment and try again.

​
Personal self-prefix (Premium)

​
prefix command
Sets a personal prefix that works in every server you share with Bloom, on top of each server’s own prefix. Alias: myprefix. This command is Premium only.
  • Syntax: !selfprefix <prefix|none>
  • Scope: works in any server, per user
  • Rules: 1 to 5 characters, no spaces. Use none, remove, reset, or clear to turn it off.
Set a personal prefix
After this, that user can run ffhelp, ffnp, or any command with ff in front, in any server. Other members are unaffected, and the server’s normal prefix keeps working.
Remove it

​
Permissions in short

Running a command depends on two separate things, and Bloom checks both.
  • You need the user permissions listed on the command. Some commands are also server only, Premium only, or owner only.
  • Bloom needs the bot permissions listed on the command, plus the ability to send in the channel.
Administrators and the server owner pass most permission checks. Bloom also supports fake permissions, which let you grant a member the ability to use permission gated Bloom commands without giving them the real Discord permission. Fake permissions satisfy Bloom’s own checks only; they never grant Discord API rights, so an action that Discord itself requires a permission for will still fail.

​
Commands in direct messages

Bloom’s prefix commands are server commands. In direct messages, Bloom currently responds only to verification flows, such as answering a join gate captcha. Sending a normal command such as !ping to Bloom in a direct message does nothing.
To use Bloom’s everyday commands, run them inside a server, using the server prefix or by mentioning Bloom.

​
Common mistakes

Check that you used the correct prefix for this server, that Bloom can see and send in the channel, and that the command name is spelled correctly. If you are unsure of the prefix, send b.help. Bloom stays silent on unknown command names on purpose, so a typo produces no reply.
You have run commands faster than Bloom accepts them. These limits are per user and clear on their own, so wait the moment shown and try again.

Embed syntax

Compose the messages and buttons that many commands accept.

Leveling

A full example of a configurable Bloom system and its commands.

Full command list

Every command with its description.

Support server

Ask for help if a command does not behave the way you expect.