Honeypot Configuration
When dashboard-backed configuration is enabled, use the dashboard first because live settings may be stored in MongoDB instead of reading only the local JSON5 file.
Config Files
- Runtime config:
configuration/honeypot.json5 - English template:
plugins/honeypot/data/configs/en-honeypot.json5 - German template:
plugins/honeypot/data/configs/de-honeypot.json5 - Plugin entry:
plugins/honeypot/main.js
Both language templates and both dashboard schemas include the current mute method setting.
Main Fields
| Field | Type | Default | Notes |
|---|---|---|---|
enabled | boolean | true | Enables warning management and message enforcement. |
punishment.action | string | mute | Allowed dashboard values: mute, kick, ban, or delete_only. |
punishment.mute_method | string | athena | Use athena for a tracked moderation mute or discord for a direct timeout. Only applies when the action is mute. |
punishment.timeout_duration_minutes | number | 10080 | Mute or timeout duration in minutes. The runtime limit is 40,320 minutes (28 days). |
punishment.delete_trigger_message | boolean | true | Deletes the message that triggered the honeypot. |
punishment.dm_user | boolean | true | Sends the member a DM before applying the punishment. |
punishment.ignored_user_ids | string[] | [] | User IDs that never trigger enforcement. |
punishment.ignored_role_ids | string[] | [] | Members with any listed role never trigger enforcement. |
warning.post_on_ready | boolean | true | Posts or updates the warning after AthenaBot becomes ready. |
warning.type | string | EMBED | Use EMBED or MESSAGE. |
warning.pin | boolean | false | Pins the warning when Discord allows it. |
permissions.honeypot_command | string | management | Athena permission level required for /honeypot. |
The setting remains named timeout_duration_minutes for compatibility, but
it controls the duration for both Athena moderation mutes and Discord
timeouts.
Punishment Actions
| Action | Result |
|---|---|
mute | Uses the configured mute_method for the selected duration. |
kick | Kicks the member from the server. |
ban | Bans the member and asks Discord to delete the previous 24 hours of messages. |
delete_only | Deletes the trigger message when enabled without restricting the member. |
Warning Message
Set warning.type to EMBED to use lang.warning.embed, or MESSAGE to use
lang.warning.message. With post_on_ready: true, the plugin remembers the
existing warning and edits it after a restart or configuration change. If that
message no longer exists, it posts a new one.
Language Settings
The lang section controls:
- Slash command and subcommand names and descriptions
- Plain-text and embed warning content
- Member DM title, description, color, and footer
- Incident-log wording and field labels
- Audit-log reason, status labels, success messages, and errors
Useful placeholders include:
| Area | Placeholders |
|---|---|
| Warning | {guild} |
| Member DM | {guild}, {punishment}, {reason} |
| Log title and description | {guild}, {user}, {channel}, {punishment}, {reason} |
AthenaBot also resolves configured custom emoji names in rendered text.
Dashboard Configuration
The dashboard exposes the complete config, including punishment.mute_method
with athena and discord choices. English and German dashboard labels are
included with the plugin.
Channel Slots
The channel IDs are stored through Athena setup instead of in this config file:
| Slot | Purpose |
|---|---|
honeypot_channel | Holds the warning and receives trigger messages. |
honeypot_log | Receives incident logs. Optional. |