Settings

Everything here is stored in the database and applied live. Fields marked “restart to fully apply” take effect after a reconnect or restart.

Discord connection: connected as BugBot#4207

Process restart…

Exits this process. Use only with systemd, Docker, PM2, or another supervisor that will start it again.

General

Which server the bot manages and how it presents itself.

Discord server ID ?restart to fully apply

Format & default

Default: Empty unless commands, dashboard, or moderation are enabled.

Allowed: Discord server ID, also called a guild snowflake. It is 5-25 digits.

Applies: After reconnect or process restart.

123456789012345678

Bot name ?

Format & default

Default: BugBot

Allowed: Short display name used for the Discord nickname and presence.

Applies: Live after saving.

Channels

Where the bot listens. Pick from the live channel list when the bot is connected.

Watched channels ?

Format & default

Default: Required from DISCORD_ALLOWED_CHANNEL_IDS; no built-in default.

Allowed: One Discord text channel ID per line. The bot ignores every channel not listed.

Applies: Live after saving.

123456789012345678
234567890123456789

Ignored channels ?

Format & default

Default: Empty.

Allowed: One Discord channel ID per line. These override watched channels.

Applies: Live after saving.

345678901234567890

FAQ & matching

Automatic answers from your FAQ entries, and how eagerly the bot replies.

FAQ auto-replies ?

Format & default

Default: On when the faq module is enabled; the default module set includes faq.

Allowed: On replies from the FAQ matcher; off disables automatic FAQ answers.

Applies: Live after saving.

FAQ match threshold ?

Format & default

Default: 0.72.

Allowed: 0-1 confidence ratio. Lower answers more often; higher answers only close matches.

Applies: Live after saving.

Only answer genuine questions ?

Format & default

Default: On.

Allowed: On gates the global GitHub fallback to likely help questions. Explicit FAQ matches still work.

Applies: Live after saving.

Reply cooldown (seconds) ?

Format & default

Default: 60 seconds.

Allowed: Seconds before the same FAQ entry or GitHub fallback can reply again in one channel.

Applies: Live after saving.

Per-user cooldown (seconds) ?

Format & default

Default: 5 seconds.

Allowed: Seconds after a successful bot reply before the same user can trigger another automatic reply in that channel.

Applies: Live after saving.

Max message length ?

Format & default

Default: 1000 characters.

Allowed: Messages longer than this are ignored by FAQ/GitHub matching.

Applies: Live after saving.

Max reply length ?

Format & default

Default: 1900 characters.

Allowed: Discord messages cannot exceed 2000 characters; the bot truncates above this cap.

Applies: Live after saving.

GitHub search

Link related issues and PRs from your repositories.

GitHub lookups ?

Format & default

Default: On when the github module is enabled; the default module set includes github.

Allowed: On allows FAQ-attached and fallback GitHub issue/PR searches.

Applies: Live after saving.

GitHub fallback search ?

Format & default

Default: Off.

Allowed: On lets the bot search GitHub only after no FAQ entry matched.

Applies: Live after saving.

Repositories ?

Format & default

Default: Empty unless GITHUB_DEFAULT_REPOS is set.

Allowed: One repository per line in owner/repo format. Do not include https://github.com/.

Applies: Live after saving.

sparkbugz/bugbot
sparkbugz/phoenix

Fallback match minimum score ?

Format & default

Default: 0.63.

Allowed: 0-1 relevance ratio. Lower returns looser matches; higher only posts very close matches.

Applies: Live after saving.

Max query length ?

Format & default

Default: 256 characters.

Allowed: Maximum normalized query text sent to GitHub.

Applies: Live after saving.

Result cache (seconds) ?

Format & default

Default: 600 seconds.

Allowed: 0 disables useful cache lifetime; higher values reduce GitHub API calls but keep older results longer.

Applies: Live after saving.

Request timeout (seconds) ?

Format & default

Default: 8 seconds.

Allowed: Seconds to wait before aborting a GitHub API request.

Applies: Live after saving.

Commands

Slash commands, prefixed chat commands, and the extras they unlock.

Slash commands ?restart to fully apply

Format & default

Default: On.

Allowed: On registers slash commands in the control server for enabled features.

Applies: After reconnect or process restart.

Chat admin commands ?

Format & default

Default: Off unless the commands module is enabled.

Allowed: On allows authorized admins to run prefixed Discord chat commands.

Applies: Live after saving.

Command prefix ?

Format & default

Default: !faqbot

Allowed: Text prefix typed before chat admin commands.

Applies: Live after saving.

!faqbot

Support triage command ?

Format & default

Default: Off.

Allowed: On adds the support triage command for authorized admins.

Applies: Live after saving.

Custom commands ?

Format & default

Default: Off.

Allowed: On enables exact custom trigger/reply commands managed on the Custom commands page.

Applies: Live after saving.

Polls ?restart to fully apply

Format & default

Default: Off.

Allowed: On registers /poll after the bot reconnects with slash commands enabled.

Applies: After reconnect or process restart.

Giveaways ?restart to fully apply

Format & default

Default: Off.

Allowed: On registers /giveaway after the bot reconnects with slash commands enabled.

Applies: After reconnect or process restart.

Moderation

Automatic enforcement. Keep dry-run on until you trust the rules.

Moderation ?

Format & default

Default: Off.

Allowed: On enables automatic moderation and moderation commands. Moderated channels must also be set.

Applies: Live after saving.

Moderated channels ?

Format & default

Default: Empty.

Allowed: One channel ID per line, or a single * to scan the whole control server.

