Guide

Set up Potion, the right way.

What each feature actually does and the commands to set it up, written for server owners. Want every command in one list? See Commands.

Getting started

Three things to do first, so everything else works.

Potion can only act on members whose top role is below Potion’s role. Drag the Potion role near the top of your role list, or antinuke and moderation can fail.

,alertchannel #alertsWhere security alerts go: antinuke triggers, raid mode, removed bots.
,prefix !Change the prefix from , if another bot already uses it.
,help antinukeExplains any command right in Discord, with an example.

Antinuke

Stops someone mass banning, kicking or wiping your server, even a trusted admin whose account got stolen.

Potion watches the audit log. When one person does too many of the same thing within 10 seconds, they get punished. Out of the box the limits are:

3 bans3 kicks2 channel deletes4 channel creates2 role deletes4 role creates8 role changes on members2 webhooks3 emoji changes

The default punishment is a ban. Bans and kicks done through Potion’s own commands count for the person who typed them, so ,ban can’t be used to get around it.

,antinuke enableTurns it on. Do this first.
,antinuke punishment stripPick what happens: ban, kick, derank (take all roles) or strip (take only roles with dangerous permissions).
,antinuke threshold ban 5Change how many actions it takes. The names are ban, kick, channel_delete, channel_create, role_delete, role_create, member_role_update, webhook_create, emoji_create and emoji_delete.
,antinuke window 15How many seconds it counts over.
,antinuke ban on --threshold 3 --do kickGive one protection its own limit and punishment. Works for ban, kick, role, channel, emoji and webhook.
,antinuke vanity onPunish anyone who changes your vanity link. Off by default.
,antinuke botadd onKick any bot added by someone who isn’t the owner or whitelisted. On by default.
,antinuke listSee which protections are on and who is whitelisted.

Only the server owner can turn antinuke off with ,antinuke disable. That way a stolen admin account can’t switch it off first.

Whitelist vs antinuke admins

Two different lists. People mix them up, so here’s the difference.

Whitelist

Ignored by antinuke

  • Can add bots without them being kicked
  • Can ban, kick or delete as much as they want without being punished
  • Can’t change antinuke settings unless they’re also an admin
,antinuke whitelist @SamRun it again to take them off.
,antinuke whitelistedShows the list.

Antinuke admins

Can change the settings

  • Can turn it on, change limits, punishments and bot-add protection
  • Still punished if they nuke, and their bot adds are still checked
  • Can’t whitelist people, add admins or turn antinuke off
,antinuke admin @SamRun it again to take them off.
,antinuke adminsShows the list.

Want a co-owner to add bots for you? Whitelist them. Want a head admin to manage antinuke but stay protected against? Make them an antinuke admin. Only the server owner can use either command.

Whitelist only people you’d trust with the whole server. If a whitelisted account gets stolen, antinuke won’t stop it. The server owner is always whitelisted.

Anti-raid and raid mode

For when lots of new accounts join at once.

When 10 people join within 15 seconds, Potion turns on raid mode. It raises the server’s verification level to the highest, checks the people who just joined, and turns itself off after 10 minutes. While it’s on, new joins get checked too.

The check catches accounts younger than 7 days, plus accounts with no profile picture if you turn that on. They get kicked by default.

,antiraid enableTurns it on.
,antiraid joins 8 108 joins in 10 seconds counts as a raid.
,antiraid age 14Catch accounts newer than 14 days. Use 0 to turn the age check off.
,antiraid avatar onAlso catch accounts with no profile picture.
,antiraid action banWhat happens to them: kick, ban or nothing.
,raidmode onStart raid mode yourself. ,raidmode off ends it and puts your verification level back.

Honeypot channels

A trap channel that catches spam bots.

Make a channel that says "don’t type here". Spam bots post everywhere, so anyone who posts in it gets their message deleted and is punished. The owner, staff, and anyone above Potion’s role are never caught.

,honeypot add #trap banPunishment can be ban, softban (ban and unban, which clears their last day of messages) or jail.
,honeypot remove #trapStop the channel being a trap.
,honeypot listSee every trap channel.

Lockdown and strip

Quick buttons for a bad moment.

,lockdown 10mLock every channel. Add a time and it unlocks by itself.
,strip @SamTake away only the roles with dangerous permissions, like admin, ban or manage roles.
,derank @SamTake away all of someone’s roles.

AutoMod

Deletes spam and junk before your mods even see it.

Turned on, it blocks shouting (70% capitals), spam (5 messages in 5 seconds), mass pings (more than 5), emoji floods (more than 8) and your banned words. Invite links, all links and glitchy text are off until you turn them on. Anyone with Manage Messages is skipped.

,automod enableTurns it on.
,filters invites onTurn a filter on or off: invites, links, caps, spam, mentions, emojis, words or zalgo.
,badwords add word1 word2Add banned words. ,badwords remove takes them off.
,punishmode timeout 10mWhat happens: delete, warn (delete and warn) or timeout (delete and mute).

Moderation

The everyday tools, all logged.

,bind staff @ModsMark a role as staff. Staff are never caught by honeypot traps.
,tempmute @Sam 10m spamTimeout for a while. ,warn, ,kick, ,ban and ,softban work the same way.
,setupmuteCreates the muted roles for ,tmute (no messages), ,imute (no images or links) and ,rmute (no reactions).
,purge 25Delete messages. Add a member to delete only theirs.
,invoke ban message You were bannedChange what a punishment message says.

Jail

Park someone without banning them.

,jailsetupCreates the Jailed role and a jail channel. Run it once.
,jail @Sam reasonTakes their roles and locks them in the jail channel.
,unjail @SamLets them out and gives their roles back.
,jailedSee who’s in jail.

Logging

A record of what happened, in the channels you choose.

,logging set messages #logsPick a channel for one kind of log: messages, members, roles, channels, voice, moderation, server or tickets.
,loggingSee where each log goes.
,logging resetClear one log channel or all of them.

Welcome, goodbye and roles

Make new people feel at home.

,welcome setup #welcomeQuick start. Just ,welcome opens the full menu. ,goodbye works the same way.
,welcome testPreview the message.
,variablesThings like the member’s name or the member count that you can put in messages.
,autorole humans @MemberGive new members a role automatically.
,buttonrole @Member Get the roleLet people pick roles with a button. ,reactionrole does it with reactions.

Tickets

Private support channels for your members.

,setup ticket @StaffMakes the ticket panel and lets you style it. ,ticket setup does the same.
,ticket add @SamAdd someone to the ticket you’re in. ,ticket remove takes them out.

Voice channels

Members make their own voice channels.

,voicemaster setupCreates a "Join to Create" channel. Joining it gives you your own voice channel.

The channel owner gets buttons to lock, unlock, hide, raise the member limit or kick people out. If the owner leaves, someone else can claim it.