Wiki & FAQ

What each GoofyBot module does, and how to get the most out of it.

Moderation

Three levels of protection, from the fastest/free to the finest-grained, so you never pay for more than you need.

  • Level 1 (banned-word filter): instant and free, also catches leetspeak variants ("p4y3r", artificial spacing...).
  • Level 2 (OpenAI Moderation API): free classifier that detects hate/harassment/violence/sexual content even without a configured keyword — active as soon as the module is enabled.
  • Level 3 (contextual LLM analysis): optional, reserved for messages flagged "suspicious" by the previous levels — this is the only layer that consumes your subscription tier's AI quota.
  • Each sanction (warn/mute/kick/ban/timeout) can automatically trigger the next one via cumulative thresholds (e.g. 3 warns = mute, 5 = kick, 8 = ban).

Tips

  • Start by enabling just the log channel and observe for a few days before turning on aggressive sanctions.
  • Only enable level 3 (contextual AI) if you really need the nuance — levels 1 and 2 are enough for most servers and consume no quota.
  • Add your test/staff channels to the ignored channels list to avoid false positives while you tune the config.
  • Build progressive warning thresholds rather than a single heavy sanction on the first offense.
/warn/mute/unmute/kick/ban/unban/clear/warnings
Leveling / XP

Activity-based leveling system (messages + voice), with automatic role rewards.

  • XP earned per message (with an anti-spam cooldown) and per minute spent in voice.
  • Configurable level-up announcement (dedicated channel or origin channel, customizable message).
  • Role rewards per level tier, with an option to remove previous roles so only one "badge" role shows at a time.

Tips

  • Keep a cooldown of at least 30-60s between message XP gains to prevent spam farming.
  • Use "remove previous roles" if you want a clean tier system instead of stacking every earned role.
  • Ignore announcement/rules channels in the XP config — that's not real conversation.
/rank/leaderboard/set-level
Tickets (hybrid AI support)

A ticket channel where AI tries to answer first from your knowledge base, before escalating to staff.

  • The member opens a ticket, the AI searches the server's Knowledge Base (RAG) and answers if it finds a reliable match.
  • The "Contact Staff" button is always visible and available — AI never blocks access to a human.
  • After a number of unresolved AI exchanges, the ticket is automatically escalated to staff.
  • Every closed ticket generates a transcript viewable from the Dashboard.

Tips

  • Fill in your public Wiki first — it's automatically synced into the Knowledge Base used by ticket AI, so one piece of content serves two purposes.
  • Write your Knowledge Base entries as real member questions/answers, not technical documentation.
  • If the AI keeps struggling on a specific type of question, add exactly that question to the Knowledge Base.
Custom Commands

Automatic replies to a keyword (configurable prefix), as plain text or an embed.

  • Each command is triggered by a word after the server's prefix (e.g. !website).
  • Two reply formats: plain text, or an embed with color/title/image.
  • Command count limited by subscription tier: 5 on FREE, 30 on PRO, unlimited on ULTRA.

Tips

  • On the FREE tier, prioritize the 5 most requested commands (rules, invite, useful links) rather than creating many low-value ones.
  • Prefer embeds for "informational" commands (rules, links) — much more readable than a wall of plain text.
Reaction Roles

Role panels that self-assign when a member reacts with an emoji.

  • One panel = one message with an emoji -> role list. The bot adds/removes the role automatically based on the reaction.

Tips

  • Split your roles by theme across multiple panels (pronouns, notifications, games...) rather than one giant hard-to-read panel.
  • Make sure the bot's role sits ABOVE the roles it needs to assign in Discord's hierarchy, otherwise assignment fails silently.
Giveaways

Contests with automatic drawing among participants, at a scheduled date.

  • A message with a "Join 🎉" button is posted in the chosen channel — each click adds/removes the member from the participant list.
  • At the end time (set at creation, or forced via /giveaway end), the bot draws the configured number of winners and announces them in the channel.
  • Creation and ending are possible both from the Dashboard and via the /giveaway command — both go through the same system.

Tips

  • Leave a reasonable duration (a few hours to a few days) to give active members time to see the giveaway.
  • Keep the winner count consistent with the expected number of participants, or the draw will run short of candidates.
/giveaway create/giveaway end
Polls

Multiple-choice polls (2 to 10 options), with button voting and automatic closing.

  • Each option is a separate button — a click records the member's vote for that option.
  • "Allow vote changes" option: the member can reconsider their choice while the poll is open, otherwise their first vote is final.
  • At closing (automatic at the scheduled time, or forced via /poll end), the bot shows the final results in the channel.

Tips

  • Write short, unambiguous options — they display directly on the buttons, space is limited.
  • Enable vote changes for opinion polls, disable it for votes that must stay final (e.g. choosing a date).
/poll create/poll end
Welcome / Goodbye

Message + visual card automatically generated when a member joins and leaves.

  • Welcome card generated with the member's avatar and username (or a custom banner instead).
  • Optional welcome DM, in addition to the channel message.
  • Automatic role assignment on join (autoRoleIds).

