GoofBot docs

Where the bot posts moderation events — message edits, deletes, member joins/leaves, automod actions. Pick multiple if you want the same events mirrored to several channels.

Dedicated channel(s) for moderation actions (warns, timeouts, kicks, bans). Falls back to the audit log channel if left empty. Pick multiple to mirror.

Members with any of these roles get admin-tier commands without needing the Administrator permission. Roles on your server that already have the Administrator permission are auto-suggested.

Members with any of these roles get moderator-tier commands (close tickets, warn, timeout, etc.). Admin roles are already covered.

Alternative label for moderator roles — same behavior. Pick any role you also want treated as staff/mod.

Role granted when a new member clicks I Agree on the /verifypanel. Required for verification to work.

Auto-assigned to new members on join. Removed when they verify. Leave blank to skip auto-assignment.

Watchman service posts a single auto-updating embed here. Updated only when a monitored service changes state (UP→DOWN, DOWN→UP) plus a heartbeat refresh every 15 min so a stale embed = watchman is dead.

Where new suggestions created with /suggest get posted with upvote/downvote buttons.

Where /verifypanel posts the rules + I Agree button. Informational only — not required for the feature to work.

Channel that receives the welcome embed when a new member joins.

Template for the welcome embed. Supports {user}, {server}, {memberCount}.

When enabled, new members get a DM with welcome_dm_message (in addition to the channel post).

Template sent as a DM to new members. Supports {user}, {server}, {memberCount}.

Where 'left the server' messages post. Leave blank to disable.

Template posted when a member leaves. Supports {user}, {server}, {memberCount}.

Toggle daily birthday announcements. Members opt in via /birthday set; the bot posts in birthdays_channel each day at the configured UTC hour.

Where birthday announcements get posted. Required for birthday announcements.

Optional role to grant a member on their birthday and remove the next day.

When enabled, DM the birthday person directly in addition to the channel post.

Template for the birthday DM. Supports {user}, {server}, {age}. Defaults to a generic greeting.

When enabled, new-member welcomes include a generated image card (avatar, username, optional background).

Optional — PNG/JPEG URL used as the backdrop behind the avatar + username. Leave blank for a solid-color gradient.

Hex colour used for the username text and ring. Default: #a579ff.

Built-in background: gradient / nebula / sunset / forest / ocean / midnight / grid / confetti. Only used when welcome_image_background is blank.

Font style: sans / rounded / serif / mono / display / handwriting. Default 'sans'.

Channel where boost-celebration messages get posted. Leave blank to disable.

Template for the boost post. Supports {user}, {server}, {tier}. Defaults to '🚀 {user} just boosted {server}! Thanks for the support.'

Role granted to every member who's currently boosting. Auto-revoked when they stop boosting.

When members DM the bot, a private staff thread is created here. Replies in the thread DM the user; messages prefixed with ! stay internal. Use a private channel hidden from regular members.

Category under which private ticket channels are created. Leave blank to create tickets at the top level.

Closed tickets get moved into this category and locked to read-only. Leave blank to leave them in place.

Time-based pruner: delete the Discord channel for any ticket closed longer than this. DB row + transcript stay (channel_id is just nulled). Leave blank to never time-prune. Range 1-90 days on the standard tier — higher retention is reserved for enterprise.

Count-based pruner: delete the Discord channel for closed tickets beyond the newest N (oldest first when over count). Leave blank to never count-prune. Range 1-250 on the standard tier — Discord caps a guild at 500 total channels (text + voice + forum + categories combined), so 250 leaves headroom for the rest of the server. Higher caps are reserved for enterprise.

Master toggle for the support / ticket system. When off, the /ticket command and the panel Create button do nothing; existing tickets stay open but no new ones can be created.

Sends the ticket creator a polite "thanks, your ticket has been closed" DM when staff closes the ticket. Hidden when Tickets is off.

Body of the DM sent on close. {server} is replaced with the server name. Leave blank to use the built-in default.

Adds five star buttons to the close-DM. Members can tap a number (1=poor, 5=excellent) and optionally leave a comment. Anonymous in DMs to staff; raw analytics live in the Tickets dashboard.

Wording shown above the star buttons. Leave blank for the default. Members can skip the rating entirely by ignoring the message.

Tickets older than this without being closed show as STALE on the Tickets dashboard. Set to 0 to disable the highlight. Default 24h.

Cap how many tickets one user can have open at the same time. They get a polite refusal once they hit this number. Default 3. Range 1-25.

