A plugin for Dragory's ModMail that allows users to open threads with reactions
Currently on Version 1.1
A full changelog can be found here.
Plugin written and maintained by DarkView (Dark#1010 on Discord)
Table of Contents:
Make sure you are running at least v3.2.0 of Modmail. in your config.ini file, create a new line and add
plugins[] = npm:MMPlugins/ReactionThreads
reactionThreads-ownerId = <yourUserId>
extraIntents[] = guildMessageReactions
to your config and replace <yourUserId> with your user ID. Only the person with this ID is allowed to add/remove reactions.
Grant the ModMail bot "Manage Message" permissions in any channel you want it to use reactions for, as it removes the reaction the user adds automatically.
You need to restart the bot in order for the plugin to be loaded!
In order for the bot to create threads through user reactions, you need to set up reactions first. See the Commands section below for information on how to do so.
Registered reactions are persistent between restarts, as long as you do not delete or move the ReactionThreadsData.json file created by the plugin.
The plugin is rather lenient regarding allowed reactions. As long as the bot is able to use the emoji, you are able to register it as a reaction.
It is not possible to create more than one thread per user, regardless of how it is created. If the user already has an active thread, the reaction will simply be removed again without anything happening.
In the case you run mutliple bot instances from the same folder, you can set the reactionThreads-suffix config option in your config.ini. This will append the given text to the ReactionThreadsData.json file so the different instances can use different reaction lists.
There are currently no known bugs.
If you have found a bug, please report it at the issues page for the plugin!
You can also find the plugin author (Dark#1010) on the official support discord in case you have any specific questions.
If you want to request or suggest a feature, open an issue on the plugins issue page!
In case the feature you want to request is outside of the scope of this plugin (anything not to do with reactions creating threads) please use the #plugin-requests channel on the official support discord.
Parameters in <> are required, parameters in [] optional.
Signature 1: !rtAdd <ChannelID> <MessageID> <Emoji> [CategoryID]
Signature 2: !rtAdd <ChannelID> <MessageID> <Emoji> <CategoryID> [PingRoleID]
This will register a new reaction and immediately activate it, making any reactions to it create a new thread.
ChannelIDhas to be the ID of the channel the message the reaction should be added to is in.MessageIDis the ID of the message in that channel.Emojiis just the emoji directly from the emoji picker without any changes.CategoryIDshould only be used if you want reactions to that message to be placed in a specific category.PingRoleIDcan only be used in conjunction withCategoryID. It allows you to set a role to be pinged when a thread is created with that specific reaction.
Signature: !rtRemove <ChannelID> <MessageID> <Emoji>
This will de-register an already existing reaction. All threads opened via the reaction remain open.
Takes the same arguments as !rtAdd but without the optional parameters, as that is not needed for reaction matching (cannot have the same emoji twice).
Table of Contents:
Plugin written and maintained by DarkView (Dark#1010 on Discord)