FAQ
Quick answers to common questions.
General
What does Honeypot actually do?
It watches one (or many) dedicated channels and automatically moderates anyone who posts there.
Why does this catch spam bots?
Most spam bots blast every visible channel. A normal-looking trap channel catches those blasts immediately.
What is softban?
Softban means ban then unban. It removes the user's recent messages while allowing rejoin later.
Does it read messages outside the honeypot channel?
No. It only reacts to messages in the honeypot channel.
Is Honeypot free?
Yes. It is free to use and lightweight to run. There are no limits or paywalls of any kind.
Setup & Configuration
What permissions do I need to use /honeypot?
You need Manage Server, Ban Members, Manage Messages, and Manage Channels.
Do I need to do anything after adding the bot?
If you gave it the right permissions, most things are already done. You can use
/honeypot to tweak settings further.Can I customize the messages?
Yes. Use
/honeypot-messages to customize the warning, DM, and log messages.Can I customize the action?
Yes. Use
/honeypot to choose between ban, softban (default) or temporarily disabled.Can I rename the honeypot channel?
Yes. Any channel in the server works as long as the bot has Ban Members permission.
Why isn't my channel showing up?
Only normal text channels are supported because they have the highest odds of being spammed in.
Where are actions logged?
To an admin channel you choose. Configure where errors and logs are sent with
/honeypot.Can I self-host it?
Yes. See the self-hosting guide.
Where are commands available?
Most commands run in servers. The
/stats command runs in bot DMs.Troubleshooting
Why did the bot fail to ban someone?
Either its role is below the user or it lacks Ban Members permission.
Can it false-ban normal users?
It only triggers when someone posts in the honeypot channel. If a real user accidentally enters it, they will be treated the same as any other trigger event.
Why does it ignore bots?
Only real Discord users are banned. Bots are seen as trusted as manually added by admins.
Tips & Extras
Any tips for best results?
Ensure its name isnt easily guessable & is high in the channel list. Check out the tips page.
What are experiments?
Optional extra features I've added. See the experiments docs for details.
How can I get help?
Join the Discord server for fast support.
Honeypot DMed me, was I hacked?
Your account may be compromised. See the recovery guide.
More help
Learn more for the full setup guide