Where the Create Ticket embed gets posted. Pick the channel members should run /ticket open from (typically #support). Saving the Ticket System form below auto-posts/refreshes the panel into this channel.

When on, the close confirmation gets a Reopen button so a mod can flip an archived ticket back to active without losing transcript history. Off by default — most teams prefer that closed means closed.

When on, every new ticket spawns a private thread visible only to staff (mods/admins). Inside the thread the bot posts a control panel with Claim + Close buttons. Customers cannot see the thread or its embed. Off by default — staff use the existing in-channel buttons instead.

Replaces the main-embed staff buttons with an 'Open staff menu' button. Click → ephemeral panel only the staff member sees. Customers see zero clutter. Trade-off: each mod's panel is independent (no shared in-channel audit), but every action is still written to the dashboard audit log so nothing is lost. Off by default.

When ephemeral menu is on, choose where it activates. 'forums' = only on forum-channel tickets (where private threads aren't supported). 'all' = on every ticket regardless of channel type. Default 'forums' so the change is opt-in for the impossible-to-thread case only.

What to call the points in this server (e.g. "coins", "gems", "stars"). Default: "points".

Single emoji displayed next to point balances. Default: ⭐

How long the points transaction ledger is kept. Running balances are never affected. 0 = keep forever. Default: 180.

Toggle the cross-platform points system for this server. When enabled, members earn points from Discord chat (and later, Twitch chat once the bridge is active).

How many points a member earns per qualifying chat message (short messages and cooldowns still apply). Default: 1.

Minimum seconds between point-earning messages per user — prevents farming. Default: 60.

Toggle the per-server XP system. When enabled, members earn XP by chatting and gain levels (configurable rewards on the dashboard).

Lower bound of the random XP roll for each qualifying chat message. Default: 15.

Upper bound of the random XP roll. Random pick between min/max keeps farming harder. Default: 25.

Minimum seconds between XP-earning messages per user. Default: 60.

Channel where level-up messages get posted. Leave blank to suppress in-channel announcements (DM-only if xp_announce_dm is on).

Send a DM to the leveled-up member in addition to (or instead of) the channel announcement.

Earn XP for time spent in voice channels (one tick per minute, only if unmuted and not alone).

Minimum XP awarded each minute in voice. Default 5.

Maximum XP awarded each minute in voice. Default 10.

Seconds between voice XP earnings per member. Default 60.

Master switch for daily-login streaks + chat milestones + referral bonuses.

Reward the first chat message each UTC day. Streaks multiply the base reward.

Default 50 points.

Extra points per consecutive day (capped). Default 10.

Maximum streak days counted for the bonus. Default 10.

Reward every N messages sent in this server.

Default 100.

Default 25 points.

Credit the inviter when a newly-joined member survives 7 days.

Default 200 points.

Channels where chat messages do NOT earn XP (e.g. spam channels, bot test channels). Pick multiple.

Members with any of these roles do NOT earn XP (typically used to exclude bots / mods / muted users).

When enabled, inactive members slowly lose XP. Controlled by xp_decay_after_days + xp_decay_per_day_percent. Re-levels down if they fall below a level threshold.

Members keep their XP for this many days after their last message before decay begins. Default 14.

Percentage of current XP shaved off per inactive day once the grace period passes (1-50). Default 1.

XP won't decay below this floor — keeps long-time members with a baseline. Default 0.

Points awarded to the first member who answers a /trivia question correctly. Default 5. Requires points_enabled=1.

Points awarded to the original author when a staff member pins their message via /pin. 0 disables the reward. Default 0.

When enabled, members can set a personal role colour via /color set. Each member gets a dedicated auto-created role positioned just above the cosmetic anchor role.

Cosmetic member-roles are created just ABOVE this role. Place it near the bottom of the role list so cosmetic colours don't override meaningful roles.

Optional. Only members with this role can use /color set. Leave blank to allow everyone.

Upper bound on wagers for /gamble, /slots, and bet options on /coin/rps. Default 10000.

When enabled, the bot keeps a local copy of every non-bot message for a retention window so mods can review a user's recent chat (including deleted messages) from a ticket. Off by default for privacy.

How long the local message log keeps rows before pruning them. 0 = keep forever. Default: 30.

When enabled, the bot monitors new-member joins and auto-locks the server if it detects a raid burst (joins-per-minute above threshold).

Kick new joiners whose Discord account is younger than this many days. 0 = disabled.

Joins within 60s that triggers auto-lockdown. Default: 8.

What to do with new joiners during a lockdown: 'kick', 'quarantine' (assign unverified_role), or 'log' (audit log only).

When enabled, the bot turns on slow mode in a channel after a message-velocity spike and clears it when things calm down.

Messages in 10s that trigger auto slow mode. Default: 15.

setRateLimitPerUser value applied when triggered. Default: 5.

Auto-clear slow mode this many minutes after the last trigger. Default: 10.

Channels the auto-toggle should ignore (spam, off-topic, etc.).

Auto-clear warnings older than this many days. 0 disables decay. Default 0.

Scan image attachments through SightEngine and act on flagged ones. Requires SIGHTENGINE_USER + SIGHTENGINE_SECRET in the bot's .env. No-op if those aren't set.

What to do with flagged images: 'delete' (remove + DM the user), 'warn' (reply with a public warning), or 'log' (just post to mod-log). Default: 'log'.

Confidence score above which an image is flagged. 0.0 = paranoid (lots of false positives), 1.0 = only obvious cases. Default: 0.65.

Comma-separated list of categories to flag. Available: nudity, gore, offensive, violence, weapon. Default: nudity,gore,offensive,violence.

Default destination for Twitch live-stream announcements. Each watched channel can override this.

Master switch for the Twitch anti-bot system (follow-bot guard, first-message scam filter, blocklist, suspicious-user automation). Everything below is also individually gated.

ON by default — detect, log, and contribute to the global learned blocklist, but take NO enforcement actions (no bans/timeouts/Shield). Safe to run alongside another bot (e.g. Sery) that does the actual moderating. Turn OFF (or '!antibot observe off') to let GoofBot enforce. Manual !shield always works.

On each new follow, check account age / profile picture / known-bot blocklist and act on suspicious accounts. Also powers the follow-spike (hate-raid) detector.

Followers whose Twitch account is younger than this are flagged by the follow-bot guard. Default 3.

Treat a default (no) profile picture as a suspicion signal for the follow-bot guard.

What to do with a flagged follower: ban | timeout | log. Default log.

Number of follows within the spike window that triggers hate-raid defense (Shield Mode). Default 15.

Time window for the follow-spike count. Default 60.

When a follow spike is detected, automatically enable Twitch Shield Mode. Auto-clears after 5 min.

Also engage follower-only chat (30m) when a follow spike triggers Shield Mode.

Scan each chatter's FIRST message for scam patterns (cheap viewers, buy followers, sketchy links). Matches are deleted + actioned.

What to do on a scam first-message (the message is always deleted): delete | timeout | ban. Default delete.

Flag generic-word + random-digit usernames in the follow-bot guard. Only counts when paired with another signal (young account / no avatar), never a solo ban.

Delete + action ANY message (not just first) containing scam shorteners or 'buy followers/viewers' link spam. Mods / VIPs exempt.

Timeout users who flood (>6 messages in 8s) or repeat the same message 4+ times. Mods / VIPs exempt.

Auto-act on usernames in the known-bot blocklist when they follow or chat. Which list(s) are consulted is set by the blocklist scope below.

Which blocklist(s) this channel matches against: global (the shared list — public sync + GoofBot's self-learning), personal (only your own !antibot blockadd entries), or both. Default both.

Act on Twitch's own restricted/monitored (low-trust) flag via EventSub. Requires the broadcaster to grant moderator:read:suspicious_users.

Action for a Twitch-flagged suspicious user: ban (restricted only) | timeout | delete | log. Default log.

Comma/space-separated Twitch logins that are always exempt from every anti-bot check.

Discord channel for anti-bot action logs. Falls back to the Twitch events channel, then the default log channel.

Mentioned by default when a watched Twitch channel goes live. Each watched channel can override this.

Automatically granted to linked Discord members whose Twitch account (from the watchlist) is currently streaming, and removed when they stop. Leave empty to disable.

How long Twitch chat lines from watched channels are kept. 0 = keep forever. Default: 30.

When enabled, the bot archives non-bot Twitch chat for this guild's watched streamers so mods can review recent chat (including via the ticket "Show User History" button's Twitch branch). Off by default for privacy.

When enabled, linked Discord members earn points from Twitch chat messages (subject to a cooldown) — same balance as Discord-side earnings.

Points awarded per qualifying Twitch chat message from a linked user. Default: 1.

Minimum seconds between point-earning Twitch chat messages per user. Default: 60.

Enable !slots, !roulette, !flip, !dice in your Twitch chat. Players bet their loyalty points (linked Twitch ↔ Discord accounts only). Off by default — turn on after you've configured points + cooldown + max-bet to taste.

Per-user-per-game cooldown between plays. A chatter who just played !slots can still !dice without waiting; the timer is only enforced for the same game. Default: 30.

Largest single bet a chatter can place. Keeps a high-roller from emptying their balance in one !slots. Default: 100.

Enable the three-reel slot machine. Defaults to ON when chat games are enabled.

Enable the six-chamber roulette. 1/6 fired (lose), 5/6 click (small win). Defaults to ON.

Enable the coin flip. ~48/52 with a small house edge. Defaults to ON.

Enable the dice roll. 1-3 lose, 4 push, 5 small win, 6 big win. Defaults to ON.

Enable !claim <trigger> in your Twitch chat. Streamer registers triggers (e.g. "bum", "hug") on the dashboard; chatters running !claim bum get +1 added to their per-user inventory and the bot replies with their new total. Off by default — turn on after registering at least one trigger.

Where real-time Twitch alerts post (follows, subs, raids). Falls back to twitch_announce_channel when not set.

Post a message whenever someone follows a watched Twitch channel.

Post a message for new subs + resubs on a watched Twitch channel.

Post a message when someone gifts subs in a watched Twitch channel.

Post a message when a watched Twitch channel is raided.

Post when someone cheers bits in a watched Twitch channel. Needs the broadcaster's bits:read OAuth scope.

Post when a channel-point reward is redeemed. Needs channel:read:redemptions on the broadcaster's OAuth link.

Post when the broadcaster starts or resolves a Twitch prediction. Needs channel:read:predictions on the broadcaster's OAuth link.

Post when the broadcaster starts or resolves a Twitch poll. Needs channel:read:polls on the broadcaster's OAuth link.

When the broadcaster is raided, GoofBot posts a !so for the raider in Twitch chat with their last-played game.

When 2+ watched streamers go live in the same poll cycle, post one combined embed listing all of them instead of N separate posts. Defaults ON; set to off to always post separately.

Discord channel where !mark timestamps post when a stream ends. Falls back to twitch_announce_channel if unset.

When set, every clip made via !clip auto-posts to this Discord channel. Clips also show on the dashboard Clips tab regardless.

Where the 15-min countdowns + Monday weekly roundup post when a watched broadcaster's Twitch schedule is published. Falls back to twitch_announce_channel.

When chat velocity spikes past the threshold, GoofBot auto-fires !clip. Cheers count 3x, so bit trains register fast.

Minimum messages in a 10-second window to trigger an auto-clip. Default 20.

Minimum seconds between auto-clips per channel. Default 120.

Discord channel where tip alerts post. Falls back to twitch_announce_channel.

Paste from Ko-fi → API settings → Webhooks. Set the webhook URL to https://goofbot.gyneric.net/webhooks/kofi

Reward tippers with N points per $1 (or whatever currency unit). Set to 0 to disable. Default 0.

Toggle the /afk command. When a member is AFK, the bot replies with their reason whenever someone pings them, and clears their AFK on next message.

How long dashboard audit-log entries (who changed which setting / who applied which action) are kept. 0 = keep forever. Default: 90.

Master switch for the Auto-join roles above. When ON, configured roles are granted on join. Turn OFF to pause without clearing your role list.

Role(s) automatically granted to every member the moment they join — independent of the verify system. Pick one or more. Manage from Discord with /autorole.

When enabled (default), the bot scans this server on every boot and re-orders any color reaction-role roles that have drifted below their correct slot (below admin / mod / staff and any XP level-reward roles). Turn off if you'd rather manage role positions yourself — the manual "Fix role hierarchy" button on the Reaction roles card still works either way.

Where /mod congratulate posts the celebratory embed. Pick a public channel everyone can read so the recognition is visible. Leave empty to disable announcements (the award + points still happen — just no embed).

How many points /mod congratulate awards when the issuer doesn't specify a count. Default: 5.

How many stars /mod congratulate hands out when the issuer doesn't specify a count. Stars accumulate per-user on the leaderboard. Default: 1.

Cap on points one /mod congratulate call can hand out — prevents accidentally awarding 1,000,000 points. Default: 100.

Cap on stars one /mod congratulate call can hand out. Stars accumulate per-user on the leaderboard, so this caps how fast one mod can move someone up the board. Default: 5.

How long /mod congratulate awards are kept. Stars and totals derive from this table — pruning lowers lifetime totals. 0 = keep forever (default).

Locked. The bot's translation framework (DeepL / LibreTranslate / MyMemory + DB cache) is wired in but disabled globally while we validate quality. Flipping this setting currently has no runtime effect.

How long the per-member invite-credit history is kept. Affects invite leaderboards. 0 = keep forever. Default: 180.

Catch-all channel for any log category that has no dedicated channel set. If empty, falls back to the legacy Audit log channel(s) for back-compat.

Dedicated channel for join + leave embeds, separate from other member events. Falls back to log_channel_member then to Default.

Where member events post (joins, leaves, role updates, bans, timeouts, etc.). Falls back to Default log channel.

Where message events post (deletes, edits, purges). Falls back to Default log channel.

Where server-structure events post (channel/role/emoji create/update/delete, server updates). Falls back to Default log channel.

Where voice events post (join/move/leave). Falls back to Default log channel.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the joinleave log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the joinleave log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the member log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the message log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the message log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the message log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: ON.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the server log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the voice log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the voice log channel(s) when this event fires. Default: OFF.

When enabled, posts an embed to the voice log channel(s) when this event fires. Default: OFF.

Events sourced from these channels are suppressed (no log posted). Useful for spam channels, bot-test channels, etc. that you don't want polluting the log.

Where the bot posts auto-announcements about tracked LoL accounts (rank-ups, hot streaks, big wins). Future Phase 2 — set this now to be ready when polling lands.

OFF (default): the match-result embed emphasizes the player's Riot ID in bold and posts allowedMentions:{parse:[]} so nobody is notified. ON: the linked Discord user gets a real @-mention every match — best for small hype channels where the ping is wanted.

When ON, only tier promotions get announced (e.g. Gold IV → Gold III). Demotions stay quiet — useful for community-respect servers. Implies Announce rank changes is on.

When ON, the bot posts a message in the announcements channel whenever a tracked account's tier or division changes. Off by default — Phase 2 polling lights this up.

How long the daily message-count buckets used by the analytics dashboard are kept. Analytics windows are 30-90d so this only affects long-tail history. 0 = keep forever. Default: 365.

How long cleared / expired mod-actions (warnings, timeouts, etc.) stay in history before pruning. Active warnings and bans are always kept. 0 = keep forever. Default: 365.

Auto-join private threads as they are created so message logging + automod + audit logs cover them. Off by default. Members of private threads are typically not aware that a bot is in the room — enable only if your community is comfortable with that disclosure (consider posting a server-rules note). Requires Manage Threads. Effective only when Message logging is also on.

Role assigned by /mod warn ... mutewithwarning:true that revokes Send Messages / Add Reactions / Speak / Send Voice Messages everywhere. The bot can auto-create + auto-lock this role for you from the dashboard. Read-only access otherwise — they can still see channels they had access to, just can't post or talk.

Where the bot posts rank-change embeds for tracked Overwatch accounts. Overwatch 2 does not expose per-match history (Blizzard killed that API), so only role-rank promotions / demotions get announced — closest analog to a win/loss embed.

When ON, the bot posts an embed for each match it can INFER from career-stat deltas (career profile aggregates only — no map / KDA / team). Hero attribution comes from time-played delta. Best with a 15min poll cycle. Off by default. Blizzard does not expose a per-match API.

OFF (default): the embed emphasizes the player's BattleTag in bold with no mention. ON: the linked Discord user gets a real @-mention every rank change.

When ON, only tier promotions get announced. Demotions stay quiet — useful for community-respect servers. Implies Announce rank changes is on.

When ON, the bot posts an embed in the announcements channel whenever a tracked account's role tier (Bronze→Silver, etc.) or division (Silver 3→Silver 2) changes. Off by default.

Where starred messages get reposted.

Emoji to count as a star (default ⭐). Can be a custom server emoji like :star2:.

When enabled, messages that get a configurable threshold of star reactions get reposted to the starboard channel.

Number of ⭐ reactions required to repost. Default: 3.

Auto-managed: the message ID of the system-status embed in system_status_channel. Cleared to force a new post.

Where the bot posts auto-announcements about tracked Valorant accounts (rank-ups, ace callouts, milestone wins). Future Phase 2 — set this now to be ready when polling lands.

When ON, only tier promotions get announced (e.g. Silver 3 → Gold 1). Demotions stay quiet. Implies Announce rank changes is on.

When ON, the bot posts a message in the announcements channel whenever a tracked account's competitive tier changes. Off by default — Phase 2 polling lights this up.

When ON, moderators can edit the reason on any active warning from the dashboard. Audit-logged. Owner / admin can always edit regardless of this setting.