Configuration
Configuring and customizing modmail.
Modmail offers an assort of customizations to make your Modmail bot unique to your server. Most customizations can be set with ?config
, but some has its own special command, such as ?activity
. You may find all of the personalizable tweaks available for Modmail below:
All examples presume your prefix is `?`.
Things covered in brackets are optional: `[]` Things covered in angled brackets are required: `<>`
Quick Navigation:
Moderation:
Moderation Configurations
Account Age ( account_age )
Default: No Age Threshold
Set an amount of time a users account has to be created in order to open a ticket.
Example:
?config set account_age P12DT3H
(stands for 12 days and 3 hours in ISO-8601 Duration Format)?config set account_age 3 days and 5 hours
(accepted readable time)
Note(s):
To remove this restriction, do ?config del account_age.
See also:
guild_age
.
Alert on Mention ( alert_on_mention )
Default: No
Mentions all mods (mention) in mention channel when bot is mentioned
Example:
?config set alert_on_mention yes
Notes:
See also:
mention
,mention_channel_id
Prefix ( prefix )
The prefix of the bot
Default: ?
Example:
?config set prefix !
?prefix !
This both result in commands now prefixed with !, for example:
!about
Notes:
If you forgot the bot prefix, Modmail will always respond to its mention (ping).
To reset the prefix back to default:
?config del prefix
Guild Age ( guild_age )
The join date of the recipient user into this server must be greater than the number of days, hours, minutes or any time-interval specified by this configuration.
Default: No age threshold
Example:
?config set guild_age P12DT3H
(stands for 12 days and 3 hours in ISO-8601 Duration Format)?config set guild_age 3 days and 5 hours
(accepted readable time)
Notes:
To remove this restriction, do
{prefix}config del guild_age
.See also:
account_age
.
Reply Without Command ( reply_without_command )
Default: Disabled
Setting this configuration will make all non-command messages sent in the thread channel to be forwarded to the recipient without the need of ?reply
.
Example:
?config set reply_without_command yes
?config set reply_without_command no
Notes:
See also:
anon_reply_without_command
,plain_reply_without_command
.
Show Timestamps ( show_timestamp )
Default: Yes
Shows timestamps on thread embeds
Example:
?config set show_timestamp no
Silent Alert On Commands ( silent_alert_on_mention )
Send a message in the mention channel without mentioning all mods (mention).
Default: No
Example:
?config set alert_on_mention yes
Notes: This has no effect unless alert_on_mention
is set to yes. See also: mention
, mention_channel_id
Update Channel ID ( update_channel_id )
This is the channel where update notifications are sent to.
Default: Log Channel (normally #bot-logs
)
Example:
?config set update_channel_id 9234932582312
(9234932582312 is the channel ID)`
Notes:
This has no effect unless
disable_autoupdates
is set to no andupdate_notifications
is set to yes.See also:
log_channel_id
Update Notifications ( update_notifications )
This is the channel where update notifications are sent to.
Default: Yes
Example:
?config set update_notifications no
Notes:
This has no effect unless
disable_autoupdates
is set to no.See also:
update_channel_id
Fallback Category ID ( fallback_category_id )
This is the category that will hold the threads when the main category is full.\n\nTo change the Fallback category, you will need to find the category’s ID.
Default: Fallback Modmail
(created when the main category is full)
Example:
?config set fallback_category_id 9234932582312
(9234932582312
is the category ID)
Notes:
If the Fallback category ended up being non-existent/invalid, Modmail will create a new one. To fix this, set
fallback_category_id
to a valid category.See also:
main_category_id
.
Log Channel ID ( log_channel_id )
This is the channel where all log messages will be sent (ie. thread close message, update message, etc.).\n\nTo change the log channel, you will need to find the channel’s ID. The channel doesn’t necessary have to be under the main_category
.
Default: #bot-logs
(created with ?setup
)
Example:
?config set log_channel_id 9234932582312
(9234932582312 is the channel ID)
Notes:
If the Modmail logging channel ended up being non-existent/invalid, no logs will be sent.
Main Category ID ( main_category_id )
This is the category where all new threads will be created.\n\nTo change the Modmail category, you will need to find the category’s ID.
Default: Modmail
(created with ?setup
)
Example:
?config set main_category_id 9234932582312
(9234932582312
is the category ID)`
Notes:
If the Modmail category ended up being non-existent/invalid, Modmail will break. To fix this, run
?setup
again or setmain_category_id
to a valid category.When the Modmail category is full, new channels will be created in the fallback category.
See also:
fallback_category_id
Mod Typing ( mod_typing )
When this is set to yes
, whenever a moderator starts to type in the thread channel, the recipient user will see "{bot.user.display_name} is typing…" in their DM channel.
Default: Disabled
Example:
?config set mod_typing yes
?config set mod_typing no
Notes:
See also:
mod_typing
User Typing ( user_typing )
When this is set to yes
, whenever the recipient user starts to type in their DM channel, the moderator will see “{bot.user.display_name} is typing…” in the thread channel.
Default: Enabled
Example:
?config set user_typing yes
?config set user_typing no
Notes:
See also:
mod_typing
.
Twitch URL ( twitch_url )
This channel dictates the linked Twitch channel when the activity is set to "Streaming".
Default: https://www.twitch.tv/discordmodmail/
Example:
?config set twitch_url https://www.twitch.tv/yourchannelname/
Notes:
This has no effect when the activity is not set to "Streaming".
See also:
?help activity
Close On Leave ( close_on_leave )
Closes a modmail thread upon user leave automatically
Default: No
Example:
?config set close_on_leave yes
Notes:
See also:
close_on_leave_reason
.
Confirm Thread Creation ( confirm_thread_creation )
Ensure users confirm that they want to create a new thread
Default: No
Example:
?config set confirm_thread_creation yes
Notes:
See also:
confirm_thread_creation_title
,confirm_thread_response
,confirm_thread_creation_accept
,confirm_thread_creation_deny
Mention ( mention )
This is the message above user information for when a new thread is created in the channel.
Default: @here
Example:
?config set mention Yo~ Here's a new thread for ya!
?mention Yo~ Here's a new thread for ya!
Notes:
To disable mention, use command
?mention disable
.See also:
?help mention
.
Require Close Reason ( require_close_reason )
Require a reason to close threads.
Default: No
Example:
?config set require_close_reason yes
Thread Auto Close ( thread_auto_close )
Setting this configuration will close threads automatically after the number of days, hours, minutes or any time-interval specified by this configuration.
Default: Never
Example:
?config set thread_auto_close P12DT3H
(stands for 12 days and 3 hours in ISO-8601 Duration Format)?config set thread_auto_close 3 days and 5 hours
(accepted readable time)
Notes:
To disable auto close, do
?config del thread_auto_close
.To prevent a thread from auto-closing, do
?close cancel
.See also:
thread_auto_close_silently
,thread_auto_close_response
.
Thread Cooldown ( thread_cooldown )
Specify the time required for the recipient to wait before allowed to create a new thread.
Default: Never
Example:
?config set thread_cooldown P12DT3H
(stands for 12 days and 3 hours in ISO-8601 Duration Format)?config set thread_cooldown 3 days and 5 hours
(accepted readable time)
Notes:
To disable thread cooldown, do
?config del thread_cooldown
.
Thread Move Notify ( thread_move_notify )
Notify the recipient if the thread was moved.
Default: No
Example:
?config set thread_move_notify yes
?config set thread_move_notify no
Notes:
See also:
thread_move_title
,thread_move_response
,thread_move_notify_mods
.
Thread Move Notify Mods ( thread_move_notify_mods )
Notify mods again after the thread is moved
Default: No
Example:
?config set thread_move_notify_mods yes
?config set thread_move_notify_mods no
Notes:
See also:
thread_move_title
,thread_move_response
,thread_move_notify
.
Use Regex Autotrigger ( use_regex_autotrigger )
Whether to use regex to compare in autotriggers.
Default: No
Example:
?config set use_regex_autotrigger yes
Notes:
This is meant for advanced user that understand regular expressions.
You can test it out with https://regexr.com on
PCRE (Server)
modeSee command:
autotrigger
Plain Reply Without Command ( plain_reply_without_command )
Setting this configuration will make all non-command messages sent in the thread channel to be forwarded to the recipient in a plain form without the need of ?reply
.
Default: Disabled
Example:
?config set plain_reply_without_command yes
?config set plain_reply_without_command no
Notes:
See also:
reply_without_command
,anon_reply_without_command
.
Anonymous Snippets ( anonymous_snippets )
Sends snippets anonymously.
Default: No
Example:
?config set anonymous_snippets yes
Notes:
See also:
anon_avatar_url
,anon_tag
,plain_snippets
.
Appearance Configurations
Blocked Emoji ( blocked_emoji )
This is the emoji added to the message when when a Modmail action is invoked unsuccessfully (ie. DM Modmail when blocked, failed to reply, etc.).
Default: 🚫
Example:
?config set blocked_emoji 🙅
Notes:
You can disable
blocked_emoji
with?config set blocked_emoji disable
.Custom/animated emojis are also supported, however, the emoji must be added to the server.
See also:
sent_emoji
.
Close Emoji ( close_emoji )
This is the emoji the recipient can click to close a thread themselves. The emoji is automatically added to the thread_creation_response
embed.
Default: 🔒
Example:
?config set close_emoji 👍
Notes:
This will only have an effect when
recipient_thread_close
is enabled.See also:
recipient_thread_close
.
Confirm Thread Creation Accept ( confirm_thread_creation_accept )
Emoji to accept thread creation
Default: \u2705
Example:
?config set confirm_thread_creation_accept \u2611
Notes:
This has no effect unless
confirm_thread_creation
is setSee also:
confirm_thread_creation
,confirm_thread_creation_title
,confirm_thread_response
,confirm_thread_creation_deny
Confirm Thread Creation Deny ( confirm_thread_creation_deny )
Emoji to cancel thread creation
Default: \uD83D\uDEAB
Example:
?config set confirm_thread_creation_deny \u26D4
Notes:
This has no effect unless
confirm_thread_creation
is setSee also:
confirm_thread_creation
,confirm_thread_creation_title
,confirm_thread_response
,confirm_thread_creation_accept
Error Color ( error_color )
This is the color for Modmail when anything goes wrong, unsuccessful commands, or a stern warning.
Default: Discord Red #E74C3C
Example:
?config set error_color ocean blue
?config set error_color ff1242
?config set error_color #ff1242
?config set error_color fa1
Notes:
Available color names can be found on Color Options.
See also:
main_color
,mod_color
,recipient_color
.
Main Color ( main_color )
This is the main color for Modmail (help/about/ping embed messages, subscribe, move, etc.).
Default: Discord Blurple #7289DA
Example:
?config set main_color olive green
?config set main_color 12de3a
?config set main_color #12de3a
?config set main_color fff
Notes:
Available color names can be found on Color Options.
See also:
error_color
,mod_color
,recipient_color
.
Mod Color ( mod_color )
This is the color of the messages sent by the moderators, this applies to messages within in the thread channel and the DM thread messages received by the recipient.
Default: Discord Green #2ECC71
Example:
?config set mod_color dark beige
?config set mod_color cb7723
?config set mod_color #cb7723
?config set mod_color c4k
Notes:
Available color names can be found on Color Options.
See also:
recipient_color
,main_color
,error_color
.
React To Contact Emoji ( react_to_contact_emoji )
An emoji which is tracked in react_to_contact_message
Default: \u2705
Example:
?config set react_to_contact_emoji \u2705
Notes:
See also:
react_to_contact_message \u2705
Recipient Color ( recipient_color )
This is the color of the messages sent by the recipient, this applies to messages received in the thread channel.
Default: "Discord Gold #F1C40F
Example:
?config set recipient_color dark beige
?config set recipient_color cb7723
?config set recipient_color #cb7723
?config set recipient_color c4k
Notes:
Available color names can be found on Color Options.
See also:
mod_color
,main_color
,error_color
.
Sent Emoji ( sent_emoji )
This is the emoji added to the message when when a Modmail action is invoked successfully (ie. DM Modmail, edit message, etc.).
Default: ✅
Example:
?config set sent_emoji ✨
Notes:
You can disable
sent_emoji
with?config set sent_emoji disable
.Custom/animated emojis are also supported, however, the emoji must be added to the server.
See also:
blocked_emoji
.
Show Log URL Button ( show_log_url_button )
Shows the button to open the Log URL.
Default: No
Example:
?config set show_log_url_button yes
Thread Appearance
Use Random Channel Name ( use_random_channel_name )
When this is set to yes
, new thread channels will be named with random characters tied to their user ID.
Default: No
Example:
?config set use_random_channel_name yes
?config set use_random_channel_name no
Notes:
This config is suitable for servers in Server Discovery to comply with channel name restrictions.
This cannot be applied with `use_timestamp_channel_name`, `use_nickname_channel_name`, or `use_user_id_channel_name`.
See also:
use_timestamp_channel_name
,use_user_id_channel_name
,use_nickname_channel_name
.
Use Timestamp Channel Name ( use_timestamp_channel_name )
When this is set to yes
, new thread channels will be named with the recipient's account creation date instead of the recipient's name.
Default: No
Example:
?config set use_timestamp_channel_name yes
?config set use_timestamp_channel_name no
Notes:
This config is **NOT** suitable for servers in Server Discovery to comply with channel name restrictions.
This cannot be applied with `use_user_id_channel_name`, `use_random_channel_name` or `use_nickname_channel_name`.
See also:
use_user_id_channel_name
,use_nickname_channel_name
,use_random_channel_name
.
Use User ID Channel Name ( use_user_id_channel_name )
When this is set to yes
, new thread channels will be named with the recipient's ID instead of the recipient's name.
Default: No
Example:
?config set use_user_id_channel_name yes
?config set use_user_id_channel_name no
Notes:
This config is suitable for servers in Server Discovery to comply with channel name restrictions.
This cannot be applied with `use_timestamp_channel_name`, `use_random_channel_name` or `use_nickname_channel_name`.
See also:
use_timestamp_channel_name
,use_nickname_channel_name
,use_random_channel_name
.
Use Nickname Channel Name ( use_nickname_channel_name )
When this is set to yes
, new thread channels will be named with the recipient's nickname instead of the recipient's name.
Default:
Example:
?config set use_nickname_channel_name yes
?config set use_nickname_channel_name no
Notes:
This config is suitable for servers in Server Discovery to comply with channel name restrictions.
This cannot be applied with `use_timestamp_channel_name`, `use_random_channel_name` or `use_user_id_channel_name`.
See also:
use_timestamp_channel_name
,use_user_id_channel_name
,use_random_channel_name
.
Use Hoisted Top Role ( use_hoisted_top_role )
Controls if only hoisted roles are evaluated when finding top role.
Default: Yes
Example:
?config set use_hoisted_top_role yes
?config set use_hoisted_top_role no
Notes:
Top role is displayed in embeds when replying or adding/removing users to a thread in the case mod_tag and anon_username are not set.
If this configuration is enabled, only roles that are hoisted (displayed seperately in member list) will be used. If a user has no hoisted roles, it will return 'None'.
If you would like to display the top role of a user regardless of if it's hoisted or not, disable
use_hoisted_top_role
.
Thread Show Account Age ( thread_show_account_age )
Shows account age on first message sent in thread channels to mods
Default: Yes
Example:
?config set thread_show_account_age no
Notes:
See also:
thread_show_roles
,thread_show_join_age
Thread Show Join Age ( thread_show_join_age )
Shows join age on first message sent in thread channels to mods
Default: Yes
Example:
?configconfig set thread_show_join_age no
Notes:
See also:
thread_show_account_age
,thread_show_roles
.
Thread Show Roles ( thread_show_roles )
Shows roles on first message sent in thread channels to mods
Default: Yes
Example:
?config set thread_show_account_age no
Notes:
See also:
thread_show_roles
,thread_show_join_age
.
Mod Tag ( mod_tag )
This is the name tag in the “footer” section of the embeds sent by moderators in the recipient DM and thread channel.
Default: The moderator's highest role
Example:
?config set mod_tag Moderator
Notes:
When the message is sent anonymously, `anon_tag` is used instead.
See also:
anon_tag
.
Anon Tag ( anon_tag )
This is the name tag in the “footer” section of the embeds sent by anonymous moderators in the recipient DM.
Default: "Response"
Example:
?config set anon_tag Support Agent
Notes:
See also:
anon_avatar_url
,anon_username
,mod_tag
.
Anon Avatar URL ( anon_avatar_url )
This is the avatar of the embeds sent by anonymous moderators in the recipient DM.
Default: Server avatar
Example:
?config set anon_avatar_url https://path.to/your/avatar.png
(you will need to upload the avatar to somewhere)
Notes:
See also:
anon_username
,anon_tag
.
Anon Username ( anon_username )
This is the name in the “author” section of the embeds sent by anonymous moderators in the recipient DM.
Default: Fallback on mod_tag
Example:
?config set anon_username Incognito Mod
Notes:
See also:
anon_avatar_url
,anon_tag
.
Transfer Reactions ( transfer_reactions )
Transfer users reactions to mods and vice versa (If someone reacts to a thread message the other party will see it.)
Default: Yes
Example:
?config set transfer_reactions no
Thread Responses
Close On Leave Reason ( close_on_leave_reason )
Reason for closing the thread once member leaves
Default: The recipient has left the server.
Example:
?config set close_on_leave_reason Member left
Notes:
This has no effect unless
close_on_leave
is set.See also:
close_on_leave
.
Confirm Thread Creation Title ( confirm_thread_creation_title )
Title for the embed message sent to users to confirm a thread creation
Default: Confirm thread creation
Example:
?config set confirm_thread_creation_title Are you sure you want to create a new thread?
Notes:
See also:
confirm_thread_creation
,confirm_thread_response
,confirm_thread_creation_accept
,confirm_thread_creation_deny
Confirm Thread Response ( confirm_thread_response )
Description for the embed message sent to users to confirm a thread creation
Default: React to confirm thread creation which will directly contact the moderators
Example:
?config set confirm_thread_response React to confirm
Notes:
See also:
confirm_thread_creation
,confirm_thread_creation_title
,confirm_thread_creation_accept
,confirm_thread_creation_deny
Cooldown Thread Response ( cooldown_thread_response )
The description of the message embed when the user has a cooldown before creating a new thread.
Default: Your cooldown ends {delta}. Try contacting me then.
`{delta}` will be replaced with whatever time you gave it.
Example:
?config set cooldown_thread_response Be patient! You are on cooldown, wait {delta} more.
Notes:
"Only has an effect when
thread_cooldown
is setMust have a {delta} included which will be replaced with the duration of time.
See also:
cooldown_thread_title
.
Cooldown Thread Title ( cooldown_thread_title )
The title of the message embed when the user has a cooldown before creating a new thread.
Default: Message not sent!
Example:
?config set cooldown_thread_title Error
Notes:
Only has an effect when
thread_cooldown
is setSee also:
cooldown_thread_response
.
Disabled Current Thread Footer ( disabled_current_thread_footer )
The footer of the message embed when Modmail DM is disabled and user DMs Modmail from existing thread.
Default: Please try again later...
Example:
?config set disabled_current_thread_footer Message back!
Notes:
Only has an effect when
{prefix}disable all
is set.See also:
disabled_current_thread_title
,disabled_current_thread_response
,disabled_new_thread_footer
.
Disabled Current Thread Response ( disabled_current_thread_response )
The body of the message embed when Modmail DM is disabled and user DMs Modmail from existing thread.
Default: We are not accepting any messages.
Example:
?config set disabled_current_thread_response On break right now.
Notes:
Only has an effect when
{prefix}disable all
is set.See also:
disabled_current_thread_title
,disabled_current_thread_footer
,disabled_new_thread_response
.
Disabled Current Thread Title ( disabled_current_thread_title )
The title of the message embed when Modmail DM is disabled and user DMs Modmail from existing thread.
Default: Not Delivered.
Example:
?config set disabled_current_thread_title Unavailable
Notes:
Only has an effect when
{prefix}disable all
is set.See also:
disabled_current_thread_response
,disabled_current_thread_footer
,disabled_new_thread_title
.
Disabled New Thread Footer ( disabled_new_thread_footer )
The footer of the message embed when Modmail new thread creation is disabled and user tries to create a new thread.
Default: Please try again later...
Example:
?config set disabled_new_thread_footer Contact us later
Notes:
Only has an effect when
{prefix}disable
or{prefix}disable all
is set.See also:
disabled_new_thread_title
,disabled_new_thread_response
,disabled_current_thread_footer
.
Disabled New Thread Response ( disabled_new_thread_response )
The body of the message embed when Modmail new thread creation is disabled and user tries to create a new thread.
Default: We are not accepting new threads.
Example:
?config set disabled_new_thread_response Our working hours is between 8am - 6pm EST.
Notes:
Only has an effect when
{prefix}disable
or{prefix}disable all
is set.See also:
disabled_new_thread_title
,disabled_new_thread_footer
,disabled_current_thread_response
.
Disabled New Thread Title ( disabled_new_thread_title )
The title of the message embed when Modmail new thread creation is disabled and user tries to create a new thread.
Default: Not Delivered.
Example:
?config set disabled_new_thread_title Closed
Notes:
Only has an effect when
{prefix}disable
or{prefix}disable all
is set.See also:
disabled_new_thread_response
,disabled_new_thread_footer
,disabled_current_thread_title
.
Private Added To Group Description Anon ( private_added_to_group_description_anon )
This is the message embed content sent to the recipient that is just added to a thread when adduser is used anonymously.
Default: A moderator has added you to a Modmail thread.
Example:
?config set private_added_to_group_description_anon Any message sent here will be sent to all other thread recipients.
Notes:
When adduser (no anon) is used,
private_added_to_group_description
is used instead.The public_ variant is used when sending to other thread recipients.
See also:
private_added_to_group_title
,public_added_to_group_description_anon
Private Added To Group Response ( private_added_to_group_response )
This is the message embed content sent to the recipient that is just added to a thread.
Default: "{{moderator.name}} has added you to a Modmail thread."
Example:
?config set private_added_to_group_description Any message sent here will be sent to all otherthread recipients.
Notes:
You may use the
{{moderator}}
variable for access to the Member that added the user.When anonadduser is used,
private_added_to_group_description_anon
is used instead.The public_ variant is used when sending to other thread recipients.
See also:
private_added_to_group_title
,public_added_to_group_description
Private Added To Group Title ( private_added_to_group_title )
This is the message embed title sent to the recipient that is just added to a thread.
Default: New Thread (Group)
Example:
?config set private_added_to_group_title Welcome to this new group thread!
Notes:
The public_ variant is used when sending to other thread recipients.
See also:
private_added_to_group_description
,public_added_to_group_title
Private Removed From Group Description Anon ( private_removed_from_group_description_anon )
This is the message embed content sent to the recipient that is just removed from a thread when removeuser is used anonymously.
Default: A moderator has removed you from the Modmail thread.
Example:
?config set private_removed_from_group_description_anon You are permenantly removed from this thread.
Notes:
When adduser (no anon) is used,
private_removed_from_group_description
is used instead.The public_ variant is used when sending to other thread recipients.
See also:
private_removed_from_group_title
,public_removed_from_group_description_anon
Private Removed From Group Response ( private_removed_from_group_response )
This is the message embed content sent to the recipient that is just removed from a thread.
Default: "{{moderator.name}} has removed you from the Modmail thread."
Example:
?config set private_removed_from_group_description Bye
Notes:
You may use the
{{moderator}}
variable for access to the Member that added the user.When anonremoveuser is used,
private_removed_from_group_description_anon
is used instead.The public_ variant is used when sending to other thread recipients.
See also:
private_removed_from_group_title
,public_removed_from_group_description
Private Removed From Group Title ( private_removed_from_group_title )
This is the message embed title sent to the recipient that is just removed from a thread.
Default: Removed From Thread (Group)
Example:
?config set private_removed_from_group_title Welcome to this new group thread!
Notes:
The public_ variant is used when sending to other thread recipients.
See also:
private_removed_from_group_description
,public_removed_from_group_title
Public Added To Group Description Anon ( public_added_to_group_description_anon )
This is the message embed content sent to all other recipients when someone is added to the thread when adduser is used anonymously.
Default: "A moderator has added {{users}} to the Modmail thread."
Example:
?config set public_added_to_group_description_anon Any message sent here will be sent to all other thread recipients.
Notes:
When adduser (no anon) is used,
public_added_to_group_description
is used instead.The private_ variant is used when sending to the new user.
See also:
public_added_to_group_title
,private_added_to_group_description_anon
Public Added To Group Response ( public_added_to_group_response )
This is the message embed content sent to all other recipients when someone is added to the thread.
Default: "{{moderator.name}} has added {{users}} to the Modmail thread."
Example:
?config set public_added_to_group_response Welcome {users}!
Notes:
You may use the
{{moderator}}
variable for access to the Member that added the user.When anonadduser is used,
public_added_to_group_description_anon
is used instead.The private_ variant is used when sending to the new user.
See also:
public_added_to_group_title
,private_added_to_group_description
Public Added To Group Title ( public_added_to_group_title )
This is the message embed title sent to all other recipients when someone is added to the thread.
Default: New User
Example:
?config set public_added_to_group_title Welcome to our new user!
Notes:
The private_ variant is used when sending to the new user.
See also:
private_added_to_group_title
,private_added_to_group_title
Public Removed From Group Description Anon ( public_removed_from_group_description_anon )
This is the message embed content sent to all other recipients when someone is removed from the thread when removeuser is used anonymously.
Default: "A moderator has removed {{users}} from the Modmail thread."
Example:
?config set public_removed_from_group_description_anon Goodbye {users}!
Notes:
When adduser (no anon) is used,
public_removed_from_group_description
is used instead.The private_ variant is used when sending to the new user.
See also:
public_removed_from_group_title
,private_removed_from_group_description_anon
Public Removed From Group Response ( public_removed_from_group_response )
This is the message embed content sent to all other recipients when someone is removed from the thread.
Default: "{{moderator.name}} has removed {{users}} from the Modmail thread."
Example:
?config set public_removed_from_group_response Goodbye {users}!
Notes:
You may use the
{{moderator}}
variable for access to the Member that added the user.When anonremoveuser is used,
public_removed_from_group_description_anon
is used instead.
Public Removed From Group Title ( public_removed_from_group_title )
This is the message embed title sent to all other recipients when someone is removed from the thread.
Default: User Removed
Example:
?config set public_removed_from_group_title User is now gone!
Notes:
The private_ variant is used when sending to the new user.
See also:
private_removed_from_group_title
,private_removed_from_group_title
React To Contact Message ( react_to_contact_message )
A message ID where reactions are tracked. If the react_to_contact_emoji
is added, the bot opens a thread with them.
Default: None
Example:
?config set react_to_contact_message 773575608814534717
Notes:
See also:
react_to_contact_emoji
Recipient Thread Close ( recipient_thread_close )
Setting this configuration will allow recipients to use the close_emoji
to close the thread themselves.
Default: Disabled
Example:
?config set recipient_thread_close yes
?config set recipient_thread_close no
Notes:
The close emoji is dictated by the configuration
close_emoji
.See also:
close_emoji
.
Thread Auto Close Response ( thread_auto_close_response )
This is the message to display when the thread when the thread auto-closes.
Default: "This thread has been closed automatically due to inactivity after {{timeout}}."
Example:
?config set thread_auto_close_response Your close message here.
Notes:
Its possible to use
{{timeout}}
as a placeholder for a formatted timeout text.This will not have an effect when
thread_auto_close_silently
is enabled.Discord flavoured markdown is fully supported in
thread_auto_close_response
.See also:
thread_auto_close
,thread_auto_close_silently
.
Thread Auto Close Silently ( thread_auto_close_silently )
Setting this configuration will close silently when the thread auto-closes.
Default: No
Example:
?config set thread_auto_close_silently yes
?config set thread_auto_close_silently no
Notes:
This will only have an effect when
thread_auto_close
is set.See also:
thread_auto_close
.
Thread Cancelled ( thread_cancelled )
This is the message to display when a thread times out and creation is cancelled.
Default: "Cancelled"
Example:
?config set thread_cancelled Gone.
Thread Close Footer ( thread_close_footer )
This is the message embed footer sent to the recipient upon the closure of a thread.
Default: "Replying will create a new thread"
Example:
?config set thread_close_footer Bye!
Notes:
See also:
thread_close_title
,thread_close_response
,thread_creation_footer
.
Thread Close Response ( thread_close_response )
This is the message embed content sent to the recipient upon the closure of a thread.
There are three variables you can use within the thread close message: - closer
: the discord User object of the user who closed the thread. - logkey
: the key for the thread logs. (ie. 51ecd946dc29) - loglink
: the full link URL to the thread logs. (ie. https://logviewer.herokuapp.com/logs/51ecd946dc29)
Default: "{{closer.mention}} has closed this Modmail thread"
Example:
?config set thread_close_response Your message is appriciated!
To use variables in the thread close message:
?config set thread_close_response {closer.mention} has closed this thread, here's your log key: **
{logkey}**.
Notes:
When
recipient_thread_close
is enabled and the recipient closed their own thread,thread_self_close_response
is used instead of this configuration.You may use the
{{closer}}
variable for access to the Member that closed the thread.Discord flavoured markdown is fully supported in
thread_close_response
.See also:
thread_close_title
,thread_close_footer
,thread_self_close_response
,thread_creation_response
.
Thread Close Title ( thread_close_title )
This is the message embed title sent to the recipient upon the closure of a thread.
Default: "Thread Closed"
Example:
?config set thread_close_title Farewell!
Notes:
See also:
thread_close_response
,thread_close_footer
,thread_creation_title
.
Thread Contact Silently ( thread_contact_silently )
Setting this configuration will always open a new thread silently in contact.
Default: No
Example:
?config set thread_contact_silently yes
?config set thread_contact_silently no
Notes:
Works like
{prefix}contact <user> silent
for every new thread.
Thread Creation Contact Response ( thread_creation_contact_response )
This is the message embed description sent to recipients when contacted by a mod.
Default: "{{creator.name}} has opened a Modmail thread."
Example:
?config set thread_creation_contact_response New thread opened.
Notes:
You may use the
{{creator}}
variable for access to the Member that created the thread.thread_creation_self_contact_response
is used when contacted by self.See also:
thread_creation_contact_title
,thread_creation_self_contact_response
.
Thread Creation Contact Title ( thread_creation_contact_title )
This is the message embed title sent to recipients when contacted.
Default: "New Thread"
Example:
?config set thread_creation_contact_title New Message!
Notes:
See also:
thread_creation_self_contact_response
,thread_creation_contact_response
.
Thread Creation Footer ( thread_creation_footer )
This is the message embed footer sent to the recipient upon the creation of a new thread.
Default: "Your message has been sent"
Example:
`?config set thread_creation_footer Please Hold...
Notes:
This is used in place of
thread_self_closable_creation_footer
whenrecipient_thread_close
is enabled.See also:
thread_creation_title
,thread_creation_response
,thread_self_closable_creation_footer
,thread_close_footer
.
Thread Creation Response ( thread_creation_response )
This is the message embed content sent to the recipient upon the creation of a new thread.
Default: "The staff team will get back to you as soon as possible."
Example:
?config set thread_creation_response You will be contacted shortly.
Notes:
Discord flavoured markdown is fully supported in
thread_creation_response
.See also:
thread_creation_title
,thread_creation_footer
,thread_close_response
.
Thread Creation Self Contact Response ( thread_creation_self_contact_response )
This is the message embed description sent to recipients when self-contacted.
Default: "You have opened a Modmail thread."
Example:
?config set thread_creation_self_contact_response You contacted yourself.
Notes:
thread_creation_contact_response
is used when contacted by another user.See also:
thread_creation_contact_title
,thread_creation_contact_response
.
Thread Creation Title ( thread_creation_title )
This is the message embed title sent to the recipient upon the creation of a new thread.
Default: "Thread Created"
Example:
?config set thread_creation_title Hello!
Notes:
See also:
thread_creation_response
,thread_creation_footer
,thread_close_title
.
Thread Move Response ( thread_move_response )
This is the message to display to the user when the thread is moved.
Default: This thread has been moved.
Example:
?config set thread_move_response This thread has been moved to another category for review!
Notes:
Only has an effect when
thread_move_notify
is on.See also:
thread_move_title
,thread_move_notify
.
Thread Move Title ( thread_move_title )
The title of the message embed when a thread is moved.
Default: Thread Moved
Example:
?config set thread_move_title Thread transferred to another channel!
Notes: -See also: thread_move_notify
, thread_move_notify_mods
, thread_move_response
.
Thread Self Closable Creation Footer ( thread_self_closable_creation_footer )
This is the message embed footer sent to the recipient upon the creation of a new thread.
Default: "Click the lock to close the thread"
Example:
?config set thread_self_closable_creation_footer Please Hold...
Notes:
This is used in place of
thread_creation_footer
whenrecipient_thread_close
is disabled.See also:
thread_creation_title
,thread_creation_response
,thread_creation_footer
.
Thread Self Close Response ( thread_self_close_response )
This is the message embed content sent to the recipient upon the closure of a their own thread.
Default: "You have closed this Modmail thread."
Example:
?config set thread_self_close_response You have closed your own thread...
Notes:
When
recipient_thread_close
is disabled or the thread wasn't closed by the recipient,thread_close_response
is used instead of this configuration.You may use the
{{closer}}
variable for access to the Member that closed the thread.{{loglink}}
can be used as a placeholder substitute for the full URL linked to the thread in the log viewer and{{loglink}}
for the unique key (ie. s3kf91a) of the log.Discord flavoured markdown is fully supported in
thread_self_close_response
. -See also:thread_close_title
,thread_close_footer
,thread_close_response
.
.env
Config Options
.env
Config OptionsThe following is a list of config options that can _ONLY_** be added by editing the .env
file. Please use whichever guide you followed to set up the bot to see how to add these variables.**
It is recommended you avoid and ignore changing any of these you do not fully understand
Last updated