Commands

The plugin registers all commands under the /mod group. Context menu commands appear when right-clicking users or messages in Discord.

Moderation actions

/mod ban

Ban a member from the server.

Required permission: BanMembers

The delete_messages option provides these choices:

The command persists the ban reason to Flashcore and logs the action to the moderator logs channel. The response includes an Unban button that moderators can click to reverse the ban.

When confirmation mode is enabled, a modal appears asking the moderator to type "yes" before the ban executes.

When anonymous is true, the ban embed is posted to the channel as a regular message (not attributed to any moderator), and the moderator receives an ephemeral confirmation.

/mod kick

Remove a member from the server.

Required permission: KickMembers

When delete_messages is specified, the plugin scans text channels and deletes up to 5 recent messages from the kicked user in the background. Messages older than 14 days are skipped (Discord API limitation). A 1-second delay between deletions avoids rate limits.

The command prevents kicking yourself, the bot, or the server owner.

/mod timeout

Temporarily mute a member.

Required permission: ModerateMembers

Duration choices:

/mod warn

Issue a warning and increment the member's strike count.

Required permission: ModerateMembers

Each warning increments the member's infraction count, which is persisted in Flashcore. The warning embed shows the current infraction count in its footer. In test mode, infractions are not incremented.

/mod forgive

Clear a member's strikes and infractions.

Required permission: ModerateMembers

Resets the member's infraction count to 0 in Flashcore.

Information and reporting

/mod audit

View a member's moderation history.

Required permission: ModerateMembers

Displays an embed with the user's avatar, ban status (active or banned with reason), infraction count, and join date. Includes a Ban or Unban button depending on the user's current status.

/mod report

Submit a report to the moderator mail channel.

Required permission: None (any server member can use this)

Sends a report embed to the configured moderator mail channel. The reporter always receives an ephemeral confirmation. When anonymous, the report shows "anonymous user" instead of the reporter's identity.

Requires a moderator mail channel to be configured via /mod setup.

/mod setup

Configure moderation settings for the server.

Required permission: ModerateMembers

Opens an interactive panel with:

• Channel select menus for moderator logs and moderator mail
• Create channels button to auto-create restricted channels
• Test mode toggle — simulate actions without executing them
• Require confirmation toggle — show a confirmation modal before destructive actions
• Lockdown mode toggle — restrict all bot commands to moderators
• Reset settings button — clear all channel assignments and disable toggles

See Moderation Channels for details on the channel setup flow.

Rules commands

/mod rules-msg set-rules

Opens a modal to configure the rules embed content.

Required permission: Administrator

The modal has three fields:

Values are persisted in Flashcore. After submission, a preview of the rules embed is shown.

/mod rules-msg set-member-role

Set the role granted when users accept the rules.

Required permission: Administrator

The role name is stored in Flashcore. Members who click the accept button on the rules message receive this role.

/mod rules-msg send

Post the rules message with an accept button.

Required permission: Administrator

Sends the rules embed to the current channel with an accept button. Requires both rules content and a member role to be configured first. The channel is recorded as the rules channel for enforcement purposes.

See Rules System for the complete workflow.

Context menu commands

Report Anonymously (Message)

Right-click any message and select Report Anonymously. A modal prompts for the reason. The report is sent to the moderator mail channel with the message content, a link to the original message, and the reported member's info. The reporter's identity is always hidden.

Required permission: None

Audit (User)

Right-click any user and select Audit. Displays the same audit embed as /mod audit with ban status, infraction count, and a Ban/Unban button.

Required permission: ModerateMembers

Ban/Unban buttons

Audit embeds and ban confirmations include interactive buttons:

• Ban — Bans the user, persists the ban record to Flashcore, and logs the action. Replaces itself with an Unban button.
• Unban — Removes the ban from Discord, deletes the Flashcore ban record, and logs the action.

Both buttons require BanMembers permission and respect test mode.

Anonymous mode

Five commands support anonymous execution: ban, kick, warn, forgive, and report. When the anonymous option is true:

1. The result embed is posted to the channel as a regular message (not attributed to any moderator)
2. The moderator receives an ephemeral confirmation only they can see
3. The moderator logs channel still records who performed the action

Test mode behavior

When test mode is enabled via /mod setup:

• No actual Discord actions are executed (no bans, kicks, timeouts, etc.)
• Infraction counts are not modified
• All actions are logged to the moderator logs channel with a [TEST] prefix
• The moderator sees a yellow "Test mode" embed confirming no action was taken

Confirmation mode behavior

When confirmation mode is enabled via /mod setup:

• The /mod ban command shows a modal asking the moderator to type "yes" before executing
• If the moderator types anything other than "yes", the action is cancelled
• Other commands are not affected by confirmation mode

Next Steps