Stellar’s chat filter monitors every message sent in your server and automatically deletes any that contain a blacklisted word. Because deletions happen in real time, rule-breaking content is removed before it can spread — without requiring a moderator to be actively watching. You control the word list, decide whether administrators are exempt, and optionally route deletion events to a dedicated log channel so nothing slips through unnoticed. You can also whitelist specific roles (for example, a trusted community contributor role) to exclude them from filtering entirely. AllDocumentation Index
Fetch the complete documentation index at: https://docs.stellarbot.dev/llms.txt
Use this file to discover all available pages before exploring further.
/chatfilter subcommands require the Manage Server permission. For the filter to delete messages, Stellar must also have the Manage Messages permission in the channels you want it to monitor.
Setup
Enable the chat filter
Run
/chatfilter toggle to turn the filter on. Stellar will confirm the change and display a summary of next steps.Add words to the blacklist
Run
/chatfilter addword <word> for each word or phrase you want to block. You can add up to 100 entries, each up to 255 characters.Set a log channel (optional)
Run
/chatfilter setlogchannel #channel to send a notification to that channel whenever a message is deleted by the filter.Configure exemptions (optional)
Use
/chatfilter ignoreadmins true to prevent the filter from applying to members with the Administrator permission. Use /chatfilter addwhitelistedrole to exempt specific roles.Commands
/chatfilter toggle
Enable or disable the chat filter. Running the command again reverses the current state. When turned on, Stellar will display a brief guide to the next configuration steps.
/chatfilter config
View the complete current configuration, including filter status, log channel, up to 10 blacklisted words (with a count of any additional entries), and all whitelisted roles.
/chatfilter addword
Add a word or phrase to the blacklist. The filter performs a case-insensitive match, so adding badword will also catch BadWord and BADWORD.
| Parameter | Required | Description |
|---|---|---|
word | Yes | The word or phrase to block (max 255 characters). |
The blacklist has a maximum of 100 entries. Adding a word that already exists in the list will return an error.
/chatfilter removeword
Remove a word or phrase from the blacklist. The lookup is case-insensitive, so the word does not need to match the exact casing used when it was added.
| Parameter | Required | Description |
|---|---|---|
word | Yes | The word or phrase to remove from the blacklist. |
/chatfilter setlogchannel
Designate a text channel to receive a log entry whenever a message is deleted by the filter. This is optional but recommended so moderators have a record of what was caught.
| Parameter | Required | Description |
|---|---|---|
channel | Yes | The text channel to send filter logs to. |
/chatfilter ignoreadmins
Control whether members who have the Administrator permission are exempt from the chat filter.
| Parameter | Required | Description |
|---|---|---|
toggle | Yes | true to ignore admins, false to apply the filter to them. |
/chatfilter addwhitelistedrole
Exempt a role from the chat filter. Members who hold this role will be able to send messages containing blacklisted words without them being deleted.
| Parameter | Required | Description |
|---|---|---|
role | Yes | The role to whitelist. |
/chatfilter removewhitelistedrole
Remove a role from the whitelist, so members with that role are once again subject to the chat filter.
| Parameter | Required | Description |
|---|---|---|
role | Yes | The role to remove from the whitelist. |