Introduction
Fade is a free, all-in-one Discord bot built for moderation, security, and community engagement. No paywalls, no premium tiers — every feature is available to every server, forever.
Whether you're running a small friend group or a large public community, Fade gives you the tools to keep your server safe, active, and well-organized. From airtight antinuke protection to beautiful welcome cards and a full XP leveling system — it's all here, and it's all free.
f! — you can also use slash commands with /. Both work for every command.What Fade offers
Antinuke, anti-raid, automod, and fake permissions to lock down your server against rogue admins and bot raids.
Welcome cards, tickets, logging, reaction roles, starboard, and temporary voice channels.
XP leveling with role rewards, giveaways, bump reminders, and live member counters.
Auto responder, reaction triggers, snipe, and quality-of-life tools for everyday server management.
How to use this documentation
Use the sidebar on the left to navigate between modules. Each page explains what the feature does, why you'd want it, and every command with its syntax. If you're new, start with Getting Started to get Fade set up correctly before configuring individual modules.
Getting Started
Get Fade fully set up in your server in a few minutes. Follow these steps in order to avoid permission issues.
1. Invite Fade
Click Add to Discord at the top of this page and authorize Fade. When prompted for permissions, grant Administrator — this is required for antinuke, moderation, and role management to work correctly. If you prefer not to grant Administrator, you'll need to manually assign every individual permission Fade needs.
2. Position Fade's role correctly
This is the most common cause of issues. Go to Server Settings → Roles and drag Fade's role to the very top of the list, above every other role. Discord only allows a bot to manage roles that are below its own role in the hierarchy. If Fade's role is too low, commands like /mute, /ban, and role assignment will silently fail.
3. Configure the modules you need
Every module in Fade is independent — you only set up what you want. Use the sidebar to navigate to any feature. A good starting order for most servers:
- Antinuke — protect against rogue admins first
- Moderation — set up your mod workflow
- Logging — so you have a record of everything
- Welcome — greet new members
- Everything else at your own pace
Prefix
The default prefix is f!. Every command also works as a slash command with /. You can use either interchangeably.
f!helpBrowse all commands via prefix/helpBrowse all commands via slash command/help command:<name>Get detailed info on a specific commandDonator Perks
Everything in Fade is 100% free, forever. However, supporting the bot unlocks a few cosmetic perks to show our appreciation.
Is Fade really free?
Yes! All core features—including Moderation, AutoMod, Logging, and the Economy system—are completely free for every server. We do not paywall essential functionality.
What do donators get?
If you choose to support Fade's development, you get access to a premium tier for communities that want ultra-customizable aesthetics (like fully custom welcome cards) and higher rate limits. You also get a special donator badge on your profile.
Customization
Make Fade feel like it was built specifically for your server with custom embeds, webhooks, and flexible message variables.
Custom Embeds
You can create fully customized embeds using our powerful script syntax. Use the f!ce command to post beautiful embeds or Components v2 cards directly to any channel.
f!ce [#channel] <embed script>Post an embed to the channelf!ce [#channel] {card}$v...Post a rich Components v2 cardf!ce edit <message_url> <script>Edit an existing bot messageWebhooks
For an even more professional look, use webhooks to send messages with custom names and avatars.
f!webhook create <name> [#channel] [username] [avatar_url]Create a new webhookf!webhook send <name> <message>Send a message through the webhookf!webhook listView all your custom webhooksVariables
When writing custom embeds, welcome messages, or auto-responders, you can use these variables to dynamically insert information:
| Variable | Replaced with |
|---|---|
{user} | Mentions the member (e.g. @Snow) |
{username} | The member's username |
{server} | Your server's name |
{channel} | Mentions the current channel |
{count} | Current total member count |
{id} | The user's ID |
{avatar} | The user's avatar URL |
{servericon} | The server's icon URL |
Antinuke
Impose limits on moderators to prevent destructive behavior from rogue admins or compromised accounts.
Why use antinuke?
Even trusted admins can have their accounts compromised. Without antinuke, a single bad actor with admin permissions can delete every channel, ban every member, and destroy your server in seconds. Antinuke watches for these mass actions and automatically strips permissions and reverses damage before it spreads.
How it works
Each module tracks a specific action (bans, kicks, channel deletes, etc.). When a user exceeds the configured threshold within a short time window, Fade immediately strips their dangerous permissions and notifies the server owner. The server owner is always exempt from antinuke.
Enabling & disabling
/antinuke enableEnable antinuke protection for your server/antinuke disableDisable antinuke entirely/antinuke settingsView the current configuration and all module statesConfiguring modules
Each module can be toggled independently with a custom threshold. The threshold is how many actions a user can perform before being punished. Keep it between 1 and 5 for best protection.
/antinuke module <module> <threshold>Enable a module and set its action threshold| Module | What it watches | Recommended threshold |
|---|---|---|
ban | Mass member bans | 3 |
kick | Mass member kicks | 3 |
channel | Channel deletions/creations | 2 |
role | Role deletions | 2 |
webhook | Webhook creation (common in raids) | 2 |
Whitelisting trusted users
Whitelisted users are completely exempt from antinuke checks. Only whitelist users you fully trust — a whitelisted user can perform mass actions without being stopped.
/antinuke whitelist add <user>Exempt a user from all antinuke checks/antinuke whitelist remove <user>Remove a user from the whitelistAntinuke admins
By default only the server owner can change antinuke settings. You can grant other users the ability to configure antinuke without giving them server ownership.
/antinuke admin add <user>Allow a user to configure antinuke/antinuke admin remove <user>Revoke antinuke admin accessAnti-Raid
Automatically detect and neutralize bot raids using join rate monitoring, account age filters, and avatar detection.
Why use anti-raid?
Bot raids involve dozens or hundreds of fake accounts joining your server simultaneously to spam, ping members, or post harmful content. Anti-raid detects the abnormal join rate and takes action automatically — before you even notice the attack.
How it works
Fade monitors how many accounts join within a short time window. When the threshold is exceeded, it triggers the configured action (kick, ban, or lockdown) against the joining accounts. You can also set a minimum account age so newly created throwaway accounts are blocked at the door.
Setup
/antiraid enableEnable anti-raid protection/antiraid disableDisable anti-raid/antiraid threshold <joins> <seconds>Set how many joins in how many seconds triggers a raid alert/antiraid action <kick|ban|lockdown>What happens to accounts caught in a raid/antiraid minage <days>Block accounts younger than this many days from joining/antiraid settingsView the current anti-raid configurationActions explained
| Action | What it does |
|---|---|
kick | Kicks raid accounts. They can rejoin if the server is public. |
ban | Permanently bans raid accounts. Recommended for serious raids. |
lockdown | Prevents anyone new from joining until you manually lift it. |
minage to 7 days blocks the vast majority of throwaway raid accounts, which are almost always brand new.Moderation
A complete moderation suite with case tracking, mod history, DM notifications, and temporary punishments.
Case system
Every moderation action (ban, kick, mute, warn) automatically creates a numbered case. Cases are stored permanently and can be reviewed, updated, or referenced at any time. This gives you a full audit trail of every action taken in your server.
Banning members
The /ban command supports both permanent and temporary bans. For temp bans, provide a duration like 7d, 24h, or 30m — Fade will automatically unban the user when the time expires.
/ban <user> [reason] [duration] [delete_messages]Ban a user. Leave duration empty for permanent./unban <user> [reason]Unban a user by ID or usernameKicking & muting
/kick <user> [reason]Kick a member from the server/mute <user> <duration> [reason]Timeout a member (e.g. 1h, 30m, 7d)/unmute <user> [reason]Remove a timeout earlyWarnings
Warnings are logged to the case system and visible in a user's mod history. Use them to document minor infractions before escalating to mutes or bans.
/warn <user> <reason>Issue a warning to a user/warnings <user>View all warnings for a userCase management
/case <id>View a specific case by its number/modhistory <user>View the full moderation history for a user/reason <case_id> <reason>Update the reason on an existing caseFake Permissions
Let users run moderation commands without giving them real Discord permissions — keeping your role hierarchy clean and secure.
Why use fake permissions?
Discord's native permissions are all-or-nothing. If you give someone Ban Members, they can ban anyone below them — including using Discord's built-in mass ban feature which can ban 100+ members instantly. Fake permissions let you grant the ability to use Fade's /ban command without touching Discord's actual permission system at all.
This is especially important when combined with antinuke — a user with fake ban permission can only ban through Fade (which is rate-limited and logged), not through Discord directly.
Commands
/fakeperms grant <role> <permission>Grant a fake permission to a role/fakeperms revoke <role> <permission>Remove a fake permission from a role/fakeperms list [role]View all fake permissions, optionally filtered by roleAvailable permissions
| Permission | Unlocks |
|---|---|
ban_members | /ban, /unban |
kick_members | /kick |
moderate_members | /mute, /unmute |
manage_messages | /warn, /warnings |
view_audit_log | /case, /modhistory |
Welcome & Goodbye
Greet new members and farewell departing ones with fully customizable messages — choose between a classic embed or a rich card layout.
Styles
Fade supports two message styles. Embed is the classic Discord embed format. Card uses Discord's Components v2 to render a visually rich card with the user's avatar, join position, and custom text. You can preview either style before going live.
Setting up welcome messages
/welcome channel <channel>Set which channel welcome messages are sent to/welcome style <embed|card>Choose the message style/welcome messageOpen the interactive message builder to customize the content/welcome autorole <role>Automatically assign a role when a member joins/welcome testSend a preview of the welcome message to the channel/welcome disableTurn off welcome messagesSetting up goodbye messages
/goodbye channel <channel>Set which channel goodbye messages are sent to/goodbye messageOpen the message builder/goodbye testPreview the goodbye message/goodbye disableTurn off goodbye messagesVariables
Use these placeholders in your message content — Fade replaces them with real values when the message is sent.
| Variable | Replaced with |
|---|---|
{user} | Mentions the member (e.g. @Snow) |
{username} | The member's username without mention |
{server} | Your server's name |
{membercount} | Current total member count |
Logging
Keep a detailed record of everything that happens in your server — deleted messages, voice moves, role changes, bans, and more.
Why set up logging?
Logs give you visibility into what's happening in your server even when you're offline. They're essential for investigating incidents, tracking mod actions, and catching rule-breakers who delete their messages. Each event type can be sent to a different channel so your logs stay organized.
Commands
/log channel <event> <channel>Route a specific event type to a channel/log disable <event>Stop logging a specific event type/log settingsView all configured log channels at a glanceEvent types
| Event | What gets logged |
|---|---|
messages | Deleted messages (with content) and edited messages (before/after) |
members | Joins, leaves, username changes, nickname changes, avatar changes |
voice | Voice channel joins, leaves, moves, mutes, and deafens |
roles | Role created, deleted, renamed, and role assigned/removed from members |
channels | Channel created, deleted, renamed, and permission overwrites changed |
moderation | All Fade mod actions — bans, kicks, mutes, warns with case numbers |
server | Server name, icon, verification level, and setting changes |
Tickets
Create support ticket panels with multiple categories, each opening a private channel for the user and your staff team.
How it works
You create a panel and post it in a channel. Members click a button or select from a dropdown to open a ticket. Each ticket creates a private channel visible only to the member and your staff. When resolved, the ticket can be closed and the channel is deleted.
Creating a panel
/ticket create <name> <channel>Create a new ticket panel and assign it to a channel/ticket option add <panel> <label> <category>Add a ticket type (e.g. "Support", "Report", "Appeal") to a panel/ticket send <panel>Post the panel message in its channel so members can use itManaging panels
/ticket listView all ticket panels in your server/ticket delete <panel>Delete a panel and remove its messageRoles
Manage your server's roles including reaction roles, booster rewards, and vanity URL rewards.
Reaction Roles
Let members self-assign roles by clicking buttons or selecting from a dropdown — no moderator needed.
/reactionrole create <channel> <title>Create a new panel in the specified channel/reactionrole add <panel> <role> <label> [emoji]Add a role button to the panel/reactionrole remove <panel> <role>Remove a role from the panel/reactionrole style <panel> <button|dropdown>Switch between button and dropdown layout/reactionrole delete <panel>Delete the panel and its messageBooster Roles
Reward your Server Boosters by letting them create and manage their own custom roles.
/boosterrole create <name> <color>Create your custom booster role (Boosters only)/boosterrole edit [name] [color]Edit your existing booster role/boosterrole deleteDelete your booster role/boosterrole setup <role> <position_role>Configure which role is required to make custom roles (Admin only)Vanity Roles
Reward members who advertise your server's vanity URL or a specific keyword in their Discord status.
/vanity set <keyword>Set the vanity keyword to monitor in member statuses/vanity role add <role>Add a role to be given when a user has the vanity in their status/vanity role remove <role>Remove a role from the vanity rewards/vanity settingsView current vanity configurationMessages
Configure Sticky Messages to keep important information visible at the bottom of a channel.
Sticky Messages
A sticky message is a message that constantly stays at the bottom of a channel. Every time someone sends a new message, Fade will delete the old sticky message and send a new one so it's always visible.
/sticky set <channel> <message>Create a sticky message in the specified channel/sticky remove <channel>Remove the sticky message from a channel/sticky listView all sticky messages in your server/sticky toggle <channel>Temporarily pause or unpause a sticky messageStarboard
Highlight the best messages in your server by letting members star them — like a community hall of fame.
How it works
When a message receives enough star reactions (⭐ by default), Fade reposts it in your designated starboard channel with a link back to the original. The more stars a message gets, the more prominent it becomes. It's a great way to surface funny, insightful, or memorable moments.
Commands
/starboard channel <channel>Set the channel where starred messages are posted/starboard threshold <count>How many stars a message needs before it's posted/starboard emoji <emoji>Change the reaction emoji (default: ⭐)/starboard disableTurn off the starboard/starboard settingsView the current starboard configurationTemp Voice
Let members create their own private voice channels that automatically delete when everyone leaves.
How it works
You designate a "Join to Create" voice channel. When a member joins it, Fade instantly creates a new voice channel for them in the configured category and moves them into it. They become the owner and can customize it. When the last person leaves, the channel is automatically deleted — keeping your channel list clean.
Server setup
/tempvoice setup <category>Enable temp voice and set the category where channels are created/tempvoice disableDisable temp voice and remove the join-to-create channelMember controls
Once a member has their own temp channel, they can manage it with these commands:
/vc name <name>Rename the channel/vc limit <number>Set a user limit (0 = unlimited)/vc lockLock the channel so no one new can join/vc unlockUnlock the channel/vc permit <user>Allow a specific user to join even when locked/vc reject <user>Block a specific user from joining/vc transfer <user>Hand ownership of the channel to another memberLeveling
Reward active members with XP for chatting, rank cards, a server leaderboard, and automatic role rewards at milestones.
How XP works
Members earn XP by sending messages. There's a cooldown between XP gains to prevent spam farming. As they accumulate XP they level up, and you can configure roles to be automatically assigned at specific levels — great for unlocking channels or recognizing loyal members.
Member commands
/rank [user]View your rank card, or another member's. Shows level, XP, and server rank./leaderboardView the top members by XP in your serverServer configuration
/levelconfig channel <channel>Set where level-up announcements are posted/levelconfig multiplier <value>Multiply XP gain (e.g. 2 = double XP for everyone)Level rewards
Assign a role to be automatically given when a member reaches a specific level. Roles stack by default — members keep all previous reward roles as they level up.
/levelrewards add <level> <role>Give a role when a member reaches this level/levelrewards remove <level>Remove the reward for a level/levelrewards listView all configured level rewardsAdmin XP management
/addxp <user> <amount>Add XP to a specific user/removexp <user> <amount>Remove XP from a user/setxp <user> <amount>Set a user's XP to an exact value/setlevel <user> <level>Set a user's level directlyGiveaways
Run timed giveaways with multiple winners, role requirements, and reroll support.
How it works
Fade posts a giveaway embed with a button members click to enter. When the timer expires, Fade randomly selects the configured number of winners and announces them. If a winner can't be contacted or you want to pick again, use reroll.
Commands
/giveaway start <duration> <prize> <winners> [channel]Start a giveaway. Duration format: 1d, 12h, 30m./giveaway end <message_id>End a giveaway early and pick winners immediately/giveaway reroll <message_id>Pick new winners for a finished giveaway/giveaway listView all currently active giveawaysBump Reminder
Never miss a Disboard bump again — Fade automatically reminds your server exactly 2 hours after the last bump.
How it works
Fade listens for Disboard's bump confirmation message. When it detects one, it starts a 2-hour timer. When the timer expires, it pings the configured role in the configured channel to let your team know it's time to bump again. Consistent bumping keeps your server visible in Disboard's listings.
Commands
/bumpreminder enable <channel>Enable bump reminders and set the channel for notifications/bumpreminder role <role>Set the role to ping when it's time to bump/bumpreminder disableTurn off bump remindersCounters
Display live server stats in voice channel names that update automatically as your server grows.
How it works
Fade creates a voice channel with a name like Members: 1,234 and updates it periodically as the count changes. Since members can't join stat channels, they serve purely as a visual display in your channel list — a great way to show off your server's size.
Commands
/counter create <type> [channel]Create a counter. Fade creates a new voice channel if none is specified./counter delete <channel>Remove a counter and delete its channel/counter listView all active counters in your serverCounter types
| Type | Displays |
|---|---|
members | Total member count including bots |
humans | Member count excluding bots |
bots | Number of bots in the server |
online | Currently online members |
Auto Responder
Automatically reply to messages that contain a specific trigger word or phrase — useful for FAQs, custom commands, and fun responses.
How it works
You define a trigger (a word or phrase) and a response. Whenever a message in your server contains that trigger, Fade replies with the configured response. Triggers are case-insensitive and match anywhere in the message.
Common uses: answering "what's the invite link?", responding to "!rules" with a rules summary, or adding personality to your server with fun auto-replies.
Commands
/responder add <trigger> <response>Create a new trigger-response pair/responder remove <trigger>Delete a responder by its trigger/responder listView all configured responders in your serverReaction Triggers
Automatically react to messages containing specific words or phrases with an emoji.
How it works
Similar to auto responder, but instead of sending a reply message, Fade adds an emoji reaction to the triggering message. Great for adding a 👍 to every "thank you", a 🎉 to announcements, or any other automatic reaction you want.
Commands
/reactiontrigger add <trigger> <emoji>React with an emoji whenever a message contains the trigger/reactiontrigger remove <trigger>Remove a reaction trigger/reactiontrigger listView all configured reaction triggersSnipe
Retrieve the most recently deleted or edited message in a channel — useful for catching rule-breakers who delete their messages.
How it works
Fade keeps the last deleted and last edited message for each channel in memory. When you run /snipe, it shows you that message along with who sent it and when. This data is stored in memory only and is cleared when the bot restarts.
Commands
/snipe [channel]Show the last deleted message in the current (or specified) channel/editsnipe [channel]Show the last edited message, with before and after contentDetailed Feature Usage
Fade is packed with powerful features to help you manage and grow your community. Here is an in-depth look at how to use them.
Economy System
The global economy system spans all servers using Fade. To get started, users can use the /daily command to claim their daily allowance. They can use /work to earn extra cash, and /gamble or /slots to multiply their earnings. Server admins can set up custom shops using /shop create where users can purchase custom roles or perks with their economy balance.
Music Engine
Our Studio Quality Audio Engine requires no setup. Simply join a voice channel and type /play [song name or URL]. Fade supports Spotify, Apple Music, SoundCloud, and direct URLs. You can manage the queue with /queue, toggle 24/7 playback with /loop, and even view synced lyrics using the /lyrics command while a song is playing.
Advanced Antinuke
To enable the Antinuke, run /antinuke toggle true. The system will automatically detect mass bans, channel deletions, and role modifications. If an admin or a rogue bot exceeds the threshold (e.g. 3 bans in 10 seconds), Fade will immediately strip their permissions and attempt to reverse the damage. You can configure thresholds using /antinuke threshold.
Leveling
Keep your community active! Fade automatically awards XP as users chat. Server admins can use /levelconfig to adjust the multiplier or turn it off in certain channels. When users hit specific milestones, you can reward them automatically with role rewards using /levelrewards add [level] [role].