Releases: modmail-dev/Modmail
Invalid Release
Do not use this release.
Stable Release
Changed
Commands now have better error messages, instead of just sending the help message for a command when an argument fails to be converted to its specified object, the bot now says things like "User 'bob' not found" instead.
Resupport OWNERS Config Var
Un-deprecated the OWNERS
config variable to support discord developer team accounts.
Permission System
New Permissions System
- A brand new permission system! Replacing the old guild-based permissions (ie. manage channels, manage messages), the new system enables you to customize your desired permission level specific to a command or a group of commands for a role or user.
- There are five permission levels:
- Owner [5]
- Administrator [4]
- Moderator [3]
- Supporter [2]
- Regular [1]
Usage
You may add a role or user to a permission group through any of the following methods:
?permissions add level owner @role
?permissions add level supporter member-name
?permissions add level moderator everyone
?permissions add level moderator @member#1234
?permissions add level administrator 78912384930291853
The same applies to individual commands permissions:
?permissions add command command-name @member#1234
- ... and the other methods listed above.
To revoke permission, use remove
instead of add
.
To view all roles and users with permission for a permission level or command do:
?permissions get command command-name
?permissions get level owner
By default, all newly set up Modmail will have OWNER
set to the owner of the bot, and REGULAR
set to @everyone.
Breaking
When updating to this version, all prior permission settings with guild-based permissions will be invalidated. You will need to convert to the above system.
OWNERS
will also get removed, you will need to set owners through ?permissions add level owner 212931293123129
or any way listed above.
New Command
- A
?delete
command, which is an alternative to manually deleting a message. This command is created to no longer requires manage messages permission to recall thread messages.
Changed
- The help message no longer conceals inaccessible commands due to check failures.
Log Search Keys
Changed
- Logs search command will search through log keys as well now.
- For example,
?logs search e7499e82f8ff
.
Stable Release
What's new?
Stricter fallback genesis embed search.
Changed
How modmail checks if a channel is a thread:
- The bot first checks if the channel topic is in the format
User ID: xxxx
, this means it is a thread. - If a channel topic is not found, the bot searches through the message history of a channel to find the thread creation embed. This step should never yield a thread for a normal user, but in the case of another bot messing up the channel topic (happened to a user before) this extra step was added.
Stable Release
What's new?
Added a config option reply_without_command
which when present, enables the bot to forward any message sent in a thread channel to the recipient. (Replying without using a command)
To enable this functionality, do ?config set reply_without_command true
and to disable it, use ?config del reply_without_command
.
Changed
The move
command now only requires manage_messages
perms instead of manage_channels
Bug Fix
Join/Leave Message, Remove Modmail API
Changed
All support for Modmail API (api.modmail.tk) has terminated.
If you're still using api.modmail.tk, you will need to migrate to the self-hosted database
option ASAP. Your bot will not work unless you switch to the self-hosted option. Refer to the installation tutorial for information regarding self-hosted Modmail.
If a member leaves/joins (again) while they are a recipient of a thread, a message will be sent to notify you that this has occurred.
Emergency Patch
Fixed
- Emergency patch of a SyntaxError.