Documentation Index
Fetch the complete documentation index at: https://docs.stellarbot.dev/llms.txt
Use this file to discover all available pages before exploring further.
Stellar’s moderation suite gives your staff team everything they need to keep a server under control — from bulk-deleting messages and banning users to locking channels during incidents and running an automated scan that flags suspicious accounts. All commands work with both slash commands (/) and the server’s text prefix (default s!), so your moderators can choose whichever workflow suits them. Every action respects Discord’s role hierarchy, so Stellar will never let a moderator act on someone above their own highest role.
Required permissions
Most moderation commands require the invoking member to hold the corresponding Discord permission in addition to Stellar being invited with the necessary bot permissions. The table below lists both.
| Command | Your permission | Stellar’s permission |
|---|
/prefix (set) | Manage Server | — |
/purge | Manage Messages | Manage Messages |
/ban | Ban Members | Ban Members |
/kick | Kick Members | Kick Members |
/unban | Ban Members | Ban Members |
/softban | Ban Members | Ban Members |
/lock / /unlock | Manage Channels | Manage Channels |
/poll | Manage Channels | Manage Channels |
/clonechannel | Manage Channels | Manage Channels |
/scanmembers | Manage Server | View Channel |
/timeout add / /timeout remove | Moderate Members | Moderate Members |
Commands
/prefix
View the current text prefix or change it to something new.
| Parameter | Required | Description |
|---|
prefix | No | The new prefix to set. Must be 10 characters or fewer. |
- Run
/prefix with no argument to see the current prefix.
- Run
/prefix <value> to change it. Requires Manage Server.
- The default prefix is
s!.
/purge
Bulk-delete a specified number of messages in the current channel. Only messages sent within the last 14 days can be deleted (a Discord API limitation).
| Parameter | Required | Description |
|---|
amount | Yes | Number of messages to delete. |
Purged messages cannot be recovered. Double-check the channel before running this command.
/ban
Permanently ban a user from the server. You can ban users who are no longer in the server by ID. Stellar checks that the target is not above or equal to your role before proceeding.
| Parameter | Required | Default | Description |
|---|
user | Yes | — | The user to ban (mention or ID). |
reason | No | Not Specified | Reason recorded in the audit log. |
deleteMessageHistory | No | 7 | Days of message history to delete (1–7). |
Use the deleteMessageHistory parameter to clean up a raider’s messages at the same time you ban them.
/ban @User Spamming raid content 7
/kick
Remove a member from the server. They can rejoin if they have an invite link. Stellar will attempt to send the member a DM with the reason before kicking them and will report whether the DM was delivered.
| Parameter | Required | Default | Description |
|---|
member | Yes | — | The member to kick (mention). |
reason | No | Not Specified | Reason shown in the DM and audit log. |
/kick @User Breaking rule 3
/unban
Reverse an existing ban. You can pass the user’s Discord ID if they are no longer visible in the server.
| Parameter | Required | Description |
|---|
user | Yes | The user (or user ID) to unban. |
/unban 123456789012345678
/softban
Ban a member and then immediately unban them. This removes the member and deletes 7 days of their message history without keeping them on the ban list. It is useful for purging spam without a permanent ban. Stellar sends the target a DM notifying them of the action when possible.
| Parameter | Required | Default | Description |
|---|
member | Yes | — | The member to soft ban (mention). |
reason | No | Not specified | Reason recorded in the audit log. |
/softban @SpamBot Automated spam
/lock
Prevent everyone from sending messages in the current channel by denying the Send Messages permission for @everyone. Existing members can still read the channel.
Running /lock on an already-locked channel will return an error. Use /unlock to restore access.
/unlock
Restore message sending access to a channel that was previously locked with /lock. This removes the @everyone Send Messages denial that /lock applied.
/poll
Post an interactive poll embed to the current channel. Stellar adds number emoji reactions automatically so members can vote. At least two choices are required; you can provide up to ten. Requires Manage Channels.
| Parameter | Required | Description |
|---|
message | Yes | The poll question or statement. |
choice1 | Yes | First answer option. |
choice2 | Yes | Second answer option. |
choice3 – choice10 | No | Additional answer options (up to 10 total). |
/poll "What game should we play tonight?" Valorant Minecraft "League of Legends"
/clonechannel
Create an exact copy of a text channel, preserving its name, topic, category, position, and permission overwrites. The cloned channel gets the suffix -clone appended to its name.
| Parameter | Required | Default | Description |
|---|
channel | No | Current channel | The text channel to clone. |
deleteChannel | No | false | Delete the original channel after cloning. |
Setting deleteChannel to true is irreversible. The original channel and all its message history will be permanently deleted.
/clonechannel #announcements
/clonechannel #general true
/scanmembers
Scan all non-bot members of the server and flag accounts that match suspicious patterns. Results are cached for 15 minutes and can be browsed with the Search button that appears after the scan completes.
Stellar flags members for three reasons:
| Flag | Meaning |
|---|
| New Account | Account created less than one week ago |
| Phishing Name | Username matches known phishing patterns |
| Inappropriate Name | Username contains inappropriate content |
Scan results are only visible to the moderator who ran the command. Large servers may take a few moments to complete.
Timeouts
Stellar also provides dedicated timeout commands under the /timeout group, which use Discord’s native mute feature (restricts the member from sending messages or joining voice for a set duration).
/timeout add
Apply a temporary timeout to a member. The minimum duration is 5 minutes and the maximum is 28 days. Stellar will attempt to DM the member unless you pass sendMessage: false.
| Parameter | Required | Default | Description |
|---|
member | Yes | — | The member to time out. |
length | No | 1d | Duration of the timeout (e.g. 30m, 2h, 7d). |
sendMessage | No | true | Whether to notify the member via DM. |
/timeout add @User 1h
/timeout add @User 30m false
/timeout remove
Remove an active timeout from a member before it expires.
| Parameter | Required | Description |
|---|
member | Yes | The member whose timeout to remove. |
