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 and update_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 set main_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) mode
See 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 set
See 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 set
See 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 set
Must 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 set
See 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 when recipient_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 when recipient_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

The 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

Option

Description

Required

Usage

modmail_guild_id

Inbox server for tickets

MODMAIL_GUILD_ID = GUILDIDHERE

guild_id

Main server the bot is in

Yes

GUILD_ID = GUILDIDHERE

log_url_prefix

Default is /logs

Yes

LOG_URL_PREFIX = PREFIX

mongo_uri

The connection uri for the database

Yes

MONGO_URI = mongodb+srv://Papiersnipper:mypassword123@modmail-rdm99.mongodb.net/

connection_uri

The connection uri for the database

Yes

CONNECTION_URI = mongodb+srv://Papiersnipper:mypassword123@modmail-rdm99.mongodb.net/

owners

ID's of the users who will have owner perms

Yes

OWNERS = 1234,5678,91011

enable_presence_intent

Enables the presence intent, required for some plugins. Uses extra resources.

ENABLE_PRESENCE_INTENT = True

registry_plugins_only

Disallows the ability to download plugins that aren’t in the plugin registry.

REGISTRY_PLUGINS_ONLY = True

token

The bots token

Yes

TOKEN = MTAyMjk2NTA4MzYxtewgw3eNw.thisis.afaketoken-WGjwfvQ

enable_eval

Enables the eval command to run arbitrary code on the bot.

ENABLE_EVAL = True

github_token

Needed to use the update command

GITHUB_TOKEN = ghp_ABC132gfdsg4321fds

disable_autoupdates

Allows for auto updates

DISABLE_AUTOUPDATES = True

disable_updates

Disables updates all together

DISABLE_UPDATES = True

log_level

The type of information posted in the terminal, Default is INFO

LOG_LEVEL = ERROR/WARNING/INFO/DEBUG/NOTSET

PreviousPlugins NextPermissions

Last updated 1 year ago