A collection of badly written plugins for Python Discord Modmail bot.

Installation

Make sure to set REGISTRY_PLUGINS_ONLY in your environment variables to False otherwise installation will fail.

[p]plugin install raidensakura/modmail-plugins/[plugin_name]@main
[p]plugin load raidensakura/modmail-plugins/[plugin_name]@main

List of Plugins

Name	Description
Logviewer	A modification of Jerrie-Aries' logviewer plugin with OAuth support and a log list page. To enable OAuth, make sure these variables exist in your environment: OAUTH2_CLIENT_ID - The ID of your bot OAUTH2_CLIENT_SECRET - Get this from the general information section of your bot app in the Discord dev portal OAUTH2_REDIRECT_URI - This will be equal to the URL of your log viewer app + /callback e.g. https://logwebsite.com/callback. You will need to add this same URL as a redirect URL in the OAuth2 section in the Discord dev portal. Lastly, add users or roles to whitelist to access the logs with [p]oauth whitelist @user/role
Say	A port of El Laggron's say cog for Red Discord bot with some incompatible features removed.
Video Preview	Bounty plugin made for neya. It simply sends a link of a video attachment inside the thread channel so it can be played within the client.

Contributing

This project has included pre-commit script that can automatically run black and ruff linter on every commit.

1. Install development dependencies.

   $ uv sync --dev

2. Run the pre-commit hook.

   $ uv run pre-commit

3. Install the pre-commit hook (Optional).

   $ uv run pre-commit install

Alternatively, you can also lint the codebase manually

$ uv run black .
$ uv run ruff format .

Credits

• modmail-dev for Modmail bot and parts of the OAuth codes.
• Jerrie-Aries for the original logviewer plugin.