Tips

  • Use autoRoleIds to grant a base "Member" role right on join — avoids members with no role at all.
  • Always preview with /welcome-test before considering the config "ready" — much faster than testing with a real account.
/welcome-test
Wiki / FAQ (per server)

Public article base organized by category, viewable without a Discord account.

  • Each server has its own public Wiki page (accessible via a direct link), with articles grouped by category and displayed as an accordion.
  • Content is written in Markdown from the Dashboard.
  • Automatically synced into the Knowledge Base used by Ticket AI — one piece of content, two uses.

Tips

  • Write your Wiki articles here first rather than duplicating the same content directly in the Ticket Knowledge Base.
  • A good category structure (Rules, Roles, Events...) makes the page far more useful than one long flat list.
Security (Anti-Raid / Anti-Nuke)

Detection of suspicious mass joins and destructive activity (channel/role deletions, mass bans).

  • Anti-raid: beyond a number of joins within seconds, either alert only, temporary lockdown (maximum Discord verification), or kick members who joined during the burst.
  • Anti-nuke: monitors channel/role deletions, bans and kicks per author — beyond a per-minute threshold, strips all roles from the responsible account or bans it.
  • Quarantine: restricted role automatically applied to Discord accounts that are too recent.
  • Every incident is logged and visible in the history on the Dashboard's Security page.

Tips

  • Whitelist your trusted moderators in anti-nuke if they do mass moderation (several bans in a row) — otherwise they risk being sanctioned by mistake.
  • Keep a reasonable lockdown duration (15-30 min): enough to stop a raid, without blocking legitimate new members for too long right after.
  • Quarantine requires a role already configured with the right restricted permissions on every channel — the bot only applies it, it doesn't create it with the right permissions.
Social Alerts

Automatic notifications when a YouTube channel posts a video or a Twitch stream goes live.

  • Periodic checking (polling) of configured channels/accounts, with a message posted in the chosen channel.

Tips

  • Dedicate a clean "announcements" channel to these alerts rather than mixing them into general chat.
Promotion / Directory

Public listing of your server on /explore, with a "bump" system to rise in the results.

  • Ranking prioritizes paid tiers (ULTRA then PRO), then free servers by last bump date.
  • Minimum delay between two bumps by tier: 2h on FREE, 1h on PRO, 30 min on ULTRA.

Tips

  • Write a description that actually makes people want to join, not just a feature list.
  • Add relevant tags (Gaming, Anime, Dev...) — that's what makes you discoverable through /explore's filters.
Bot Branding (ULTRA)

Customize GoofyBot's nickname and avatar, on your server only — reserved for the ULTRA tier.

  • Change the nickname and/or avatar the bot displays on your server, without affecting its appearance on other servers.
  • The change applies in seconds from the Dashboard, directly via the Discord API.
  • If the bot leaves and rejoins your server, your customization is automatically reapplied.

Tips

  • Use an HTTPS-hosted image under 8 MB for the avatar.
  • Leave a field empty to revert to the bot's default appearance at any time.
Subscription

FREE / PRO / ULTRA tiers, managed from the Dashboard's Subscription page.

  • Each tier has its own limits: AI moderation credits, number of custom commands, bump delay, and unlimited Wiki access.
  • The Subscription page shows real-time usage gauges for every quota.
  • Tier changes go through Stripe (secure payment) and a management portal to cancel/change anytime.

Tips

  • Watch your AI credit gauge: if you regularly run out before the period ends, that's the signal a higher tier is worth it.
  • Compare tiers on the Pricing page before choosing — the yearly tier offers a 20% discount.
AI Setup Assistant

A dedicated channel where you describe the server you want, and the AI creates the categories/channels for you directly.

  • The #ai-assistant channel is created automatically as soon as the bot joins your server (or via /setup-assistant on an existing server).
  • The AI can list existing channels, create categories, text channels and voice channels, chaining several creations for a single request.
  • Restricted to members with the Manage Server permission.

Tips

  • Describe the TYPE of server you want ("a gaming server with coaching") rather than an exhaustive list — the AI proposes and structures it itself.
  • It can see what already exists before creating, so feel free to ask for additions over time rather than planning everything at once.
MusicComing soon

Voice audio playback (playlists, queue).

  • Module under development — not available yet.

Frequently Asked Questions

How do I invite GoofyBot to my server?
Click "Add GoofyBot" on the home page (or from the Dashboard), pick your server and accept the requested permissions. Full configuration is then done module by module in the Dashboard.
What's the difference between the FREE, PRO, and ULTRA tiers?
Mainly AI moderation credits, the number of custom commands, the directory bump delay, and unlimited Wiki access. Full details are on the Pricing page.
The bot doesn't respond in a channel, why?
First check that the relevant module is enabled in the Dashboard, then that GoofyBot's role has permission to view and write in that specific channel.
How do I configure a module?
Everything happens from the Dashboard (Account button top right): pick your server, then the module you want in the side menu.
Can I cancel my subscription anytime?
Yes, from the Dashboard's Subscription page via the "Manage my subscription" button, which opens the Stripe management portal.