Applies: Live after saving.

Dry-run ?

Format & default

Default: On.

Allowed: On logs what would happen without deleting, warning, timing out, kicking, or banning.

Applies: Live after saving.

Default action ?

Format & default

Default: timeout.

Allowed: Used when a moderation rule does not set its own action.

Options: log records only; delete removes the message; warn replies/DMs; timeout temporarily mutes; kick removes; ban removes and blocks rejoin.

Applies: Live after saving.

Default timeout (seconds) ?

Format & default

Default: 3600 seconds.

Allowed: Timeout duration used by timeout rules without their own duration.

Applies: Live after saving.

Ban message purge (seconds) ?

Format & default

Default: 86400 seconds.

Allowed: 0-604800 seconds. Discord does not allow deleting more than 7 days of history during a ban.

Applies: Live after saving.

Exempt users ?

Format & default

Default: Empty.

Allowed: One Discord user ID per line. Automatic moderation never acts on these users.

Applies: Live after saving.

Exempt roles ?

Format & default

Default: Empty.

Allowed: One Discord role ID per line. Automatic moderation never acts on members with these roles.

Applies: Live after saving.

Welcome & goodbye

Greet new members and note when they leave. Uses the Server Members intent, so turning these on applies after a restart.

Welcome new members ?restart to fully apply

Format & default

Default: Off.

Allowed: On posts the welcome message when a member joins.

Applies: After reconnect or process restart.

Welcome channel ?

Format & default

Default: Empty.

Allowed: Discord channel ID that receives welcome messages.

Applies: Live after saving.

Welcome message ?

Format & default

Default: Welcome to {server}, {mention}! You are member #{count}.

Allowed: Text template. Usable tags: {user}, {mention}, {tag}, {server}, {count}.

Applies: Live after saving.

Welcome {mention}! Read #rules first.

Announce leavers ?restart to fully apply

Format & default

Default: Off.

Allowed: On posts the goodbye message when a member leaves.

Applies: After reconnect or process restart.

Goodbye channel ?

Format & default

Default: Empty.

Allowed: Discord channel ID that receives goodbye messages.

Applies: Live after saving.

Goodbye message ?

Format & default

Default: {user} has left the server.

Allowed: Text template. Usable tags: {user}, {mention}, {tag}, {server}, {count}.

Applies: Live after saving.

{user} left {server}.

Auto-roles on join ?restart to fully apply

Format & default

Default: Empty.

Allowed: One role ID per line. The bot grants these roles to new members on join.

Applies: After reconnect or process restart.

Reaction roles

Let members self-assign roles by reacting to a message. The mappings live on the Reaction roles page.

Reaction roles ?restart to fully apply

Format & default

Default: Off.

Allowed: On enables reaction-role events and requires the bot to reconnect with reaction intents.

Applies: After reconnect or process restart.

Server logging

Mirror server events into a log channel. Turning logging on applies after a restart.

Enable logging ?restart to fully apply

Format & default

Default: Off.

Allowed: On records selected server events in the log channel.

Applies: After reconnect or process restart.

Log channel ?

Format & default

Default: Empty.

Allowed: Discord channel ID that receives log events.

Applies: Live after saving.

Log deleted messages ?

Format & default

Default: On.

Allowed: On records deleted messages when server logging is enabled.

Applies: Live after saving.

Log edited messages ?

Format & default

Default: On.

Allowed: On records edited messages when server logging is enabled.

Applies: Live after saving.

Log joins and leaves ?restart to fully apply

Format & default

Default: On.

Allowed: On records joins and leaves when server logging is enabled.

Applies: After reconnect or process restart.

Starboard

Repost messages the community loves to a highlights channel. Uses reactions, so turning it on applies after a restart.

Enable starboard ?restart to fully apply

Format & default

Default: Off.

Allowed: On reposts messages once they collect enough matching reactions.

Applies: After reconnect or process restart.

Starboard channel ?

Format & default

Default: Empty.

Allowed: Discord channel ID where highlighted messages are reposted.

Applies: Live after saving.

Starboard emoji ?

Format & default

Default: ⭐.

Allowed: Standard emoji, custom emoji name, or custom emoji ID.

Applies: Live after saving.

Reactions needed ?

Format & default

Default: 3 reactions.

Allowed: Number of matching reactions required before a message is reposted.

Applies: Live after saving.

Leveling

Reward activity with XP, levels, and role rewards.

Enable leveling ?

Format & default

Default: Off.

Allowed: On awards XP for qualifying chat messages.

Applies: Live after saving.

XP per message ?

Format & default

Default: 15 XP.

Allowed: XP granted for each qualifying message.

Applies: Live after saving.

XP cooldown (seconds) ?

Format & default

Default: 60 seconds.

Allowed: Seconds before one user can earn XP again.

Applies: Live after saving.

Announce level-ups ?

Format & default

Default: On.

Allowed: On posts a message when a user reaches a new level.

Applies: Live after saving.

Level-up channel ?

Format & default

Default: Empty.

Allowed: Discord channel ID for level-up messages. Empty posts in the channel where the user leveled.

Applies: Live after saving.

Level-up message ?

Format & default

Default: GG {mention}, you reached level {level}!

Allowed: Text template. Usable tags: {mention}, {user}, {tag}, {level}.

Applies: Live after saving.

{mention} reached level {level}!

Level role rewards ?

Format & default

Default: Empty.

Allowed: One reward per line in level:roleId format.

Applies: Live after saving.

5:123456789012345678
10:234567890123456789

Discard changes One save applies every section on this page.