Sentry Documentation
A comprehensive reference for all commands, features, and configuration options.
Bot Owner: ima._kitty 577640362366205995
Get your server whitelisted here.
Table of Contents
- Overview
- Permission Model
- AutoMod
- Global Moderation
- Guild Moderation
- Network Moderation
- Whitelist Management
- Owner Protection
- Internal Anti-Nuke
- Verification System
- Tickets
- Roblox Integration
- Music
- Context Menu Commands
- User App Commands
- Prefix Commands
- Cobalt Downloader
Overview
Sentry is a Discord moderation bot designed to operate at three scopes:
- Global -- actions applied across every server the bot has joined.
- Network -- actions applied to a subset of linked servers that have opted in.
- Guild -- actions scoped to a single server.
Settings cascade from global down to network down to guild. Guild-level overrides take effect first; anything not overridden inherits from the network, then from the global defaults.
The bot uses slash commands (/) and right-click context menu commands. Some commands are also available via a user-install app that works without joining a server.
Permission Model
Most commands require one of the following permission tiers:
| Tier | Who has it | Grants access to |
|---|---|---|
| Bot Owner | Configured in bot.py |
All commands, all scopes |
| Globally Trusted | Granted via /global management trust |
Global and network commands |
| Network Owner | Creator of a network | Network management and moderation commands |
| Guild Administrator | Discord Administrator permission |
Guild moderation and management commands |
| Guild Moderator | Granted specific sub-permissions via /guild management permissions |
Specific guild commands |
AutoMod
The AutoMod cog provides automated content moderation powered by the OpenAI omni-moderation-latest model, supplemented by several rule-based detection engines.
Command
| Command | Description |
|---|---|
/automod settings |
Opens an interactive settings panel for the invoking guild. |
The settings panel is a multi-page interactive UI with the following sections:
- Toggle AI -- Enable or disable AI scanning for the guild.
- Thresholds -- Configure score thresholds per category and set the timeout duration.
- Keywords -- Manage the keyword and regex blocklist.
- Whitelists -- Configure bypass roles and channels for AI scanning, invite blocking, and keyword blocking.
Detection Modules
AI Moderation (OpenAI)
Messages (text and images) are sent to the OpenAI omni-moderation-latest API and scored against 13 content categories. The score for each category is compared against configurable thresholds to determine the action taken.
Text categories:
| Category | Default notify threshold |
|---|---|
harassment |
90% |
harassment/threatening |
90% |
hate |
90% |
hate/threatening |
90% |
illicit |
90% |
illicit/violent |
90% |
self-harm |
90% |
self-harm/intent |
90% |
self-harm/instructions |
90% |
sexual |
90% |
sexual/minors |
90% |
violence |
90% |
violence/graphic |
90% |
Image-capable categories (scanned in both text and image context):
self-harm, self-harm/intent, self-harm/instructions, sexual, violence, violence/graphic
For each category, three independent thresholds can be configured:
- Notify -- sends an alert to the configured log channel.
- Delete -- deletes the flagged message.
- Timeout -- times out the author and (if delete is also off) deletes the message.
The most severe action triggered across all categories is applied. Higher tiers implicitly activate lower ones (if timeout fires, delete also fires; if delete fires, notify also fires).
Thresholds can be set at the guild, network, or global scope and cascade accordingly.
Keyword and Regex Blocklist
Keywords and regex patterns can be managed via the settings panel under the Keywords tab. They bypass the API queue and are evaluated immediately on every message.
Keyword matching supports wildcard syntax:
| Pattern | Behavior |
|---|---|
dog |
Matches the whole word "dog" |
dog* |
Matches any word starting with "dog" |
*dog |
Matches any word ending with "dog" |
*dog* |
Matches "dog" anywhere in the message |
bad phrase |
Substring match (phrases containing spaces) |
Regex patterns use Python re syntax and are matched case-insensitively.
A per-guild keyword whitelist can be configured to exempt specific roles, channels, and channel categories from keyword and regex checking.
Blocklists are scoped per guild, network, or global and are merged at evaluation time.
Invite Blocker
Detects Discord invite links (all common variants and shorteners) posted in the server. Invites to the server's own guild are automatically allowed. Whitelisted roles, channels, and channel categories bypass this check.
Default action: delete on detection.
Attachment Spam Detection
Tracks attachments (images, videos, files, and any other file type) sent by a member across multiple channels within a 5-minute sliding window. If the same attachment fingerprint (matched by filename and file size) appears in 2 or more distinct channels within the window, the member is flagged.
Default action: delete on detection.
Link Spam Detection
Tracks URLs sent by a member across multiple channels within a 5-minute sliding window. If the same URL appears in 2 or more distinct channels within the window, the member is flagged.
Default action: delete on detection.
Bio Bait Detection
Detects cross-channel lure spam such as "check my bio" or "link in bio". Applies homoglyph normalization to catch bypass attempts (e.g. "bi0", "l1nk 1n bi0"). Fires when the same member posts a matching phrase in 2 or more distinct channels within a 5-minute window.
Default action: delete on detection. Timeout duration: 1 hour.
OCR Scam Detection
When available, image attachments are OCR-scanned and the extracted text is scored against a library of celebrity names, strong scam phrases, weak scam indicators, suspicious domains, and scam fragment patterns.
A combined hard-evidence score and context score determines the action taken.
Default action: configurable via the ocr_scam category thresholds.
IP Grabber Detection
Matches URLs against a list of known IP-logger and IP-grabber domains. Also follows redirect chains (up to 10 hops, 5-second timeout per hop) to detect grabbers hidden behind URL shorteners. Private IP addresses are excluded from redirect crawling.
Default action: delete on detection.
Executable File Detection
Detects executable file attachments by extension and MIME type. Covers Windows, macOS, Linux, mobile (APK, IPA), and JVM (JAR) formats.
Default action: delete on detection.
NSFW Link Detection
Matches URLs against a list of known adult-content domains using the same redirect-following approach as IP grabber detection.
Default action: delete on detection.
Message Spam Detection
Rate-based detection that fires when a member sends too many messages within a rolling time window, regardless of content. The count and window are configurable per scope.
Default rate: 5 messages in 10 seconds. Default action: delete on detection.
Repeated Message Spam Detection
Rate-based detection that fires when a member sends the same message content too many times within a rolling time window. Content is fingerprinted (normalised and hashed) to catch minor variations.
Default rate: 3 identical messages in 30 seconds. Default action: delete on detection.
Link Spam Detection (Rate-Based)
Rate-based detection that fires when a member sends too many link-containing messages within a rolling time window in the same channel, complementing the cross-channel link spam detector.
Default rate: 3 link messages in 15 seconds. Default action: delete on detection.
Attachment Spam Detection (Rate-Based)
Rate-based detection that fires when a member sends too many messages containing attachments within a rolling time window in the same channel, complementing the cross-channel attachment spam detector.
Default rate: 5 attachment messages in 30 seconds. Default action: delete on detection.
AutoMod Settings -- Thresholds Panel
Accessible via Thresholds in the settings panel.
| Button | Action |
|---|---|
| Set Timeout Duration | Opens a modal to set the timeout length applied when the timeout threshold is triggered. Accepts durations like 30m, 1h, 1d. Scoped to guild, network, or global. |
| Set Roles/Channels | Opens selects to configure the ping role (notified on alerts), the AutoMod log channel, and the test channel. |
| Category Thresholds | Opens a sub-panel to view and override per-category thresholds. Has Text and Image tabs. |
| Reset Category Overrides | Clears all category threshold overrides for the current scope. |
AutoMod Settings -- Whitelists Panel
Accessible via Whitelists in the settings panel. Contains three sub-panels:
- AI Whitelists -- roles and channels exempted from AI moderation scanning.
- Invite Whitelists -- roles and channels exempted from invite blocking.
- Keyword Whitelist -- roles and channels exempted from keyword and regex blocking.
All whitelist configuration is guild-scoped only and does not cascade to other scopes.
Permission Requirements for /automod settings
| Scope being configured | Minimum permission required |
|---|---|
| Guild | Administrator or the manage_automod guild mod grant |
| Network | Network owner or bot owner |
| Global | Globally trusted or bot owner |
Global Moderation
The Global Moderation cog applies moderation actions across every server the bot has joined simultaneously. Actions are executed concurrently across guilds using a semaphore of 5 concurrent operations.
All commands in this cog require the globally trusted or bot owner permission.
Command Groups
All commands are nested under /global.
/global moderation
| Command | Description |
|---|---|
/global moderation ban |
Bans a user from every guild the bot has joined. Optionally DMs the target and posts an action log. |
/global moderation softban |
Bans and immediately unbans a user in every guild to purge recent messages without keeping the ban. |
/global moderation kick |
Kicks a user from every guild the bot has joined. |
/global moderation timeout |
Times out a user in every guild the bot has joined. |
/global moderation untimeout |
Removes a timeout from a user in every guild the bot has joined. |
/global moderation unban |
Unbans a user from every guild the bot has joined. |
/global moderation requestban |
Submits a ban request for approval by a globally trusted user or bot owner. |
/global moderation massban |
Bans multiple users from every guild the bot has joined. |
/global moderation massunban |
Unbans multiple users from every guild the bot has joined. |
/global moderation sync_bans |
Syncs the global ban list to a specific guild or all guilds. |
/global moderation status |
Shows the global moderation status and ban record for a user. |
/global moderation quarantine |
Quarantines a user globally (restricts their permissions across all guilds). |
/global management
| Command | Description |
|---|---|
/global management trust |
Grants or revokes the globally trusted permission for a user or role. Actions: add_user, remove_user, add_role, remove_role, list. |
/global management appeal_link |
Sets or clears the global ban appeal link sent in punishment DMs. |
Request Approval
When /global moderation requestban is used, an approval message is dispatched to a configured channel. Globally trusted users and bot owners can approve or deny the request.
Guild Moderation
The Guild Moderation cog applies moderation actions within a single Discord server.
Command Groups
All commands are nested under /guild.
/guild moderation
| Command | Description |
|---|---|
/guild moderation ban |
Bans a member from the guild. Optionally DMs the target with a reason and appeal link. |
/guild moderation softban |
Bans and immediately unbans a member to purge their recent messages. |
/guild moderation kick |
Kicks a member from the guild. |
/guild moderation mute |
Times out, image-mutes, or react-mutes a member. Duration and type are configurable. |
/guild moderation unmute |
Removes a timeout, image-mute, or react-mute from a member. |
/guild moderation unban |
Unbans a user from the guild. |
/guild moderation clear |
Bulk-deletes messages in a channel. Supports filtering by user, count, and age. |
/guild moderation masskick |
Kicks multiple members at once. |
/guild moderation warn |
Issues a warning to a member, logged to the audit system. |
/guild moderation quarantine |
Quarantines a member (strips roles and restricts permissions). |
/guild moderation lockdown |
Locks or unlocks a channel or the entire server. Re-using the command on an already-locked target toggles it back. |
/guild moderation slowmode |
Sets the slowmode delay on a channel. |
/guild moderation nickname |
Changes or resets a member's nickname. |
/guild moderation comms |
Assigns, removes, or lists community service (purgatory). A member must complete a configured number of cleanup tasks before regaining normal access. |
/guild moderation status |
Shows the full moderation profile for a user within the guild. Supports filtering by action type and looking up a single audit row by ID. |
/guild moderation bans |
Browses the server's ban list with pagination. Optionally checks if a specific user ID is banned. |
/guild moderation waveban |
Stages users for a wave ban, then executes, lists, or clears the queue. Supports network propagation on execute. |
/guild moderation ignore_ban |
Manages ban exceptions -- allows globally or network-banned users to remain unbanned in this server. Actions: add, revoke, list. |
/guild moderation sentimentscan |
On-demand sentiment scan over stored message logs. Scopes: guild, channel, user, or role. Configurable look-back window, message cap, time-bucketing granularity, and keyword prefilter. Can attach a JSON report. |
/guild management
| Command | Description |
|---|---|
/guild management audit |
Browses the guild's internal moderation audit log with pagination. |
/guild management customize |
Configures the bot's per-server profile (name, avatar, colour, etc.). |
/guild management appeal_link |
Sets or clears the guild's ban appeal link sent in punishment DMs. |
/guild management permissions |
Configures sub-permission grants for guild moderators. |
/guild management log |
Configures guild log channels. Actions: set, clear, view, setup. |
/guild management waveban |
Views or configures waveban settings (auto-execute threshold, notification channel, etc.) for this server. |
/guild utility
| Command | Description |
|---|---|
/guild utility role |
Adds or removes a role from a member. |
/guild utility profile |
Displays a member's avatar or banner. |
Punishment DMs
When a moderation action is taken, the bot attempts to DM the target with the action type, reason, and appeal link (if configured). DM types supported: ban, softban, kick, timeout, untimeout, warn, unban, quarantine, unquarantine, image-mute, react-mute.
Permission Requirements
Guild moderation commands require one of:
AdministratorDiscord permission- A guild moderator role configured via
/guild management permissions - Specific sub-permission grants (e.g.
ban,kick,manage_automod)
Network Moderation
The Network Moderation cog allows a group of servers to share a common ban list and apply moderation actions across only those servers, without affecting all bot-joined guilds.
What is a Network
A network is a named group of guilds. Guilds join a network by invitation. The network owner can manage the network and apply network-wide moderation actions. Bans applied at the network level are shared across all member guilds.
Command Groups
/network management
| Command | Description |
|---|---|
/network management create |
Creates a new network. The invoking guild becomes the first member and the creator becomes the network owner. |
/network management invite |
Generates a 24-hour join token for another guild to use when joining the network. |
/network management join |
Joins an existing network using a valid invite token. |
/network management leave |
Removes the invoking guild from the network. |
/network management disband |
Permanently disbands the network and removes all member guilds. Network owner or bot owner only. |
/network management transfer_owner |
Transfers network ownership to another user. Current owner or bot owner only. |
/network management transfer_main |
Transfers the designated main server of the network to another member guild. |
/network management list |
Lists all guilds currently in the network, including operator assignments. |
/network management operator |
Manages operators (users or main-server roles) allowed to run network moderation commands. Actions: add, remove, list. |
/network management owner |
Manages co-owners for this network (secondary owners with elevated privileges). |
/network management log |
Sets or clears the channel in the main server used for network moderation logs. |
/network management request_log |
Sets or clears the channel for /network moderation requestban approval messages. Mirrors to the global REQUEST_LOG_CHANNEL_ID when set. |
/network management appeal_link |
Sets or clears the ban appeal link used in network punishment DMs. |
/network moderation
| Command | Description |
|---|---|
/network moderation ban |
Bans a user from every guild in the network. |
/network moderation softban |
Softbans a user across every guild in the network. |
/network moderation kick |
Kicks a user from every guild in the network. |
/network moderation timeout |
Times out a user in every guild in the network. |
/network moderation untimeout |
Removes a timeout from a user in every guild in the network. |
/network moderation unban |
Unbans a user from every guild in the network. |
/network moderation massban |
Bans multiple users across every guild in the network. |
/network moderation status |
Shows the network moderation status and ban record for a user. |
/network moderation requestban |
Submits a ban request for network-level approval. |
/network moderation quarantine |
Quarantines a user across every guild in the network. |
/network moderation sync_bans |
Re-applies all active network bans across every linked server. |
Ban Sync
When a network ban is applied, it is propagated to all member guilds. Per-network and per-guild exception lists are respected during sync. Guilds can also be individually excluded from network enforcement.
Permission Requirements
Network management commands require the network owner or bot owner permission. Network moderation commands require the network owner, a network operator, a globally trusted user, or a bot owner.
Whitelist Management
The Whitelist cog controls which guilds are allowed to use the bot and manages guild join applications.
Commands
All commands are nested under /whitelist.
/whitelist guild
| Subcommand | Description |
|---|---|
add |
Adds a guild to the whitelist. Creates a permanent invite and stores metadata. |
remove |
Removes a guild from the whitelist. Sends a leave notification and the bot leaves the guild. |
list |
Shows a paginated list of all whitelisted guilds. |
get |
Displays stored and live information for a specific whitelisted guild, including change detection. |
sync |
Leaves all guilds that are not on the whitelist and purges orphaned database records. |
/whitelist applicationgate
Configures the join application gate for a guild. When enabled, new members must complete an application before gaining full access.
/whitelist bot
Guild owner only. Used to whitelist bots on your server. This is part of Sentry's Anti-Nuke system.
Permission Requirements
All whitelist commands require bot owner/guild permission.
Owner Protection
The Owner Protection cog automatically enforces protections for bot owners within Discord servers.
Features
| Feature | Description |
|---|---|
| Auto-unban | If a bot owner is banned from any guild the bot is in, they are automatically unbanned. |
| Timeout removal | If a bot owner is timed out in any guild, the timeout is automatically removed. |
| Server mute/deafen reversal | If a bot owner is server-muted or server-deafened, the action is automatically reversed. |
| Voice channel sticky lock | If a bot owner is moved out of a voice channel against their will, the bot moves them back. The owner is allowed one voluntary hop before the lock reactivates. |
Voice Sticky Lock Behavior
When a bot owner joins a voice channel, that channel is pinned. If the owner is moved to a different channel by another user, the bot automatically moves them back to the pinned channel.
The sticky lock allows one voluntary hop: if the owner moves themselves, the new channel becomes the pinned channel and the lock reactivates there.
At bot startup, if a bot owner is already in a voice channel, the sticky lock is seeded for that channel.
Sentry | Debug Role
In every whitelisted guild, the bot maintains a Sentry | Debug role. Bot owners are assigned this role automatically and it is restored if it is removed, renamed, or deleted. The role is repositioned below the bot's highest managed role on setup and at regular intervals.
Configuration
Owner protection features are controlled by the owner_protection_is_on check. Contact the bot owner to enable or disable specific protections.
Internal Anti-Nuke
The Internal Anti-Nuke cog protects against bot token theft. If an attacker obtains the bot's token and sends API requests directly, those requests appear in the guild audit log attributed to the bot but have no matching authorization window -- triggering an immediate guild leave.
Authorization Windows
The cog maintains four types of authorization windows. Any match is sufficient to authorize an action:
| Window | Duration | Description |
|---|---|---|
| Task window | Duration of task | A recognized background task (e.g. sync_bans_task) is actively running. Covers all guilds globally while active. |
| Owner window | 5 minutes | A bot owner ran a command (prefix or slash, including jishaku) in this guild. A guild ID of 0 acts as a global owner window covering every guild simultaneously. |
| Command window | 60 seconds | Any non-owner command was invoked in this guild. |
| Join window | 10 minutes | The bot just joined this guild, covering the flood of auto-bans and role creations during on_guild_join. |
Monitored Audit Log Actions
The following actions are monitored. If the bot performs any of these outside an authorization window it immediately leaves the guild:
bankickunbanchannel_deleterole_deleteguild_updatewebhook_createwebhook_deletebot_add
Actions such as role_create, role_update, channel_update, member_update, and invite_create are not monitored because the bot performs them legitimately and frequently (quarantine setup, mute roles, etc.).
Verification System
The Verification cog provides a captcha-based member verification system. New members are prompted to complete a verification challenge before gaining access to the server.
Verification Modes
| Mode | Behavior |
|---|---|
auto |
Bot automatically DMs a captcha link to new members on join. |
panel |
Users click a button in a designated channel to start verification. |
blind |
Verification is skipped entirely (members pass automatically). |
Verification Flow
- Member joins or clicks the verification button.
- Bot sends a captcha link via DM (or the configured verification channel).
- The captcha API polls until the member passes, fails, or the session expires.
- On pass: verified role is assigned, unverified role is removed.
- On VPN/proxy detection or alt detection: the configured action (ban, kick, or log only) is applied.
- On expiry: the configured expire action is applied.
Commands
All commands are nested under /verify.
/verify
| Command | Description |
|---|---|
/verify panel |
Posts the verification button panel to the current channel. |
/verify request |
Starts or restarts the caller's own verification session. |
/verify manverify |
Manually verifies a member, bypassing captcha. Requires verify staff. |
/verify manunverify |
Removes verification from a member. Requires verify staff. |
/verify status |
Shows a member's verification status and any known alt accounts. |
/verify add_alt |
Manually links two Discord accounts as an alt pair. Bot owner only. |
/verify verbose |
Toggles verbose logging (raw API payload) for this guild. Bot owner only. |
/verify config
| Command | Description |
|---|---|
/verify config channel |
Sets the channel (or thread) where users receive verification instructions. |
/verify config logchannel |
Sets the channel where verification logs are posted. |
/verify config verifiedrole |
Sets the role assigned to members after successful verification. |
/verify config unverifiedrole |
Sets the role assigned to new members awaiting verification. |
/verify config mode |
Sets the verification mode: auto, panel, or blind. |
/verify config vpnaction |
Sets the action taken when a VPN or proxy is detected: ban, kick, or log. |
/verify config altaction |
Sets the action taken when an alt account is detected: ban, kick, or log. |
/verify config expireaction |
Sets the action taken when a verification session times out: ban, kick, or log. |
Permission Requirements
Verify staff commands (manverify, manunverify, panel, status) require Administrator or the configured verify staff role. Config commands require Administrator. add_alt and verbose require bot owner.
Tickets
The Tickets cog provides a full-featured ticket system with panels, autoresponders, transcripts, and in-ticket management actions.
Concepts
- Panel -- a configured set of ticket types that users can open from a posted embed/button. Multiple panels can exist per guild.
- Ticket -- an individual support channel created when a user opens a ticket from a panel.
- Transcript -- an HTML log of all messages in a ticket, generated on close or delete.
- Autoresponder -- a keyword-triggered automatic reply within ticket channels.
- Blacklist -- per-panel or server-wide lists of users prevented from opening tickets.
- Priority -- a label (low / medium / high / critical) that can be set on a ticket.
Commands
All commands are nested under /ticket.
Ticket Management
| Command | Description |
|---|---|
/ticket manage |
Opens the interactive ticket panel manager for creating, editing, and posting panels. |
/ticket autoresponders |
Opens the interactive autoresponder manager (ticket channels only). |
In-Ticket Actions
| Command | Description |
|---|---|
/ticket close |
Closes the current ticket, generates a transcript, and archives the channel. |
/ticket open |
Re-opens a previously closed ticket. |
/ticket delete |
Deletes the ticket channel after generating a transcript. |
/ticket escalate |
Escalates this ticket to another panel, sending that panel's welcome message. |
/ticket transcript |
Generates and sends an HTML transcript of the ticket without closing it. |
/ticket claim |
Claims the ticket, assigning yourself as the handler. |
/ticket unclaim |
Unassigns yourself as the ticket handler. |
/ticket rename |
Renames the ticket channel. Omit the name argument to reset to the default. |
/ticket add |
Adds a user to the ticket channel. |
/ticket remove |
Removes a user from the ticket channel. |
/ticket priority |
Sets the priority label on this ticket (low / medium / high / critical). |
/ticket closerequest |
Requests that this ticket be closed (notifies the opener for confirmation). |
/ticket blacklist |
Manages ticket blacklists. |
Permission Requirements
In-ticket management actions require the user to be ticket staff (a role configured per panel) or have Administrator. Opening and closing requests are available to the ticket opener.
Roblox Integration
The Roblox cog integrates with the Roblox Open Cloud API for user lookups and universe ban management. It requires ROBLOX_API_KEY and ROBLOX_UNIVERSE_ID to be configured in the environment.
Commands
All commands are nested under /roblox.
/roblox users
| Command | Description |
|---|---|
/roblox users profile |
Retrieves and displays a Roblox user's profile information by username or user ID. |
/roblox universes
| Command | Description |
|---|---|
/roblox universes user_restrictions |
Lists all active user restrictions (bans) in the configured universe. |
/roblox universes get_user_restriction |
Gets the restriction details for a specific Roblox user in the universe. |
/roblox universes update_user_restriction |
Bans or unbans a Roblox user in the universe. |
/roblox universes list_user_restriction_logs |
Lists the restriction change log history for the universe. |
Permission Requirements
All Roblox commands require globally trusted or bot owner permission.
Music
The Music cog provides audio playback in voice channels via a Lavalink backend (using the mafic library). It is only loaded when LAVALINK_HOST, LAVALINK_PORT, and LAVALINK_PASSWORD are configured in the environment.
Commands
All commands are nested under /music.
| Command | Description |
|---|---|
/music join |
Connects the bot to the caller's current voice channel. |
/music play |
Searches for a track or plays a direct URL. Supports YouTube, SoundCloud, and other Lavalink-supported sources. |
/music pause |
Pauses playback. |
/music resume |
Resumes paused playback. |
/music skip |
Skips the current track. |
/music stop |
Stops playback and clears the queue. |
/music disconnect |
Clears player state and moves the bot to its home voice channel (if configured). |
/music queue |
Shows all upcoming tracks in the queue with pagination. |
/music nowplaying |
Replaces or posts the now-playing panel embed showing the current track. |
/music autoplay |
Toggles autoplay of related tracks when the queue is empty. |
/music shuffle |
Shuffles the current queue. |
/music lyrics |
Fetches lyrics for the currently playing track. |
/music volume |
Sets playback volume (1--100). |
/music seek |
Seeks to a specific position in the current track (e.g. 1m30s). |
/music loop_track |
Toggles looping of the current track. |
/music loop_queue |
Toggles looping of the entire queue. |
Permission Requirements
Playback control commands require the caller to be in the same voice channel as the bot (or in a voice channel if the bot is idle). Volume and skip commands may have additional restrictions depending on configuration.
Context Menu Commands
Right-click context menu commands appear when right-clicking a user in Discord (User menu). These commands display moderation status information.
| Command | Available in | Description |
|---|---|---|
| Guild Moderation Status | Guild only | Shows the guild-level moderation history and profile for the selected user. Relays to /guild moderation status. |
| Network Moderation Status | Guild only | Shows the network-level moderation history for the selected user. Requires the guild to be part of a network. |
| Global Moderation Status | Guild and DMs | Shows the global moderation history and ban record for the selected user. |
Permission Requirements
Context menu commands follow the same permission requirements as their equivalent slash commands.
User App Commands
The User App cog provides a single /userapp command available as a user-install application. This means it works without the bot being in a server, including in DMs.
Command
| Command | Choice | Description |
|---|---|---|
/userapp |
global_ban |
Bans a user globally across all bot-joined guilds. |
/userapp |
global_unban |
Unbans a user globally. |
/userapp |
global_massban |
Bans multiple users globally. |
/userapp |
global_massunban |
Unbans multiple users globally. |
/userapp |
global_status |
Shows the global moderation status for a user. |
/userapp |
global_sync_bans |
Syncs the global ban list to one or all guilds. |
/userapp |
whitelist_guild |
Adds a guild to the whitelist. |
/userapp |
ping |
Checks userapp availability. |
Permission Requirements
All /userapp choices that perform actions require the globally trusted or bot owner permission.
Additional Choices
| Choice | Description |
|---|---|
echo |
Echoes back the provided reason/text. |
shutdown |
Shuts down the bot. Bot owner only. |
restart |
Pulls the latest changes from origin/main via git pull then restarts the process. Bot owner only. |
Installation
This command is installed as a user-install application (not a guild install). It does not require the bot to be a member of any server.
Prefix Commands
Prefix commands are traditional text-based commands using the guild's configured prefix (default !). They mirror most slash command functionality and support the same permission model.
Utility
| Command | Description |
|---|---|
prefix [new_prefix] |
Views the current guild prefix, or sets a new one (max 10 chars). Requires Manage Guild. |
about |
Displays bot info including latency, RAM usage, uptime, server count, user count, and punishment count. |
profile <user> |
Displays a user's avatar or banner. |
Moderation
| Command | Description |
|---|---|
ban <user> [reason] |
Bans a user from the server. |
kick <user> [reason] |
Kicks a user from the server. |
mute <member> <duration> [reason] |
Times out or role-mutes a member. |
unmute <member> [reason] |
Removes a member's timeout or role mute. |
unban <user> [reason] |
Unbans a user from the server. |
warn <member> [reason] |
Issues a warning to a member. |
clear [count] [user] |
Bulk-deletes recent messages. |
slowmode [duration] |
Sets or disables slowmode in the current channel. |
nickname <member> [name] |
Sets or clears a member's server nickname. |
status [user] |
Views a member's warn profile and moderation log. |
comms <action> [user] [args] |
Assigns, removes, or lists community service cases. |
role <member> <role> |
Assigns or removes a member role. |
Cobalt Downloader
The Cobalt Downloader cog automatically detects links to supported media services (e.g. TikTok, Instagram, Twitter/X, YouTube Shorts) posted in configured guilds and re-uploads the media as a direct file attachment via the cobalt.tools API.
Behavior
- Listens for messages containing supported service URLs.
- Fetches the media via the cobalt API.
- Uploads the result as a file attachment in the same channel.
- Requires Manage Messages permission to delete the original link message after re-upload (optional, depending on configuration).
- Only active in guilds listed in the internal
_ENABLED_GUILDSallow-list.
No Slash Commands
This feature has no user-facing slash commands. It operates entirely as a background message listener.