Commands — Ammonite

Moderation

/ban▶ Ban a user from the server (permanent or timed) mod.ban

Syntax

/ban <user> [duration] [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to ban
`duration`	String	No	Duration of the ban. Omit for permanent. Formats: `1d`, `2h`, `30m`, `1w`, `12h30m`
`reason`	String	No	Reason for the ban (logged in mod history). Defaults to "No reason provided"

Examples

/ban @John 7d Repeated rule violations — Bans John for 7 days

/ban @Spammer — Permanently bans a user with no reason

/ban @User 2h30m Cooling off — Bans for 2 hours and 30 minutes

Details

Deletes the user's messages from the last 7 days when banning.
If a duration is specified, the bot will automatically unban the user after the time expires.
A DM notification is sent to the user (if /punishment-dm is enabled), including the reason, duration, and an appeal button.
The action is logged to the mod history, accessible via /hist.
Role hierarchy is enforced — you can only ban users with roles below yours.

Screenshot

Example of the /ban command in action

Feedback shown to the moderator executing /ban

/unban▶ Unban a user from the server mod.unban

Syntax

/unban <user> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to unban
`reason`	String	No	Reason for unbanning

Examples

/unban @John Appeal approved

Details

Removes the user from the server's ban list, allowing them to rejoin.
The action is logged in moderation history.

Screenshot

Example of the /unban command

Feedback shown to the moderator executing /unban

/kick▶ Kick a user from the server mod.kick

Syntax

/kick <user> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to kick
`reason`	String	No	Reason for the kick. Defaults to "No reason provided"

Examples

/kick @John Breaking server rules

Details

The user is removed from the server but can rejoin with a new invite link.
A DM notification is sent to the user if punishment DMs are enabled.
Role hierarchy is enforced.
Logged in moderation history and AutoLog channel.

Screenshot

Example of the /kick command

Feedback shown to the moderator executing /kick

/softban▶ Softban a user (ban then immediately unban to delete their messages) mod.softban

Syntax

/softban <user> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to softban
`reason`	String	No	Reason for the softban

Examples

/softban @Spammer Cleaning up spam messages

Details

Bans the user (deleting their last 7 days of messages) and immediately unbans them.
Effectively a "kick + message purge" — the user is removed and can rejoin, but their messages are cleaned up.
Useful for dealing with spam raids or nuking a user's message history.

Screenshot

Example of the /softban command

/warn▶ Warn a user (adds to their warning count) mod.warn

Syntax

/warn <user> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to warn
`reason`	String	No	Reason for the warning. Defaults to "No reason provided"

Examples

/warn @John Please follow the rules

/warn @User Spamming in chat

Details

Adds a warning to the user's record. The total warning count is displayed in the response.
Warnings are stored per-server and can be viewed with /warns.
A DM notification is sent to the warned user if punishment DMs are enabled.
Cannot warn bots. Role hierarchy is enforced.

Screenshot

Example of the /warn command

Feedback shown to the moderator executing /warn

Example of an expiring warning

/unwarn▶ Remove the most recent warning from a user mod.unwarn

Syntax

/unwarn <user> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to remove a warning from
`reason`	String	No	Reason for removing the warning

Examples

/unwarn @John Warning was unjustified

Details

Removes the most recent warning from the user's record.
Shows the removed warning's original reason and remaining warning count.
Logged to moderation history and AutoLog channel.

Screenshot

Example of the /unwarn command

Feedback shown to the moderator executing /unwarn

/warns▶ View a user's active warnings mod.warn

Syntax

/warns [user]

Parameters

Name	Type	Required	Description
`user`	User	No	User to check warnings for. Defaults to yourself

Examples

/warns @John — View John's warnings

/warns — View your own warnings

Details

Displays each warning with the reason, moderator who issued it, and timestamp.
Shows total warning count.

Screenshot

Example of the /warns command output

/mute▶ Mute a user (role-based mute with optional duration) mod.mute

Syntax

/mute <user> [duration] [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to mute
`duration`	String	No	Duration of mute (e.g., `1h`, `30m`, `2d`). Omit for permanent
`reason`	String	No	Reason for the mute

Examples

/mute @John 1h Inappropriate language

/mute @User 30m — 30 minute mute with no reason

Details

Applies a mute role that removes speaking permissions.
Timed mutes are automatically reversed when the duration expires.
DM notification sent if punishment DMs are configured.

/unmute▶ Unmute a user mod.unmute

Syntax

/unmute <user> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to unmute
`reason`	String	No	Reason for unmuting

Examples

/unmute @John Served their time

/timeout▶ Timeout a user using Discord's built-in timeout feature mod.timeout

Syntax

/timeout <user> <duration> [reason]

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to timeout
`duration`	String	Yes	Duration (e.g., `1h`, `30m`, `1d`). Max 28 days
`reason`	String	No	Reason for the timeout

Examples

/timeout @John 1h Needs to cool down

Details

Uses Discord's native timeout feature — the user cannot send messages, react, or join voice channels for the duration.
Requires the bot to have the Moderate Members permission.
Maximum duration is 28 days (Discord limitation).

Screenshot

Example of the /timeout command

Feedback shown to the moderator executing /timeout

/hist▶ View a user's full moderation history mod.history

Syntax

/hist <user>

Parameters

Name	Type	Required	Description
`user`	User	Yes	The user to view history for

Examples

/hist @John — View John's moderation history

Details

Shows the last 20 moderation actions for the user (bans, kicks, warns, mutes, etc.).
Each entry includes the action type, reason, moderator, and timestamp.
Useful for reviewing a user's track record before taking further action.

Screenshot

Example of the /hist command output

/purge▶ Bulk delete messages, reactions, replies, or threads mod.purge

Syntax

/purge <type>

Parameters

Name	Type	Required	Description
`type`	Choice	Yes	What to purge: `messages`, `reactions`, `replies`, or `threads`

Examples

/purge messages — Bulk delete recent messages

/purge reactions — Clear all reactions from recent messages

Details

Requires Manage Messages and Read Message History bot permissions.
Messages older than 14 days cannot be bulk-deleted (Discord limitation).

/lockdown▶ Lock or unlock a channel to prevent regular users from sending messages mod.lockdown

Syntax

/lockdown [channel]

Parameters

Name	Type	Required	Description
`channel`	Channel	No	Channel to lock/unlock. Defaults to the current channel

Examples

/lockdown — Toggle lockdown on the current channel

/lockdown #general — Lock/unlock a specific channel

Details

Toggles the channel's permission override for @everyone to deny sending messages.
Running the command again unlocks the channel.

/wordfilter▶ Manage the server's custom word and regex phrase filter mod.wordfilter

Subcommands

Subcommand	Description
`add <pattern>`	Add a plain word or regex pattern to the filter (max 100 patterns)
`remove <pattern>`	Remove a pattern by exact text
`removeat <index>`	Remove a pattern by its 1-based list index
`list`	Show all current filter patterns, status, and action
`clear`	Remove all patterns
`enable`	Enable the word filter
`disable`	Disable the word filter
`action <delete\|warn\|delete+warn>`	Set what happens when a message matches

Notes

Patterns are matched as regex — plain words like badword work too (they're valid regex)
Members with the automod.wordfilter.bypass permission are exempt
Action delete+warn removes the message and issues an automatic warn logged to the moderation log channel

Examples

/wordfilter add badword

/wordfilter add \b(bad|terrible)\s+word\b — regex pattern

/wordfilter action delete+warn

Economy

/balance▶ Check your or another user's balance economy.balance

Syntax

/balance [user]

Parameters

Name	Type	Required	Description
`user`	User	No	User to check. Defaults to yourself

Examples

/balance — Check your own balance

/balance @John — Check John's balance

/daily▶ Claim your daily reward economy.daily

Syntax

/daily

Details

Awards the server's configured daily reward amount.
Can only be claimed once every 24 hours.
The daily reward amount is configurable via /settings.

/work▶ Work a random job to earn points economy.work

Syntax

/work

Details

Generates a random job scenario and reward.
Has a cooldown between uses.

/pay▶ Pay coins to another user economy.pay

Syntax

/pay <user> <amount>

Parameters

Name	Type	Required	Description
`user`	User	Yes	User to pay
`amount`	Integer	Yes	Amount of coins to transfer

Examples

/pay @John 500 — Transfer 500 coins to John

/rob▶ Attempt to rob points from another user economy.rob

Syntax

/rob <user>

Details

Has a chance to succeed or fail. If you fail, you lose coins.
You can only rob coins from a user's wallet — bank balance is protected.

/baltop▶ Shows the server balance leaderboard economy.baltop

Syntax

/baltop

Details

Displays a leaderboard of the richest users in the server.

/bank▶ Manage banking — deposit, withdraw, loans, and admin settings economy.balance

Syntax

/bank <setting> [action] [user] [amount]

Examples

/bank setting:balance — View your bank balance

/bank setting:balance action:add user:@John amount:1000 — Admin: add 1000 to John's bank

Details

Bank balance is protected from /rob.
Admins can configure max loan amounts, interest rates, and auto-collection.

/gamble▶ Try your luck with various gambling games economy.games.*

Syntax

/gamble <game> <points>

Parameters

Name	Type	Required	Description
`game`	Choice	Yes	Game to play: `blackjack`, `cointoss`, `poker`, `rockpaperscissors`
`points`	Integer	Yes	Amount of coins to bet

/blackjack▶ Play a game of blackjack economy.games.blackjack

Syntax

/blackjack <bet>

Details

Full blackjack with Hit, Stand, and Double Down buttons.
Interactive button-based interface.
Standard blackjack rules and payouts.

/flip▶ Flip a coin and bet on heads or tails economy.games.flip

Syntax

/flip <bet> <choice>

/dice▶ Roll a dice and bet on the outcome economy.games.dice

Syntax

/dice <bet> <number>

/slots▶ Play the slot machine economy.games.slots

Syntax

/slots <bet>

Details

Triple match: big multiplier payout (up to 20x for rare symbols).
Double match: smaller payout (1x-2x).

/chargeback▶ Reverse a transaction and log the action (admin) economy.admin.*

Syntax

/chargeback <id> <reason>

/add▶ Add to a user's balance (admin) economy.admin.add

Syntax

/add <user> <amount>

/subtract▶ Subtract from a user's balance (admin) economy.admin.remove

Syntax

/subtract <user> <amount>

/set▶ Set a user's balance (admin) economy.admin.set

Syntax

/set <user> <amount>

Leveling

/rank▶ Display rank information for a user leveling.rank

Syntax

/rank [user]

Details

Shows level, XP, XP needed for next level, and server rank position.

/leaderboard▶ Show the XP/level leaderboard leveling.leaderboard

Syntax

/leaderboard

Details

Displays the top users by XP in the server. Alias: /lb

/xp▶ Manage user XP (add, subtract, or set) leveling.admin.*

Syntax

/xp <action> <amount> <user>

Examples

/xp add 500 @John — Add 500 XP to John

/xp set 0 @User — Reset a user's XP to 0

/level▶ Manage user levels (add, subtract, or set) leveling.admin.*

Syntax

/level <action> <level> <user>

Examples

/level set 10 @John — Set John's level to 10

Games

/chess▶ Start a chess game against another player or the bot —

Syntax

/chess [opponent]

Parameters

Name	Type	Required	Description
`opponent`	User	No	Player to challenge. Leave empty to play against the bot AI

Details

Full chess with move validation, check/checkmate detection.
Interactive button interface for moves, draw offers, and resignation.
Board rendered with text and emoji pieces.

/poker▶ Play five-card draw poker economy.games.*

Syntax

/poker <bet>

Details

Five-card draw with hold/discard mechanics via buttons.
Standard poker hand rankings and payouts.

Configuration

/settings▶ Configure server settings admin.settings

Syntax

/settings <setting> [value]

Examples

/settings setting:daily-reward value:100 — Set the daily reward to 100 coins

Details

Central hub for all server configuration — economy, leveling, moderation, and general settings.
Run without a value to see the current setting.

/autoconfig▶ Launch the guided bot configuration wizard admin.settings

Syntax

/autoconfig

Details

Walks you through configuring the bot step-by-step with interactive menus.
Covers log channels, moderation settings, economy toggles, welcome messages, and more.
Recommended for first-time setup.

/permissions▶ Manage user, role, and server permissions admin.permissions

Syntax

/permissions <target> <action> [target-entity] [node] [value]

Examples

/permissions target:user action:set target-entity:@John node:mod.ban value:true

/permissions target:role action:view target-entity:@Moderator

Details

Supports user, role, and everyone targets.
Actions: set, remove, view.
See Permissions for the full list of nodes.

/config▶ Manage bot configuration admin.config

Syntax

/config [action]

/levels▶ Enable or disable the leveling system admin.settings

Syntax

/levels <enable/disable>

/points▶ Enable or disable the economy system admin.settings

Syntax

/points <enable/disable>

/logging▶ Configure channels for moderation, message, and server-change logs admin.logging

Syntax

/logging action:set type:<type> channel:<channel>

Types include moderation, message, member, voice, server, channel, role, emoji, sticker, and webhook. Enable the bot's View Audit Log permission to include the user and ID responsible for server changes.

/log▶ Create a manual log entry logging.enable

Syntax

/log <type> <message>

/automod▶ Configure auto-moderation filters automod.*

Syntax

/automod <action>

Details

Configure spam detection, link filtering, mention spam, caps filter, invite blocking, and word blacklists.

/antispam▶ Configure anti-spam protection automod.spam

Syntax

/antispam <setting> [value]

Examples

/antispam setting:message-limit amount:10

/welcome▶ Configure welcome messages and auto-roles admin.settings

Syntax

/welcome <action> [value]

Examples

/welcome action:message text:Welcome {user} to {server}!

Details

Actions: message, color, channel, auto-role, enable, dm-enable, dm-message, test, dm-test
Variables: {user}, {username}, {server}, {membercount}
Multiple auto-roles are supported — use action:auto-role role:@Role multiple times to add up to 10 roles. Add remove:true to remove a role. Omit role to clear all.
Run /welcome with no arguments to open the interactive GUI panel.

/reactionrole▶ Manage reaction role systems admin.settings

Syntax

/reactionrole <action>

/rolepersistence▶ Configure role persistence for users who rejoin admin.settings

Syntax

/rolepersistence <action>

/punishment-dm▶ Manage punishment DM notification settings admin.settings

Syntax

/punishment-dm <action>

Details

When enabled, users receive a DM when punished with the reason, duration, and an appeal button.

/suspiciousnotify▶ Manage who gets notified when a suspicious account joins your server admin.settings

Syntax

/suspiciousnotify <action> [user] [role] [page]

Subcommands

Subcommand	Description
`add <user>`	Add a user to receive suspicious-join DM alerts
`remove <user>`	Remove a user from the alert list
`addrole <role>`	Add a role — all members with this role will be alerted
`removerole <role>`	Remove a role from the alert list
`list [page]`	View the current notify list, paginated (10 per page). The server owner is always pinned at the top.
`clear`	Remove all users and roles from the notify list
`test`	Send a test alert to the full notify list (including role members)

Details

The server owner always receives alerts regardless of the notify list.
Roles are resolved to members at alert time, so newly-added members are automatically included.
The list subcommand shows paginated navigation buttons when there are more than 10 entries.

/prefix▶ Configure prefix command settings admin.settings

Syntax

/prefix <action> [prefix]

Subcommands

enable — enable prefix commands (resets to ! if none configured)
disable — disable prefix commands entirely
add <prefix> — add a new prefix (e.g. ? or sb!)
remove <prefix> — remove a prefix; removing the last one auto-disables prefix commands
set <prefix> — replace all prefixes with a single one
status — show current prefixes and enabled/disabled state

Details

Prefix commands are separate from slash commands and are disabled by default.
Prefixes can be 1–16 characters long (no spaces, no /).
If all prefixes are removed, prefix commands are automatically disabled.
Re-enabling with no prefixes configured will reset to !.

/backup▶ Create and restore server configuration backups admin.settings

Syntax

/backup <action> [timestamp]

Details

Subcommands: create, list, delete, restore
Backups include settings, permissions, logging config, and more.

Proxy System

/proxy▶ Manage proxy members (PluralKit-style) — create, edit, delete, list —

Syntax

/proxy <action>

Details

Create proxy identities that send messages via webhooks with custom names and avatars.
Set prefix/suffix proxy tags (e.g., typing {Hello} sends as a proxy member).
See Proxy Features for a full guide.

/proxysettings▶ Manage proxy settings and switch active members —

Syntax

/proxysettings <action>

Details

Use switch <member> to auto-proxy all messages as a specific member.

/autoproxy▶ Quick-toggle autoproxy on/off —

Syntax

/autoproxy [enabled]

Details

No argument = toggle current state.
Set to true or false to enable/disable.
Use /proxysettings autoproxy for advanced mode selection.

Examples

/autoproxy — toggle

/autoproxy enabled:true — enable

Tickets

/ticket▶ Manage support tickets — create, close, add users, panels, categories —

Syntax

/ticket <action> [options]

Details

Subcommands: create, close, add, remove, panel, settings, categories
Ticket panels let users open tickets with a button click.
Categories allow organizing different types of support requests.
Transcript logging available for closed tickets.

Global Chat

/globalchat▶ Manage cross-server global chat channels globalchat.*

Syntax

/globalchat <subcommand>

Subcommands

Subcommand	Description
`create`	Create a new global chat channel (name, description, visibility, key)
`edit`	Edit an existing global chat channel's properties
`delete`	Delete a global chat channel you own
`link`	Link a server channel to a global chat
`unlink`	Unlink a server channel from its global chat
`info`	View info about a global chat channel
`list`	List your global chat channels
`setrules`	Set rules for your global chat channel
`manage`	Open the management panel (DM only)
`kick`	Kick a server from your global chat
`ban`	Ban a server from your global chat
`unban`	Unban a server
`warn`	Warn a server
`unwarn`	Clear warnings for a server
`mute`	Mute a server (with optional duration)
`unmute`	Unmute a server
`addmod`	Add a moderator to your channel
`removemod`	Remove a moderator
`addcoowner`	Add a co-owner to your channel
`removecoowner`	Remove a co-owner
`transferowner`	Transfer channel ownership
`servers`	List servers linked to a global chat
`editjoin`	Configure join messages (enable, type, title, plaintext)
`editleave`	Configure leave messages (enable, type, title, plaintext)

Examples

/globalchat create name:Lounge description:A chill cross-server chat

/globalchat link channelid:abc123 channel:#global

Details

Messages relay across servers via webhooks. See Global Chat Features for full details.

Utility

/help▶ Get help with bot commands —

Syntax

/help [command]

Details

Without arguments: shows all commands by category.
With a command name: shows detailed help for that specific command.

/ping▶ Check bot latency and response time —

Syntax

/ping

/info▶ Show bot information and statistics —

Syntax

/info

/serverstats▶ Display comprehensive server statistics —

Syntax

/serverstats

/echo▶ Send a message to a channel as the bot utility.echo

Syntax

/echo <message> [channel] [embed]

Parameters

Name	Type	Required	Description
`message`	String	Yes	The text to send (max 2000 chars)
`channel`	Channel	No	Target channel (defaults to current)
`embed`	Boolean	No	Send as an embed instead of plain text

Examples

/echo Hello World

/echo Welcome to the server! embed:true

Syntax

/embed json:<message payload or embed JSON> [channel]

Parameters

Name	Type	Required	Description
`json`	String	Yes	Discord-compatible embed object, embed array, or message payload containing up to 10 embeds. Button components are supported.
`channel`	Channel	No	Destination channel (default: current channel)

Examples

/embed json:{"embeds":[{"title":"Welcome","color":5793266},{"description":"Read the rules first."}]}

/embedgui▶ Build, preview, import, and export messages with up to 10 embeds Open to everyone; send permission required

Parameters

Name	Type	Required	Description
`channel`	Channel	No	Channel to send the message to (default: current)

Controls

Add, remove, and navigate between up to 10 embeds in one message
Set title, description, color, author, footer, image, thumbnail, fields, timestamps, and buttons
Export JSON — export a Discord message payload compatible with /embed and /talkas
Import JSON — load a Discord message payload or embed array into the builder

Examples

/embedgui

/embedgui channel:#announcements

/talkas▶ Send a message as a webhook with a custom name, avatar, and up to 10 embeds talkas.use / proxy.use

Syntax

/talkas name:<name> [message] [avatar] [embed_json]

Provide a message, embed JSON, or both. embed_json accepts a Discord message payload with multiple embeds and button components.

Example

/talkas name:Announcements embed_json:{"embeds":[{"title":"Update","description":"New information"}]}

/rules▶ Manage and display server rules rules.*

Syntax

/rules <action>

/pride▶ Apply pride flag overlays to avatars or images · User-installable —

Syntax

/pride <flag> [user] [image_url] [image] [custom_flag] [style] [border_style] [border_thickness] [opacity]

Options

Name	Type	Required	Description
`flag`	String	Yes*	Pride flag to apply (not needed if `custom_flag` is used). Has autocomplete.
`user`	User	No	User for avatar overlay (default: you)
`image_url`	String	No	URL of an image to overlay
`image`	Attachment	No	Upload an image file to overlay
`custom_flag`	Attachment	No	Upload a custom flag image (replaces built-in flag)
`style`	String	No	How to apply: `border` (default) or `overlay`
`border_style`	String	No	Shape when style=border: `circular` (default) or `frame`
`border_thickness`	Integer	No	Border thickness in pixels (5–512, default: 50)
`opacity`	Integer	No	Overlay opacity in percent (1–100, default: 40, overlay only)

Examples

/pride flag:trans — Apply trans flag border to your avatar

/pride flag:pride user:@friend style:overlay opacity:60 — Pride flag overlay on a friend's avatar

/pride flag:lesbian image_url:https://example.com/img.png style:border border_style:frame border_thickness:30

/pride custom_flag:<upload> image:<upload> style:overlay — Use a custom flag design on an uploaded image

Details

If no user/image/image_url is specified, applies to your own avatar.
Built-in flags are loaded from the bot's assets — use /flags to see all available.
Upload a custom_flag to use any image as the flag pattern instead of built-in flags.
User-installable — works in DMs and group chats when Ammonite is installed to your account.

/flags▶ List and display available pride flags —

Syntax

/flags

/pronouns▶ Set pronoun roles for yourself or another user —

Syntax

/pronouns <action>

/joke▶ Get a random joke —

Syntax

/joke

/dadjoke▶ Get a random dad joke —

Syntax

/dadjoke

/error▶ View comprehensive error code documentation —

Syntax

/error [category]

Examples

/error category:S — View settings error codes

Details

Categories range from A to W, each covering a different area of the bot.

/privacy▶ View the bot's privacy policy and data practices —

Syntax

/privacy

/deletedata▶ Delete all your personal data stored by the bot —

Syntax

/deletedata

Details

Permanently deletes all your personal data with a confirmation step.
This action cannot be undone.

Context Menu Commands

Right-click (or long-press on mobile) a message or user → Apps to access these commands.

Echo Message▶ Re-send a message's text to the same channel as the bot utility.echo · Message menu

How to use

Right-click any message → Apps → Echo Message.

Details

Requires the utility.echo permission (same as /echo).
Sends the selected message's plain text content to the current channel.
Only guild channels are supported — not usable in DMs.

Report Message▶ Report a message to the server's moderation log channel Everyone · Message menu

How to use

Right-click any message → Apps → Report Message.

Details

No special permissions required — any server member can use this.
Sends a report embed to the configured log channel (/log channel).
Report includes: reporter, message author, channel, message content, and a jump link.
If no log channel is configured, the user is notified to ask an admin to set one up.

Get Avatar▶ Show a user's avatar at full resolution Everyone · User menu · User-installable

How to use

Right-click any user → Apps → Get Avatar.

Details

No special permissions required.
Returns the avatar at up to 4096 px. Animated avatars include links to both GIF and PNG versions.
User-installable — works outside of servers (DMs, group chats) when you install Ammonite to your account.
Also available as the slash command /avatar [@user].

Quick Warn▶ Issue an instant warning to a user from the right-click menu mod.warn · User menu

How to use

Right-click any user → Apps → Quick Warn.

Details

Requires the mod.warn permission.
Increments the user's warning count and fires the same DM notification as /warn.
Reason is automatically set to "Warned via context menu by <moderator>".
Respects role hierarchy — cannot warn users with equal or higher roles.
For a custom reason, use /warn <user> [reason] instead.

Quick Kick▶ Kick a user from the right-click menu mod.kick · User menu

How to use

Right-click any user → Apps → Quick Kick.

Details

Requires the mod.kick permission.
Logs the action to the configured mod log channel via AutoLog.
Sends a punishment DM if enabled.
Respects role hierarchy.

Quick Ban▶ Permanently ban a user from the right-click menu mod.ban · User menu

How to use

Right-click any user → Apps → Quick Ban.

Details

Requires the mod.ban permission.
Issues a permanent ban and deletes messages from the last 7 days.
Logs the action and sends a punishment DM if enabled.
For timed bans, use /ban <user> [duration] [reason] instead.

Subcommand	Who can use	Description
`view`	Bot owner	View all users on the masterlist. ✅ = validated threat, ⚠️ = pending review. Includes a 📤 Share button to post the result publicly.
`add <userid> <reason>`	Bot owner	Manually add and auto-validate a user. Notifies all servers where the user is a member.
`remove <userid>`	Bot owner	Remove a user from the masterlist. Automatically unbans them from any server that used `ban` on this entry.
`check <userid>`	Bot owner	Look up a specific user's masterlist entry with action buttons to validate, invalidate, or remove.
`validate <userid>`	Bot owner	Mark an unverified report as a confirmed threat. Triggers cross-server notifications.
`clear`	Bot owner	Wipe the entire masterlist.
`stats`	Bot owner	View masterlist statistics (total, validated, pending, sources). Includes a 📤 Share button.
`scan`	Bot owner	Immediately scan the masterlist for deleted or suspended Discord accounts and remove them. Also runs automatically every 20 minutes. Includes a 📤 Share button.
`ban <filter>`	Server admins (Ban Members)	Mass-ban masterlist users from this server. Filter choices: `validated`, `pending`, `all`. Bans are tracked — revoking a classification auto-unbans.

Name	Type	Required	Description
`title`	String	Yes	Announcement title
`message`	String	Yes	Announcement message content
`color`	String	No	Embed color in hex (e.g. `#FF69B4`)

Command Reference

Moderation

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Syntax

Parameters

Examples

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Screenshot

Syntax

Parameters

Examples

Details

Syntax

Parameters

Examples

Details

Subcommands

Notes

Examples

Economy

Syntax

Parameters

Examples

Syntax

Details

Syntax

Details

Syntax

Parameters

Examples

Syntax

Details

Syntax

Details