Getting started
Mod Pilot is set up from this website, so there's almost nothing to memorise.
- Invite Mod Pilot to your server.
- Open the dashboard and log in with Discord. Only servers where you're the owner or have Administrator appear. You can also type
/dashboardin your server for a private one-time login link. - Start on Overview to see what's set up, then switch on modules in Modules. Changes apply straight away.
Permissions
Mod Pilot only needs the permissions its features use:
| Permission | Used for |
|---|---|
| Ban, Kick, Moderate Members | /ban, /kick, /timeout, AutoMod punishments |
| Manage Messages | AutoMod deleting spam, /purge messages |
| Manage Roles | Auto-roles, verification, pick-a-role menus |
| Manage Channels | Tickets, Server Builder |
| View Audit Log | Anti-Nuke spotting who deleted what |
| Manage Server | Onboarding and Community setup in the builder |
The Overview tab warns you if a moderation permission is missing.
Dashboard
The dashboard has a tab for each part of the bot:
- Overview: real moderation numbers for the last 30 days, recent actions, and what's set up.
- History: every case, searchable by member, moderator, reason or case number.
- Modules: switch features on and press Configure for their settings.
- Server Builder, General, Tickets, Trivia, plus the Premium tabs.
Every change is checked by the bot: you need Administrator in that server, even if you're logged in.
Moderation
Use /warn, /timeout, /untimeout, /kick, /ban, /unban and /purge messages. Each action asks you to confirm, DMs the member the reason, and is saved as a numbered case.
See someone's record with /history, or search all cases in Dashboard → History. Full syntax for every command is on the Commands page.
AutoMod
AutoMod removes spam, invite links, banned words and mass mentions before your team has to step in.
- Dashboard → Modules → AutoMod → Configure.
- Pick the filters, allowed links, blocked words and the punishment.
- Save. It starts working immediately.
Anti-raid
Join Guard screens brand-new accounts and reacts when lots of accounts join at once. The Honeypot is a trap channel: anything that posts there is a spam bot and gets removed.
Both are in Dashboard → Modules.
Logs and reports
Pick a log channel and a report channel in Dashboard → General. Message edits and deletes, joins, leaves and every mod action are logged. Members can report others, and staff handle reports from the report channel.
Verification
New members press Verify and open a one-time web page. Mod Pilot checks for alt accounts, VPNs and ban evasion, then gives the verified role or blocks, kicks or bans, depending on your settings.
Set it up with /verification. Raw IP addresses are never stored, only one-way hashes. See Privacy.
Tickets
The fastest way: open Dashboard → Tickets and use Quick setup, or type /ticketsetup in your server. Pick the channel for the ticket button and your staff role, and Mod Pilot posts it for you.
Need more? The full editor has several ticket types (categories), form questions, support roles, custom messages, a live preview and, with Premium, colour themes.
- Staff run each ticket from its Select an action... menu: close, claim, add or remove people, ping, DM the member, rename.
- Each member can have one open ticket at a time.
- When a ticket closes, the member can rate it from 1 to 5 stars. Ratings show up in your ticket log and in
/staffstats. - When a ticket is deleted, the member gets a private transcript link that opens on this website, on any device.
Music
Join a voice channel and type /music play with a song name, a YouTube link or a YouTube playlist link. Pick a result and Mod Pilot joins your channel and plays it.
- The Now playing card has Pause, Skip, Stop, Loop and Queue buttons.
- Loop switches between Off, this Song and the whole Queue.
- When the queue runs out, Mod Pilot keeps playing similar songs, so the music doesn't stop. It leaves when everyone else leaves the voice channel.
- Save your favourite songs with
/music playlist createand/music playlist add, then play them any time with/music playlist play.
Only people in the same voice channel as the bot can control the music.
Server Builder
Describe your server with /build server or the Server Builder tab. Mod Pilot shows a plan (channels, roles, rules, Community and Onboarding) and only builds it when you press Build. One click undoes it.
Every server's first build is free. After that, one build costs one credit; open a ticket in the support server for more.
Suggestions and Mail
Got an idea? Press Suggest at the top. Your suggestion is posted in the Mod Pilot support server with your name and picture. You can send one every 2 days.
When the team accepts, declines or answers it, you'll see it in Mail (the envelope at the top). A red dot means something new.
Commands
The full, always up-to-date list with syntax, required permissions and examples is on the Commands page.
Troubleshooting
- "Missing permissions": give the bot the permission named in the error and move its role higher.
- Commands don't show up: wait a minute after inviting, then restart Discord.
- A server is missing in the dashboard: you need Administrator there. Press refresh after you get it.
- The website looks broken after an update: press Ctrl + F5.
- Still stuck? Check the status page or ask in the support server.
FAQ
Is it free? Yes. Moderation, AutoMod, anti-raid, logs, verification, tickets and the dashboard are free.
Does it read my messages? It checks new messages for AutoMod, but doesn't store message content.
Can I remove it? Any time. Kick the bot and it stops collecting anything in your server.