This is a beta release. It is not available on the Releases page and bugs are expected.
- Add support for Node.js 13
- Support for Node.js 14 is coming in a future update that will also drop Node.js 10 support.
This mirrors the
sqlite3library's version support.
- Support for Node.js 14 is coming in a future update that will also drop Node.js 10 support.
This mirrors the
- Log formatting is now more consistent and easier to parse with automated tools
- DM channel and message IDs are now stored
- Use
!loglink -vto view these in logs - Use
!dm_channel_idin an inbox thread to view the DM channel ID - DM channel and message IDs are primarily useful for Discord T&S reports
- Use
- Some code reorganisation related to threads and thread messages. If you have a plugin that interacts with Thread or ThreadMessage objects, test them before running this update in production!
- Fix crash with
responseMessageandcloseMessageintroduced in v2.30.0 (#369)
- The following config options now also support multi-line values:
responseMessagecloseMessagebotMentionResponsegreetingMessageaccountAgeDeniedMessagetimeOnServerDeniedMessage
- When the bot is mentioned on the main server, the log message about this now also includes a link to the message (#319)
- Fix error when supplying all config values from env variables without a config file
- Fix crash in update checker if the repository value in package.json is set to a GitHub repository without releases (this only applies to forks)
- Fix boolean values in
config.ininot being handled properly
- Default configuration format is now .ini
- Existing
config.jsonfiles will continue to work and will not be deprecated - This makes the default configuration format for the bot much more approachable than JSON
- Existing
- Config values can now also be loaded from environment variables (see Configuration for more details)
- New rewritten instructions for setting up and using the bot
- New easy-to-use
start.batfile for Windows - Update several package dependencies
- Fixed incompatibility with Node.js 10 versions prior to 10.9.0
- Fix error when saving attachments locally with
attachmentStorageset to"local"(default) when the bot's folder is on a different storage device than the system's temp folder - Add
attachmentsobject to the plugin API- This allows plugins to add new storage types via
attachments.addStorageType() - See the Plugins section in the README for more details
- This allows plugins to add new storage types via
- The
syncPermissionsOnMoveoption now defaults totrue, which should be more intuitive - Plugins: Plugin functions are no longer called with 4 arguments. Instead, the function is called with 1 argument,
which is an object that contains the previous 4 values as properties:
bot,knex,config,commands. This will make it easier to scale the plugin system in the future with new features. You can see an updated example in the README.
- The bot now waits for the main server(s) and inbox server to become available before initializing. This is a potential fix to #335. This should have little to no effect on smaller servers.
- The bot status ("Playing") is now reapplied hourly since the status can sometimes disappear
- Fix regression introduced in v2.24.0 where line breaks would get turned to spaces in replies and snippets (#304)
- Replace the internal command handler with a new one. This should be fairly thoroughly tested, but please report any issues you encounter!
- Plugins are now called with a fourth parameter that allows you to easily add specific types of commands
- Due to the command handler change, any calls to
bot.registerCommandshould be replaced with the new system
- Due to the command handler change, any calls to
- Switch to the new stable version of Eris (0.10.0) instead of the dev version
- Update Node.js version check at startup to require Node.js 10
- Updated required Node.js version in .nvmrc and README (v10 is now the minimum)
- Add update notifications. The bot will check for new versions every 12 hours and notify moderators at the top of new
modmail threads when there are new versions available. Can be disabled by setting the
updateNotificationsoption tofalse. New available versions are also shown in!version.- If you have forked the repository and want to check for updates in your own repository instead,
change the
repositoryvalue inpackage.json
- If you have forked the repository and want to check for updates in your own repository instead,
change the
- Add basic support for plugins. See the Plugins section in README for more information.
- Add support for snippet arguments. To use these, put {1}, {2}, etc. in the snippet text and they will be replaced by the given arguments when using the snippet.
- Add support for multiple
mentionRoleconfig option values in an array - Add
commandAliasesconfig option to set custom command aliases - Add support for timed blocks. Simply specify the duration as the last argument in
!blockor!unblock. - Add pagination to
!logs
- Add
guildGreetingsoption to allow configuring greeting messages on a per-server basis - Add
rolesInThreadHeaderoption to show the user's roles in the modmail thread's header
- Fix crash caused by Nitro Boosting notifications
- Update Eris to fix crashes with news channels and nitro boosting
- "Account age" and "time on server" requirements are now ignored when using
!newthread
- Add
requiredTimeOnServerandtimeOnServerDeniedMessageconfig options to restrict modmail from users who have just joined the server. Thanks @reboxer (#270)!
- Add
categoryAutomationoption to automate thread categories. Currently supported sub-options:newThread- same asnewThreadCategoryId, the default category for new threadsnewThreadFromGuild- default category on a per-guild basis, value is an object with guild IDs as keys and category IDs as values
- Threads should now include member information (nickname, joined at, etc.) more reliably
- Thread header now also includes the member's current voice channel, if any
- Add
attachmentStorageoption to control where attachments are saved. Currently supported:"local"(default) - Same as before: attachments are saved locally on the machine running the bot and served through the bot's web server"discord"- Attachments are saved on a special Discord channel specified by theattachmentStorageChannelIdoption
- Add
syncPermissionsOnMoveoption. When enabled, thread channel permissions are synced with the category when the thread is moved with!move. - Add support for scheduling
!suspend. Works the same way as with!close, just specify the time after the command. Can be cancelled with!suspend cancel. - Scheduled
!closecan now be silent - just addsilentas an argument to the command before or after the schedule time - The schedule time format for
!closeis now stricter and times with whitespace (e.g.2 h 30 m) no longer work. Use e.g.2h30minstead. !loglinkcan now be used in suspended threads- User can now be mentioned in
botMentionResponseby adding{userMention}to the response text. Thanks @reboxer (#225)! - Fixed a small mistake in README, thanks @GabrielLewis2 (#226)!
- Add
silentoption to!close(e.g.!close silent) to close threads without sending the specifiedcloseMessage - Update some package versions (may help with sqlite3 install issues)
- Add
mentionUserInThreadHeaderoption. When set totrue, mentions the thread's user in the thread header. Fixes #152. - Add
botMentionResponseoption. If set, the bot auto-responds to bot mentions with this message. Fixes #143. - Fix member info sometimes missing in thread header. Thanks @Akhawais (#136)!
- Add support for role and user IDs in inboxServerPermission instead of just permission names
- Allow specifying multiple values (an array) for inboxServerPermission. Members will be considered "staff" if they pass any of the values.
- Update Eris to 0.9.0, Knex to 0.15.2
- Add support for sending anonymous snippets. By default, you can do this by using
!!!instead of!!. Fixes #82. - Add
snippetPrefixAnonoption - Add
allowUserCloseoption. When set totrue, users can use the close command to close threads by themselves. - Fix
allowMovemissing from README. Thanks @AndreasGassmann (#126)!
- Add support for a .js config file (export config with
module.exports)
- Update several other packages as well
- Update
node-sqlite3dependency to hopefully fix installation issues on some setups
- Add
smallAttachmentLimitconfig option to control the max size of attachments forwarded byrelaySmallAttachmentsAsAttachments - Fix crash when
closeMessagefailed to send - Handle webserver errors gracefully
- Don't alert for main server pings if the pinger is a bot
- Changed
requiredAccountAgeto be in hours instead of days
- Added
requiredAccountAgeandaccountAgeDeniedMessageoptions for restricting how new accounts can message modmail
- Added
closeMessageoption. This option can be used to send a message to the user when their modmail thread is closed. - Documented
pingOnBotMentionoption
- Fixed greetings not being sent since multi-server support was added in 2.9.0
- Config files are now parsed using JSON5, allowing you to use comments, trailing commas, and other neat things in your config.json
- When using multiple main guilds, the originating guild name is now always included at the top of the thread (if possible). Previously, if the user that messaged modmail was on only one of the guilds, the guild name would not be shown at the top.
- Fixed crash when a user edited a message in their DMs with modmail without an open thread
- Small fixes to category name matching when using
!move - Fixed crash when the bot was unable to send an auto-response to a user
- Added option
pingOnBotMention(defaults totrue) that allows you to control whether staff are pinged when the bot is mentioned - Long messages are now chunked so they don't fail to send due to added length from e.g. user name
- Changed timed close default unit from seconds to minutes.
This means that doing e.g.
!close 30now closes the thread in 30 minutes, not seconds.
- Added
!alert
Using!alertin a modmail thread will ping you the next time the thread gets a new reply. Use!alert cancelto cancel.
- If using multiple main guilds, the originating server is now specified in bot mention notifications
- Added multi-server support.
Multi-server support allows you to set an array of ids in mainGuildId. Nickname and join date will be displayed for each main guild the user is in. - Information posted at the top of modmail threads now also includes time since the user joined the guild(s)
- Added
!id
!idposts the user ID of the current thread. Useful on mobile when you need to get the user ID. - Added
!newthread
!newthread <userid>opens a new thread with the specified user - Fixed a crash when the bot was unable to send a greeting message due to the user's privacy options
- Added a
!versioncommand for checking the version of the bot you're running
- Split more code from main.js to individual module files
- Warn the user if new dependencies haven't been installed
!closenow supportsdfor days in the delay!closeis now stricter about the time format
- Commands used in inbox threads are now saved in logs again
- Moved more of the code to individual plugin files
- Fix errors on first run after upgrading to v2.2.0
- Various other fixes
- Add thread suspending. A modmail thread can now be suspended with
!suspend. Suspended threads will function as closed until unsuspended with!unsuspend.
- Auto-close threads if their modmail channel is deleted
- Fixed incorrect default value for
mentionRole(wasnull, should've been"here")
- Added
mentionRoleconfiguration option (#59). This option can be used to set the role that is pinged when new threads are created or the bot is mentioned. See README for more details.
- Added the ability to schedule a thread to close by specifying a time after
!close, e.g.!close 1h. The scheduling is cancelled if a new message is sent to or received from the user.
- Added typing proxy (#48):
- If the
typingProxyconfig option is enabled, any time a user is typing to modmail in their DMs, the modmail thread will show the bot as "typing" - If the
typingProxyReverseconfig option is enabled, any time a moderator is typing in a modmail thread, the user will see the bot "typing" in their DMs
- If the
- The link to the current thread's log is no longer posted to the top of the thread. Use
!loglinkinstead.
- Rewrote large parts of the code to be more modular and maintainable. There may be some new bugs because of this - please report them through GitHub issues if you encounter any!
- Threads, logs, and snippets are now stored in an SQLite database. The bot will migrate old data on the first run.
- Small attachments (<2MB) from users can now be relayed as Discord attachments in the modmail thread with the
relaySmallAttachmentsAsAttachmentsconfig option. Logs will have the link as usual. - Fixed system messages like pins in DMs being relayed to the thread
- Fixed channels sometimes being created without a category even when
newThreadCategoryIdwas set - Removed timestamps from threads by default. Logs will still have accurate timestamps. Can be re-enabled with the
threadTimestampsconfig option. - Added
!movecommand to move threads between categories. Can be enabled with theallowMoveconfig option, disabled by default.
- Added
newThreadCategoryIdoption. This option can be set to a category ID to place all new threads in that category.
- Fixed crash when the bot was unable to find or create a modmail thread
- Reduced error log spam in case of network errors from Eris
- Fixed unintended error when a message was ignored due to an "accidental thread" word
- Added
logChannelIdoption - Some code clean-up. Please open an issue if you encounter any bugs!
- The bot now throws an error for unknown options in
config.json(assuming they're typos) and tells you if you haven't configured the token or mail guild id.
- Fixed user nicknames not showing in new threads
- The "manageRoles" permission is no longer required to use commands on the inbox server.
This can be configured with theinboxServerPermissionconfig option.
- Commands are now case-insensitive (so !close, !Close, and !CLOSE all work)
- The before/after prefixes in edit notifications are now the same length, making it easier to spot the edited part
- Non-ASCII names should now result in better channel names (not just "unknown")
- Identical edits are now ignored
- New thread notification (with @ here ping) is now posted in the thread instead of the inbox server default channel
- Thread close notifications no longer ping the user who closed the thread
- Received attachments are now only linked once the bot has saved them (should fix embeds)
- Replies now use your nickname, if any
- Several messages are now ignored for thread creation ("ok", "thanks", and similar)
- Logs from !logs are now sorted in descending order (newest first)
More info is now available at the beginning of modmail threads.
Major rewrite. Includes anonymous replies (!ar), stability improvements, and server greeting feature.