Configuration
Low-level controls for channels, actions, experiments, and messages.
/honeypot modal
Use /honeypot to configure core behavior. These values are stored per-server.
Core fields
Honeypot Channel
Any message sent here triggers the action.
Required. This should be a dedicated trap channel.
Log Channel
Where moderation events are logged.
Optional but recommended.
Action
Choose
softban, ban, or disabled.Softban is default. It bans then unbans to remove recent messages.
Experiments
Optional switches for extra behavior at catching & preventing spam better.
See below table for options.
Experiments
Optional switches for extra behavior. Most can be enabled together.
| Experiment | What it does | Notes |
|---|---|---|
| Forward Message | Send the incriminating message to the log channel. | Helps you review what messages were sent. |
| ⭐️ Reinvite | Include an invite link in the DM so users can rejoin. | Helpful to legitimate members. |
| No Warning Msg | Removes the warning post from the honeypot channel. | Use when you want the trap to look empty. |
| No DM | Skips DMing the user after they trigger. | Use if you prefer silence. |
| Channel Warmer | Posts a daily message to keep the honeypot active. | Helps the channel look “alive”. |
| Random Channel Name | Renames the honeypot channel daily. See the name list. | Avoid predictable names. |
| Random Channel Name (Chaos) | Renames with random characters daily. | Best against blacklist bots. |
| 🔧 Recreate Channel | Remake the honeypot channel (every day). | Channel gets replaced to have a new ID - messages are not preserved. |
| Timeout First | Timeouts the user for 1 hour before banning/softbanning. | This timeout should still apply when they rejoin. |
| ⭐️ Only More Recent Delete | Only deletes the last 15 minutes of messages instead of 1 hour. | Should be less jarring to message history. |
| ⭐️ Many Honeypots | Allows selection of multiple honeypot channels. | Requires modal submit and re-open to add them. |
| 🔧 Ensure Message Deletion | Search & delete leftover messages from moderated users 2 min after moderation. | May fix issues when the Discord ban doesn't fully clean up messages. |
ExperimentForward Message
What it doesSend the incriminating message to the log channel.
NotesHelps you review what messages were sent.
Experiment⭐️ Reinvite
What it doesInclude an invite link in the DM so users can rejoin.
NotesHelpful to legitimate members.
ExperimentNo Warning Msg
What it doesRemoves the warning post from the honeypot channel.
NotesUse when you want the trap to look empty.
ExperimentNo DM
What it doesSkips DMing the user after they trigger.
NotesUse if you prefer silence.
ExperimentChannel Warmer
What it doesPosts a daily message to keep the honeypot active.
NotesHelps the channel look “alive”.
ExperimentRandom Channel Name
What it doesRenames the honeypot channel daily. See the name list.
NotesAvoid predictable names.
ExperimentRandom Channel Name (Chaos)
What it doesRenames with random characters daily.
NotesBest against blacklist bots.
Experiment🔧 Recreate Channel
What it doesRemake the honeypot channel (every day).
NotesChannel gets replaced to have a new ID - messages are not preserved.
ExperimentTimeout First
What it doesTimeouts the user for 1 hour before banning/softbanning.
NotesThis timeout should still apply when they rejoin.
Experiment⭐️ Only More Recent Delete
What it doesOnly deletes the last 15 minutes of messages instead of 1 hour.
NotesShould be less jarring to message history.
Experiment⭐️ Many Honeypots
What it doesAllows selection of multiple honeypot channels.
NotesRequires modal submit and re-open to add them.
Experiment🔧 Ensure Message Deletion
What it doesSearch & delete leftover messages from moderated users 2 min after moderation.
NotesMay fix issues when the Discord ban doesn't fully clean up messages.
Legend: ⭐️ recommended features · 🔧 advanced, only use if you're seeing issues
Permissions
Some experiments require additional permissions - the bot will let you know if anything is missing.
/honeypot-messages modal
Customize what the bot says. Leave a field empty to reset to default.
Fields
| Message | Purpose | Limit |
|---|---|---|
| Honeypot Warning | Pinned warning shown in the honeypot channel. | 10-1500 chars |
| DM Message | Message sent to the user after they trigger. | 10-1000 chars |
| Log Message | Message posted to your log channel. | 10-500 chars |
MessageHoneypot Warning
PurposePinned warning shown in the honeypot channel.
Limit10-1500 chars
MessageDM Message
PurposeMessage sent to the user after they trigger.
Limit10-1000 chars
MessageLog Message
PurposeMessage posted to your log channel.
Limit10-500 chars
Image support
Honeypot Warning & DM Messages can include images. Place each image URL on its own line at the end of the message (max 4).
Message variables
Use template variables to insert live values in messages.
| Variable | Used in | Replaced with |
|---|---|---|
{{action:text}} | Warning, DM, Log | Text for the chosen action (ban / softban / disabled). |
{{server:name}} | DM | The server name. |
{{server:name:linked}} | DM | Server name linked to its Discord discovery page (if applicable). |
{{server:public-link}} | DM | Link to the server's public discovery page (if applicable). |
{{honeypot:channel:link}} | DM | Link to the honeypot channel message. |
{{reinvite:link}} | DM | Invite link to rejoin the server (requires Reinvite experiment). |
{{user:mention}} | Log | Mentions the user. |
{{user:id}} | Log | Raw user ID. |
{{honeypot:channel:mention}} | Log | Mentions the honeypot channel. |
{{honeypot:moderation-count}} | Log | Total moderation count for this server. |
Variable
{{action:text}}Used inWarning, DM, Log
Replaced withText for the chosen action (ban / softban / disabled).
Variable
{{server:name}}Used inDM
Replaced withThe server name.
Variable
{{server:name:linked}}Used inDM
Replaced withServer name linked to its Discord discovery page (if applicable).
Variable
{{server:public-link}}Used inDM
Replaced withLink to the server's public discovery page (if applicable).
Variable
{{honeypot:channel:link}}Used inDM
Replaced withLink to the honeypot channel message.
Variable
{{reinvite:link}}Used inDM
Replaced withInvite link to rejoin the server (requires Reinvite experiment).
Variable
{{user:mention}}Used inLog
Replaced withMentions the user.
Variable
{{user:id}}Used inLog
Replaced withRaw user ID.
Variable
{{honeypot:channel:mention}}Used inLog
Replaced withMentions the honeypot channel.
Variable
{{honeypot:moderation-count}}Used inLog
Replaced withTotal moderation count for this server.
Log message requirement
Your log message must include
{{user:mention}} or {{user:id}}.Defaults (examples)
These are the default templates used if you do not customize messages.
Warning Message
## DO NOT SEND MESSAGES IN THIS CHANNEL
This channel is used to catch spam bots. Any messages sent here will result in **{{action:text}}**.DM Message
## Honeypot Triggered
You have been **{{action:text}}** from **{{server:name}}** for sending a message in the [honeypot]({{honeypot:channel:link}}) channel.Log Message
{{user:mention}} was {{action:text}} for triggering the honeypot in {{honeypot:channel:mention}}
-# User ID: `{{user:id}}`