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 warning system gives your moderation team a persistent record of member infractions. Each warning is stored with the issuing moderator, a timestamp, and a reason, so the full history is always available for review. Beyond manual record-keeping, you can configure automatic punishments that trigger the moment a member’s warning count reaches a threshold you define — no further action needed from your staff. Thresholds can be set independently for timeouts, kicks, and bans, giving you fine-grained control over escalation.
All /warn subcommands require the Manage Messages permission.
How thresholds work
When you add a warning to a member, Stellar immediately checks their total warning count against each configured threshold:
- If their count matches the timeout threshold, they are timed out for the configured timeout length.
- If their count matches the kick threshold, they are kicked from the server.
- If their count matches the ban threshold, they are permanently banned.
A threshold value of -1 means that punishment type is disabled. Thresholds are checked in order: timeout → kick → ban. Only the first matching threshold fires per warning addition.
Stellar must have the appropriate permissions (Moderate Members for timeouts, Kick Members for kicks, Ban Members for bans) for automatic punishments to apply. If permissions are missing, Stellar will post an error message in the channel.
Commands
/warn add
Issue a warning to a member. The warning is saved to the server’s history and triggers any matching automatic punishment. Bots cannot be warned.
| Parameter | Required | Description |
|---|
member | Yes | The member to warn (mention). |
reason | Yes | The reason for the warning (max 255 characters). |
/warn add @User Repeated off-topic posting in #general
/warn remove
Delete a specific warning by its warn ID. The warn ID is shown in the footer of the embed when a warning is added, and in the output of /warn view.
| Parameter | Required | Description |
|---|
warnId | Yes | The numeric ID of the warning to remove. |
/warn view
List all warnings for a user, displayed in a paginated embed ordered from most recent to oldest. Each entry shows the warn ID, when the warning was issued (relative timestamp), and a preview of the reason. Use /warn viewid to see full details for any individual entry.
| Parameter | Required | Description |
|---|
user | No | The user whose warnings to view. Defaults to yourself. |
/warn view @User
/warn view
/warn viewid
Display full details for a single warning, including the offender, the moderator who issued it, the exact time, and the complete reason text.
| Parameter | Required | Description |
|---|
warnId | Yes | The numeric ID of the warning to look up. |
/warn clear
Remove all warnings for a user at once. This is useful when a member has reformed and you want to give them a clean slate.
| Parameter | Required | Description |
|---|
user | No | The user whose warnings to clear. Defaults to yourself. |
Clearing warnings is permanent. All warn records for the user in this server will be deleted and cannot be recovered.
/warn threshold
Set the number of warnings at which an automatic punishment is applied. Each punishment type (timeout, kick, ban) has its own independent threshold. Set a threshold to -1 to disable that punishment.
| Parameter | Required | Description |
|---|
type | Yes | The punishment type: kick, ban, or timeout. |
threshold | Yes | The warning count that triggers the punishment. Use -1 to disable. |
/warn threshold timeout 3
/warn threshold kick 5
/warn threshold ban 10
/warn threshold timeout -1
/warn timeoutlength
Set how long a member is timed out when they hit the timeout threshold. The value is in minutes. The maximum is 87,600 minutes (approximately two months).
| Parameter | Required | Description |
|---|
minutes | Yes | Timeout duration in minutes (max 87,600). |
Common values: 60 (1 hour), 1440 (1 day), 10080 (1 week), 43200 (30 days).
/warn status
View the current warning configuration for the server, including all three thresholds and the timeout length.
The response shows:
| Field | Description |
|---|
| Timeout Threshold | Warnings needed to trigger a timeout |
| Timeout Length | Duration of the auto-timeout |
| Kick Threshold | Warnings needed to trigger a kick |
| Ban Threshold | Warnings needed to trigger a ban |
