/settings

Configure SecurityBot's core settings including logs, alerts, and 2FA.

circle-check

Configure SecurityBot's core settings. Use /settings view for an overview with quick-toggle buttons, or use individual subcommands to change specific settings.


Usage

Subcommand
Options
Permission
Description

view

None

Admin

Shows current settings overview with quick-toggle buttons

usage

None

Admin

View your tier and current usage against free tier limits

logs

channel (TextChannel, required)

Admin

Set the log channel for SecurityBot notifications

chat_alerts enable

None

Admin

Enable chat alert notifications

chat_alerts disable

None

Admin

Disable chat alert notifications

dms disable

None

Admin

Disable member-to-member DMs server-wide (Premium)

dms enable

None

Admin

Re-enable member-to-member DMs (Premium)

2fa register

None

Moderator+

Register for 2FA on this server

2fa deregister

None

Moderator+

Deregister from 2FA on this server

Example

/settings usage
/settings logs channel: #security-logs
/settings 2fa register

Subcommand Details

/settings view

Displays the current configuration at a glance: log channel, chat alerts status (enabled/disabled), and your 2FA registration status. Includes interactive buttons for quick toggles directly from the view.

/settings usage

Shows your server's current tier and usage against free tier limits. The response is ephemeral (only visible to you).

Free tier servers see a progress bar for each capped metric:

  • Filter Actions Today (10/day)

  • Domain Allowlist (20 entries)

  • Address Allowlist (5 entries)

  • Handle Allowlist (5 entries)

  • Invite Allowlist (5 entries)

Metrics that have reached their cap display a warning indicator.

Premium servers see a confirmation that all features are unlimited with no caps.

/settings logs

Sets the channel where SecurityBot sends log notifications (filter violations, scammer alerts, purge results, etc.). SecurityBot validates that it has MESSAGE_SEND permission in the target channel and sends a confirmation message to the new log channel.

/settings chat_alerts enable / disable

Toggles chat alert notifications on or off for your server.

/settings dms disable / enable

Toggles member-to-member DMs on or off for your server. When disabled, SecurityBot automatically re-applies the restriction every 24 hours. Requires a Premium subscription, a Community server, and the Manage Server permission.

/settings 2fa register

Starts the 2FA registration flow:

  1. SecurityBot shows a registration splash with a QR code and secret key.

  2. Scan the QR code with an authenticator app.

  3. A modal prompts you to enter a TOTP code to verify.

  4. Once verified, you are registered for 2FA on that server.

/settings 2fa deregister

Starts the 2FA deregistration flow:

  1. SecurityBot shows a deregistration confirmation splash.

  2. A modal prompts you to enter your current TOTP code to confirm.

  3. Your 2FA registration for that server is removed.


Permissions

  • /settings view -- Administrator

  • /settings usage -- Administrator

  • /settings logs -- Administrator

  • /settings chat_alerts (all) -- Administrator

  • /settings dms (all) -- Administrator (Premium, Community server required)

  • /settings 2fa (all) -- Moderator+

Last updated