Settings Commands

Configure Raptor's behavior and logging for your server.

Logging Configuration

Dashboard Logging Category

Logging settings now live in their own dashboard category:

Dashboard -> Select Server -> Logging

This page includes a Logging Master Switch to quickly enable/disable all logging output.

settings logchannel

Sets the channel where moderation logs are sent.

Usage:

/settings logchannel [channel]

Example:

/settings logchannel #mod-logs

What Gets Logged:

  • Mutes and unmutes
  • Kicks and bans
  • Warnings issued/removed
  • Message edits and deletions
  • Filtered messages
  • All moderation actions

Required Role: Admin

Best Practice

Create a dedicated private channel for mod logs that only moderators can see.

settings logoverride_add

Adds or updates a channel/category override for message edit/delete logs.

Use this when you want one area (like #nsfw) to log to a different channel than the default mod log channel.

Usage:

/settings logoverride_add [log_channel] [source_channel?] [source_category?] [events?]

Examples:

/settings logoverride_add #nsfw-logs source_channel:#nsfw events:both
/settings logoverride_add #tickets-logs source_category:Tickets events:delete

Rules:

  • Provide exactly one source: source_channel or source_category
  • events supports edit, delete, or both
  • Channel overrides are checked before category overrides

Required Role: Admin

settings logoverride_remove

Removes an existing message log override.

Usage:

/settings logoverride_remove [source_channel?] [source_category?]

Examples:

/settings logoverride_remove source_channel:#nsfw
/settings logoverride_remove source_category:Tickets

Required Role: Admin

settings logoverride_list

Shows all configured message log overrides.

Usage:

/settings logoverride_list

Required Role: Admin

settings joinchannel

Sets the channel for member join/leave notifications.

Usage:

/settings joinchannel [channel]

Example:

/settings joinchannel #member-logs

What Gets Logged:

  • Member joins
  • Member leaves
  • New member information
  • Join timestamps

Required Role: Admin

Optional

This is optional but useful for tracking member activity and auditing.

settings announceupdate

Sets the fallback channel for bot announcements.

Usage:

/settings announceupdate [channel]

Example:

/settings announceupdate #announcements

Used For:

  • Bot update announcements
  • Service notifications
  • Important system messages

Required Role: Admin

settings tempvoicecreatevc

Creates and binds a dedicated voice channel that users can join to auto-create their own temporary VC.

Usage:

/settings tempvoicecreatevc [category] [trigger_name] [default_vc_name]

Example:

/settings tempvoicecreatevc Voice Channels "Join to create vc" "Temp VC - {user}"

What It Configures:

  • Temp voice creation category
  • Voice-to-create trigger channel bind
  • Default temporary VC name template

Template Placeholders:

  • {user}
  • {display_name}
  • {username}

Required Role: Admin

Content Configuration

Permission Role Configuration

Set the custom moderator roles for Raptor's permission system.

settings modrole

Sets the moderator role for standard moderation access.

Usage:

/settings modrole [@Role]

Example:

/settings modrole @Moderator

Access Level:

  • Full moderation capabilities
  • Can issue warnings, mute, kick
  • Can manage filters and settings

Required Role: Admin

settings adminrole

Sets the administrator role for full access.

Usage:

/settings adminrole [@Role]

Example:

/settings adminrole @Administrator

Access Level:

  • All moderation capabilities
  • Server configuration access
  • Full system control

Required Role: Admin

settings trial_mod

Sets the trial moderator role for limited access.

Usage:

/settings trial_mod [@Role]

Example:

/settings trial_mod @TrialMod

Access Level:

  • Basic moderation only
  • Limited warning system access
  • Supervised capabilities

Required Role: Admin

Role Hierarchy

Consider your role hierarchy: Trial Mod < Moderator < Administrator

Configuration Checklist

After setting up Raptor, verify your configuration:

  • [ ] Log channel set: /settings logchannel

  • [ ] Message log overrides configured as needed: /settings logoverride_add

  • [ ] Join channel set: /settings joinchannel

  • [ ] Announcement channel set: /settings announceupdate

  • [ ] Temp voice creator channel configured: /settings tempvoicecreatevc or Dashboard → Core Settings

  • [ ] Moderator roles configured: /settings modrole, /settings adminrole, /settings trial_mod

  • [ ] Starboard module configured in Dashboard → Starboard

Dashboard Starboard Module

Starboard is configured from the web dashboard for each server.

Path:

Dashboard -> Select Server -> Starboard

Available Settings:

  • Enabled toggle
  • Destination channel
  • Reaction mode (⭐ only or any emoji)
  • Reaction threshold (minimum reaction count)
  • Channel blacklist
  • Category blacklist

Access Required: Dashboard Editor or Dashboard Admin

Viewing Current Settings

Help

Run any settings command with --help to view current values and configuration options.

Troubleshooting

Settings not applying?

  • Ensure you have Manage Server permission
  • Verify the bot has permission to send messages in log channels
  • Restart the bot if changes don't take effect

Logs not appearing?

  • Check that the log channel exists and bot can access it
  • Verify the channel permissions allow the bot to post
  • Confirm logging is enabled in settings

Need special routing for specific channels/categories?

  • Use /settings logoverride_add or Dashboard → Core Settings → Message Log Overrides