Reference

Discord IDs are snowflakes: long numeric IDs copied from Discord with Developer Mode enabled (User Settings → Advanced), then right-click → Copy ID.

Server ID

The guild the bot manages.

Channel ID

A text channel the bot reads or posts to.

Role ID

A role used for admin access, exemptions, auto-roles, or rewards.

User ID

A specific member used for admin access or moderation exemptions.

123456789012345678

Welcome, goodbye, and level-up messages replace these tags when posted.

{user}

Username or display name.

{mention}

Discord mention for the member.

{tag}

Username tag when available.

{server}

Server name.

{count}

Member count, for join/leave messages.

{level}

New level, for level-up messages.

Welcome: Welcome {mention}! You are member #{count}.
Goodbye: {user} left {server}.
Level-up: GG {mention}, you reached level {level}!

Trigger phrases

Full example questions or support statements, one per line.

Keywords

Optional single words that help a message match.

Answer

The exact message the bot posts.

Reply cooldown

Optional seconds before that FAQ can repeat in the same channel.

Trigger phrases:
How do I reset my password?
password reset not working

Keywords:
password
reset

Commands are exact responders, separate from fuzzy FAQ matching.

Exact

The whole message must equal the trigger.

Starts with

The message must begin with the trigger.

Contains

The trigger may appear anywhere in the message.

Trigger: !rules
Match: Exact message
ID: rules
Response:
Read the server rules in #rules before posting support questions.

Phrases

Any listed phrase can trigger the rule.

All terms

Every listed term must appear.

Any terms

At least one listed term must appear.

Regex

Advanced JavaScript regular expressions; keep them short and specific.

Require URL

Only match messages that contain a link.

ID: scam-airdrop
Action: timeout
Reason: Crypto airdrop scam
Phrases:
free airdrop
claim your reward
Any terms:
wallet
airdrop
Timeout seconds: 86400

What a rule or detector does when it matches, from mildest to strongest.

log

Records the match only.

delete

Removes the message.

warn

Warns the member.

timeout

Temporarily mutes the member.

kick

Removes the member from the server.

ban

Removes the member and blocks rejoin.

Repository settings use owner/repo only — never a full URL.

owner/repo
sparkbugz/bugbot

FAQ entries can attach a fixed GitHub URL, or search GitHub when that FAQ matches.

{
  "mode": "search",
  "repos": ["owner/repo"],
  "type": "both",
  "query": "oauth callback error",
  "minScore": 0.63
}

{
  "mode": "fixed",
  "url": "https://github.com/owner/repo/issues/123"
}

Level rewards use level:roleId, one per line. The role must be below the bot's highest role.

5:123456789012345678
10:234567890123456789