next_bang cleanup (#293)

* next_bang cleanup

fix unused next_bang reference, added AttributeError exception catch when deleting next bang if message object loses guild attribute and becomes None

* version

Co-authored-by: aikaterna <20862007+aikaterna@users.noreply.github.com>

.gitignore

@@ -0,0 +1,129 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Sublime project files
+*.sublime-project
+*.sublime-workspace
+
+# PyCharm project files
+.idea/
+
+# VS Code project files
+.vscode/

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2016 
+Copyright (c) 2016-present aikaterna
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,3 +19,210 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+
+This product bundles methods from https://github.com/hizkifw/discord-tictactoe
+which are available under an Apache-2.0 license. This license only applies 
+to the ttt.py file within the ttt directory on this repository.
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2017-present hizkifw
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -1,36 +1,76 @@
 # aikaterna-cogs
-Cogs for Red-DiscordBot by Twentysix26.
+v3 Cogs for Red-DiscordBot by Twentysix26.
 
-autoeconomy - New users that join the server will be automatically given a bank account.
+adventure - Original concept & cog by locastan. My version is a collaboration between TrustyJAID, Draper, and myself and is now markedly different than locastan's version. The repo can be found on my repo page here on github.
 
-away - By Paddolicious#8880. Set and unset a user as being "away".
+away - Originally by Paddo, written for v3 by Axas, final tests by aikaterna, and large improvements by TrustyJAID. Set and unset a user as being "away", or other statuses.
 
-cah - Cards Against Humanity. A port of CorpBot's module: https://github.com/corpnewt/CorpBot.py
+blurplefy - Make an avatar or an image upload blurple for Discord's anniversaries.
+
+cah - Cards Against Humanity, played in DM's. This can rate limit large bots via the sheer number of messages sent. Install and use with caution on larger bots.
 
 chatchart - Generates a pie chart to display chat activity over the last 5000 messages. Requested by violetnyte.
 
-forwarding - Forwards DMs sent to the bot to the owner of the bot. A port of the forwarding module from: https://github.com/jacobcheatley/dankbot
+dadjokes - Another UltimatePancake cog. Get some dad jokes on command.
 
-hunting - By Paddolicious#8880. It hunts birds... and things that fly.
+dictionary - Define words and look up antonyms and synonyms. Originally by UltimatePancake.
 
-imgwelcome - Welcome users to your server with a customized image.
+discordexperiments - Create voice channel invites for various built-in apps. This is only for developers or for people that can read the code and assess the risk of using it.
 
-otherbot - Have multiple Red instances and want to know when one goes offline? Edit this cog and load it on your watcher bot.
+embedpeek - Take a closer look at or unpack embed content. This cog is mostly a developer tool.
 
-pug - Warcraft pug checker. A port of PugBot's module: https://github.com/reznok/PugBot
+hunting - A long overdue port of Paddo's v2 hunting game to v3.
 
-radio - A hidden unpublished gem from Paddo, with a couple edits. Plays http audio streams like icecast and mp3 streams.
+icyparser - Show icecast/shoutcast stream information. An audio addon cog to show the current stream info, or provide a url yourself.
 
-riot - an old Fredboat command, requested by Mewleficent.
+imgwelcome - Welcome users to your server(s) with an image. The repo can be found on my repo page here on github.
 
-seen - By Paddolicious#8880. Check when the user was last active on a server.
+inspirobot - Fetch "inspirational" messages from inspirobot.me with [p]inspireme.
 
-serverlimit - Limit the bot to joining servers with over 25 members.
+invites - Display invites that are available on the server and the information those invites contain. The bot must have the administrator permission granted on the guild to be able to use this cog.
 
+latex - A simple cog originally by Stevy for v2 that displayes LaTeX expressions in an image.
 
-The chatterbot cog that was previously on this repo has been removed in favor of: https://github.com/Nobleasskicker/GrandeCogs/tree/master/chat
+luigipoker - Play the Luigi Poker minigame from New Super Mario Brothers. Ported from the v2 version written by themario30.
 
-Q: Why do you have some of Paddo's cogs on your repo?
+massunban - Bot Admins or guild Administrators can use this tool to mass unban users via ban reason keywords, or mass unban everyone on the ban list.
-A: He recently made an announcement about finding a new home for a few cogs. I've picked up a couple and I welcome PRs or feature requests. I'm also intending to port these for Red v3 as I can.
 
-Feel free to join the server for these cogs if you'd like. https://discord.gg/th6eS3T
+noflippedtables - A v3 port of irdumb's v2 cog with a little extra surprise included. Unflip all the tables.
+
+otherbot - Alert a role when bot(s) go offline.
+
+partycrash - A port of Will's partycrash command from the v2 Admin cog. This cog will not generate invites, but will show already-existing invites that the bot has access to view.
+
+pingtime - Show all shards' pingtimes.
+
+pressf - A port/rewrite of NekoTony's v2 pressf cog. Pay your respects by pressing F.
+
+quiz - A kahoot-like trivia game. Originally by Keane for Red v2.
+
+reminder - A continued fork of ZeLarpMaster's reminder cog. This cog is licensed under the GPL-3.0 License.
+
+rndstatus - A v3 port of Twentysix's rndstatus cog with a couple extra settings.
+
+rss - Will's RSS cog ported for v3 with a lot of extra bells and whistles.
+
+snacktime - A v3 port of irdumb's snacktime cog. Now with friends!
+
+timezone - A v3 port of Fishyfing's timezone cog with a few improvements.
+
+trackdecoder - A dev utility cog to resolve Lavalink Track information from a b64 string.
+
+trickortreat - A trick or treat-based competitive candy eating game with a leaderboard and other fun commands like stealing candy from guildmates.
+
+tools - A collection of mod and admin tools, ported from my v2 version. Sitryk is responsible for a lot of the code in tools... thanks for the help with this cog.
+
+ttt - A Tic Tac Toe cog originally for Red V2 by HizikiFW. This cog is licensed under the Apache-2.0 license.
+
+urlfetch - Fetch text from a URL. Mainly used for simple text API queries (not JSON).
+
+voicelogs - A record of people's time spent in voice channels by ZeLarpMaster for v2, and ported here for v3 use. This cog is licensed under the GPL-3.0 License.
+
+wolfram - A v3 port of Paddo's abandoned Wolfram Alpha cog.
+
+youtube - A v3 port of Paddo's youtube search cog for v2.
+
+Support for these cogs is via opened issues on the appropriate repo or in the Red - Cog Support server at https://discord.gg/GET4DVk, in the support_aikaterna-cogs channel.

autoeconomy/autoeconomy.py

@@ -1,129 +0,0 @@
-import asyncio
-import discord
-import os
-from __main__ import send_cmd_help
-from cogs.utils import checks
-from cogs.utils.dataIO import dataIO
-from copy import deepcopy
-from discord.ext import commands
-
-default_settings = {"CHANNEL": None,
-                    "DEBUG": False,
-                    "TOGGLE": False,
-                    }
-
-
-class AutoEconomy:
-    """Auto-registers new users to the bank. Must have Economy loaded."""
-
-    def __init__(self, bot):
-        self.bot = bot
-        self.settings = dataIO.load_json('data/autoeconomy/settings.json')
-        self.banksettings = dataIO.load_json('data/economy/settings.json')
-        self.version = "0.1.1b"
-
-    async def save_settings(self):
-        dataIO.save_json('data/autoeconomy/settings.json', self.settings)
-
-    async def _data_check(self, ctx):
-        server = ctx.message.server
-        if server.id not in self.settings:
-            self.settings[server.id] = deepcopy(default_settings)
-            self.settings[server.id]["CHANNEL"] = ctx.message.channel.id
-            await self.save_settings()
-        econ_cog = self.bot.get_cog('Economy')
-        if not econ_cog:
-            await self.bot.say("You must have Economy loaded to use this cog. \nAny settings saved will not work until the cog is loaded.")
-            return
-
-    @checks.admin_or_permissions(manage_server=True)
-    @commands.group(pass_context=True)
-    async def autoeconomy(self, ctx):
-        """Configuration options for auto-registering Economy accounts."""
-        if ctx.invoked_subcommand is None:
-            await send_cmd_help(ctx)
-            return
-
-    @autoeconomy.command(pass_context=True, name="debug", no_pm=True)
-    async def autoeconomy_debug(self, ctx):
-        """Toggle autoeconomy debug messages."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]["DEBUG"] = not self.settings[server.id]["DEBUG"]
-        if self.settings[server.id]["DEBUG"]:
-            await self.bot.say("Debug messages on.")
-        else:
-            await self.bot.say("Debug messages off.")
-        await self.save_settings()
-
-    @autoeconomy.command(pass_context=True, name="channel", no_pm=True)
-    async def autoeconomy_channel(self, ctx, channel: discord.Channel):
-        """Set a channel for the debug messages."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        if not server.me.permissions_in(channel).send_messages:
-            await self.bot.say("No permissions to speak in that channel.")
-            return
-        self.settings[server.id]["CHANNEL"] = channel.id
-        await self.save_settings()
-        await self.bot.send_message(channel, "This channel will be used for debug messages.")
-
-    @autoeconomy.command(pass_context=True, name="toggle", no_pm=True)
-    async def autoeconomy_toggle(self, ctx):
-        """Toggle autoeconomy on the server."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]["TOGGLE"] = not self.settings[server.id]["TOGGLE"]
-        if self.settings[server.id]["TOGGLE"]:
-            await self.bot.say("New users will automatically be registered for a bank account.")
-        else:
-            await self.bot.say("No longer auto-registering new users.")
-        await self.save_settings()
-
-    @autoeconomy.command(name="version", pass_context=True, hidden=True)
-    async def autoeconomy_version(self):
-        """Displays the autoeconomy version."""
-        await self.bot.say("autoeconomy version {}.".format(self.version))
-
-    async def on_member_join(self, member):
-        server = member.server
-        if server.id not in self.settings:
-            self.settings[server.id] = deepcopy(default_settings)
-            await self.save_settings()
-        if not self.settings[server.id]["TOGGLE"]:
-            return
-        channel = self.settings[server.id]["CHANNEL"]
-        channel_object = self.bot.get_channel(channel)
-        econ_cog = self.bot.get_cog('Economy')
-        if not econ_cog:
-            return
-        bank = self.bot.get_cog('Economy').bank
-        try:
-            bank.create_account(member)
-        except Exception:
-            if self.settings[server.id]["DEBUG"]:
-                await self.bot.send_message(channel_object, "Economy account already exists for {}.".format(member.name))
-                return
-        if self.banksettings[server.id]["REGISTER_CREDITS"]:
-            reg_credits = self.banksettings[server.id]["REGISTER_CREDITS"]
-            bank.deposit_credits(member, reg_credits)
-            if self.settings[server.id]["DEBUG"]:
-                await self.bot.send_message(channel_object, "Bank account opened for {} and initial credits given.".format(member.name))
-                return
-
-
-def check_folders():
-    if not os.path.exists('data/autoeconomy/'):
-        os.mkdir('data/autoeconomy/')
-
-
-def check_files():
-    if not dataIO.is_valid_json('data/autoeconomy/settings.json'):
-        defaults = {}
-        dataIO.save_json('data/autoeconomy/settings.json', defaults)
-
-
-def setup(bot):
-    check_folders()
-    check_files()
-    bot.add_cog(AutoEconomy(bot))

autoeconomy/info.json

@@ -1,8 +0,0 @@
-{
-    "AUTHOR" : "aikaterna",
-    "INSTALL_MSG" : "Use [p]autoeconomy to change settings.",
-    "NAME" : "autoeconomy",
-    "SHORT" : "Autoregister new users to the bot bank on server join.",
-    "DESCRIPTION" : "Auto-registers new users to the bot bank on server join. You must have the Economy cog loaded for this cog to work.",
-    "TAGS": ["bank", "economy", "register"]
-}

away/__init__.py

@@ -0,0 +1,16 @@
+from .away import Away
+
+__red_end_user_data_statement__ = (
+    "This cog stores data provided by users "
+    "for the express purpose of redisplaying. "
+    "It does not store user data which was not "
+    "provided through a command. "
+    "Users may remove their own content "
+    "without making a data removal request. "
+    "This cog does not support data requests, "
+    "but will respect deletion requests."
+)
+
+
+def setup(bot):
+    bot.add_cog(Away(bot))

away/away.py

@@ -1,88 +1,673 @@
-import os
 import discord
-from .utils import checks
+from redbot.core import Config, commands, checks
-from discord.ext import commands
+from typing import Optional, Literal
-from cogs.utils.dataIO import dataIO
+import datetime
+import re
+
+IMAGE_LINKS = re.compile(r"(http[s]?:\/\/[^\"\']*\.(?:png|jpg|jpeg|gif|png))")
 
 
-class Away:
+class Away(commands.Cog):
     """Le away cog"""
+
+    default_global_settings = {"ign_servers": []}
+    default_guild_settings = {"TEXT_ONLY": False, "BLACKLISTED_MEMBERS": []}
+    default_user_settings = {
+        "MESSAGE": False,
+        "IDLE_MESSAGE": False,
+        "DND_MESSAGE": False,
+        "OFFLINE_MESSAGE": False,
+        "GAME_MESSAGE": {},
+        "STREAMING_MESSAGE": False,
+        "LISTENING_MESSAGE": False
+    }
+
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        await self.config.user_from_id(user_id).clear()
+
     def __init__(self, bot):
         self.bot = bot
-        self.data = dataIO.load_json('data/away/away.json')
+        self.config = Config.get_conf(self, 8423491260, force_registration=True)
+        self.config.register_global(**self.default_global_settings)
+        self.config.register_guild(**self.default_guild_settings)
+        self.config.register_user(**self.default_user_settings)
 
-    async def listener(self, message):
+    def _draw_play(self, song):
-        tmp = {}
+        song_start_time = song.start
-        server = message.server
+        total_time = song.duration
-        if server.id not in self.data:
+        current_time = datetime.datetime.utcnow()
-            for mention in message.mentions:
+        elapsed_time = current_time - song_start_time
-                tmp[mention] = True
+        sections = 12
-            if message.author.id != self.bot.user.id:
+        loc_time = round((elapsed_time / total_time) * sections)  # 10 sections
-                for author in tmp:
+
-                    if author.id in self.data:
+        bar_char = "\N{BOX DRAWINGS HEAVY HORIZONTAL}"
-                        try:
+        seek_char = "\N{RADIO BUTTON}"
-                            avatar = author.avatar_url if author.avatar else author.default_avatar_url
+        play_char = "\N{BLACK RIGHT-POINTING TRIANGLE}"
-                            if self.data[author.id]['MESSAGE']:
+        msg = "\n" + play_char + " "
-                                em = discord.Embed(description=self.data[author.id]['MESSAGE'], color=discord.Color.blue())
+
-                                em.set_author(name='{} is currently away'.format(author.display_name), icon_url=avatar)
+        for i in range(sections):
+            if i == loc_time:
+                msg += seek_char
             else:
-                                em = discord.Embed(color=discord.Color.blue())
+                msg += bar_char
-                                em.set_author(name='{} is currently away'.format(author.display_name), icon_url=avatar)
+
-                            await self.bot.send_message(message.channel, embed=em)
+        msg += " `{:.7}`/`{:.7}`".format(str(elapsed_time), str(total_time))
-                        except:
+        return msg
-                            if self.data[author.id]['MESSAGE']:
+
-                                msg = '{} is currently away and has set the following message: `{}`'.format(author.display_name, self.data[author.id]['MESSAGE'])
+    async def make_embed_message(self, author, message, state=None):
+        """
+            Makes the embed reply
+        """
+        avatar = author.avatar_url_as()  # This will return default avatar if no avatar is present
+        color = author.color
+        if message:
+            link = IMAGE_LINKS.search(message)
+            if link:
+                message = message.replace(link.group(0), " ")
+        if state == "away":
+            em = discord.Embed(description=message, color=color)
+            em.set_author(name=f"{author.display_name} is currently away", icon_url=avatar)
+        elif state == "idle":
+            em = discord.Embed(description=message, color=color)
+            em.set_author(name=f"{author.display_name} is currently idle", icon_url=avatar)
+        elif state == "dnd":
+            em = discord.Embed(description=message, color=color)
+            em.set_author(name=f"{author.display_name} is currently do not disturb", icon_url=avatar)
+        elif state == "offline":
+            em = discord.Embed(description=message, color=color)
+            em.set_author(name=f"{author.display_name} is currently offline", icon_url=avatar)
+        elif state == "gaming":
+            em = discord.Embed(description=message, color=color)
+            em.set_author(
+                name=f"{author.display_name} is currently playing {author.activity.name}", icon_url=avatar,
+            )
+            em.title = getattr(author.activity, "details", None)
+            thumbnail = getattr(author.activity, "large_image_url", None)
+            if thumbnail:
+                em.set_thumbnail(url=thumbnail)
+        elif state == "gamingcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.playing]
+            em = discord.Embed(description=message, color=color)
+            em.set_author(
+                name=f"{author.display_name} is currently playing {status[0].name}", icon_url=avatar,
+            )
+            em.title = getattr(status[0], "details", None)
+            thumbnail = getattr(status[0], "large_image_url", None)
+            if thumbnail:
+                em.set_thumbnail(url=thumbnail)
+        elif state == "listening":
+            em = discord.Embed(color=author.activity.color)
+            url = f"https://open.spotify.com/track/{author.activity.track_id}"
+            artist_title = f"{author.activity.title} by " + ", ".join(
+                a for a in author.activity.artists
+            )
+            limit = 256 - (
+                len(author.display_name) + 27
+            )  # incase we go over the max allowable size
+            em.set_author(
+                name=f"{author.display_name} is currently listening to",
+                icon_url=avatar,
+                url=url,
+            )
+            em.description = (
+                f"{message}\n "
+                f"[{artist_title}]({url})\n"
+                f"{self._draw_play(author.activity)}"
+            )
+
+            em.set_thumbnail(url=author.activity.album_cover_url)
+        elif state == "listeningcustom":
+            activity = [c for c in author.activities if c.type == discord.ActivityType.listening]
+            em = discord.Embed(color=activity[0].color)
+            url = f"https://open.spotify.com/track/{activity[0].track_id}"
+            artist_title = f"{activity[0].title} by " + ", ".join(a for a in activity[0].artists)
+            limit = 256 - (len(author.display_name) + 27)
+            em.set_author(
+                name=f"{author.display_name} is currently listening to",
+                icon_url=avatar,
+                url=url
+            )
+            em.description = (
+                f"{message}\n "
+                f"[{artist_title}]({url})\n"
+                f"{self._draw_play(activity[0])}"
+            )
+            em.set_thumbnail(url=activity[0].album_cover_url)
+        elif state == "streaming":
+            color = int("6441A4", 16)
+            em = discord.Embed(color=color)
+            em.description = message + "\n" + author.activity.url
+            em.title = getattr(author.activity, "details", None)
+            em.set_author(
+                name=f"{author.display_name} is currently streaming {author.activity.name}", icon_url=avatar,
+            )
+        elif state == "streamingcustom":
+            activity = [c for c in author.activities if c.type == discord.ActivityType.streaming]
+            color = int("6441A4", 16)
+            em = discord.Embed(color=color)
+            em.description = message + "\n" + activity[0].url
+            em.title = getattr(author.activity, "details", None)
+            em.set_author(
+                name=f"{author.display_name} is currently streaming {activity[0].name}", icon_url=avatar,
+            )
         else:
-                                msg = '{} is currently away'.format(author.display_name)
+            em = discord.Embed(color=color)
-                            await self.bot.send_message(message.channel, msg)
+            em.set_author(name="{} is currently away".format(author.display_name), icon_url=avatar)
+        if link and state not in ["listening", "listeningcustom", "gaming"]:
+            em.set_image(url=link.group(0))
+        return em
 
-    @commands.command(pass_context=True, name="away")
+    async def find_user_mention(self, message):
-    async def _away(self, context, *message: str):
+        """
-        """Tell the bot you're away or back."""
+            Replaces user mentions with their username
-        author = context.message.author
+        """
-        if author.id in self.data:
+        for word in message.split():
-            del self.data[author.id]
+            match = re.search(r"<@!?([0-9]+)>", word)
-            msg = 'You\'re now back.'
+            if match:
+                user = await self.bot.fetch_user(int(match.group(1)))
+                message = re.sub(match.re, "@" + user.name, message)
+        return message
+
+    async def make_text_message(self, author, message, state=None):
+        """
+            Makes the message to display if embeds aren't available
+        """
+        message = await self.find_user_mention(message)
+
+        if state == "away":
+            msg = f"{author.display_name} is currently away"
+        elif state == "idle":
+            msg = f"{author.display_name} is currently idle"
+        elif state == "dnd":
+            msg = f"{author.display_name} is currently do not disturb"
+        elif state == "offline":
+            msg = f"{author.display_name} is currently offline"
+        elif state == "gaming":
+            msg = f"{author.display_name} is currently playing {author.activity.name}"
+        elif state == "gamingcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.playing]
+            msg = f"{author.display_name} is currently playing {status[0].name}"
+        elif state == "listening":
+            artist_title = f"{author.activity.title} by " + ", ".join(a for a in author.activity.artists)
+            currently_playing = self._draw_play(author.activity)
+            msg = f"{author.display_name} is currently listening to {artist_title}\n{currently_playing}"
+        elif state == "listeningcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.listening]
+            artist_title = f"{status[0].title} by " + ", ".join(a for a in status[0].artists)
+            currently_playing = self._draw_play(status[0])
+            msg = f"{author.display_name} is currently listening to {artist_title}\n{currently_playing}"
+        elif state == "streaming":
+            msg = f"{author.display_name} is currently streaming at {author.activity.url}"
+        elif state == "streamingcustom":
+            status = [c for c in author.activities if c.type == discord.ActivityType.streaming]
+            msg = f"{author.display_name} is currently streaming at {status[0].url}"
         else:
-            self.data[context.message.author.id] = {}
+            msg = f"{author.display_name} is currently away"
-            if len(str(message)) < 256:
+
-                self.data[context.message.author.id]['MESSAGE'] = ' '.join(context.message.clean_content.split()[1:])
+        if message != " " and state != "listeningcustom":
+            msg += f" and has set the following message: `{message}`"
+        elif message != " " and state == "listeningcustom":
+            msg += f"\n\nCustom message: `{message}`"
+
+        return msg
+
+    async def is_mod_or_admin(self, member: discord.Member):
+        guild = member.guild
+        if member == guild.owner:
+            return True
+        if await self.bot.is_owner(member):
+            return True
+        if await self.bot.is_admin(member):
+            return True
+        if await self.bot.is_mod(member):
+            return True
+        return False
+
+    @commands.Cog.listener()
+    async def on_message(self, message: discord.Message):
+        guild = message.guild
+        if not guild or not message.mentions or message.author.bot:
+            return
+        if not message.channel.permissions_for(guild.me).send_messages:
+            return
+
+        blocked_guilds = await self.config.ign_servers()
+        guild_config = await self.config.guild(guild).all()
+        for author in message.mentions:
+            if (guild.id in blocked_guilds and not await self.is_mod_or_admin(author)) or author.id in guild_config["BLACKLISTED_MEMBERS"]:
+                continue
+            user_data = await self.config.user(author).all()
+            embed_links = message.channel.permissions_for(guild.me).embed_links
+
+            away_msg = user_data["MESSAGE"]
+            # Convert possible `delete_after` of < 5s of before PR#212
+            if isinstance(away_msg, list) and away_msg[1] is not None and away_msg[1] < 5:
+                await self.config.user(author).MESSAGE.set((away_msg[0], 5))
+                away_msg = away_msg[0], 5
+            if away_msg:
+                if type(away_msg) in [tuple, list]:
+                    # This is just to keep backwards compatibility
+                    away_msg, delete_after = away_msg
                 else:
-                self.data[context.message.author.id]['MESSAGE'] = True
+                    delete_after = None
-            msg = 'You\'re now set as away.'
+                if embed_links and not guild_config["TEXT_ONLY"]:
-        dataIO.save_json('data/away/away.json', self.data)
+                    em = await self.make_embed_message(author, away_msg, "away")
-        await self.bot.say(msg)
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
-
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
-    @commands.command(pass_context=True, name="toggleaway")
+                    msg = await self.make_text_message(author, away_msg, "away")
-    @checks.mod_or_permissions(administrator=True)
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
-    async def _ignore(self, context):
+                continue
-        server = context.message.server
+            idle_msg = user_data["IDLE_MESSAGE"]
-        if server.id in self.data:
+            # Convert possible `delete_after` of < 5s of before PR#212
-            del self.data[server.id]
+            if isinstance(idle_msg, list) and idle_msg[1] is not None and idle_msg[1] < 5:
-            message = 'Not ignoring this server anymore.'
+                await self.config.user(author).IDLE_MESSAGE.set((idle_msg[0], 5))
+                idle_msg = idle_msg[0], 5
+            if idle_msg and author.status == discord.Status.idle:
+                if type(idle_msg) in [tuple, list]:
+                    idle_msg, delete_after = idle_msg
                 else:
-            self.data[server.id] = True
+                    delete_after = None
-            message = 'Ignoring this server.'
+                if embed_links and not guild_config["TEXT_ONLY"]:
-        dataIO.save_json('data/away/away.json', self.data)
+                    em = await self.make_embed_message(author, idle_msg, "idle")
-        await self.bot.say(message)
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, idle_msg, "idle")
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                continue
+            dnd_msg = user_data["DND_MESSAGE"]
+            # Convert possible `delete_after` of < 5s of before PR#212
+            if isinstance(dnd_msg, list) and dnd_msg[1] is not None and dnd_msg[1] < 5:
+                await self.config.user(author).DND_MESSAGE.set((dnd_msg[0], 5))
+                dnd_msg = dnd_msg[0], 5
+            if dnd_msg and author.status == discord.Status.dnd:
+                if type(dnd_msg) in [tuple, list]:
+                    dnd_msg, delete_after = dnd_msg
+                else:
+                    delete_after = None
+                if embed_links and not guild_config["TEXT_ONLY"]:
+                    em = await self.make_embed_message(author, dnd_msg, "dnd")
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, dnd_msg, "dnd")
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                continue
+            offline_msg = user_data["OFFLINE_MESSAGE"]
+            # Convert possible `delete_after` of < 5s of before PR#212
+            if isinstance(offline_msg, list) and offline_msg[1] is not None and offline_msg[1] < 5:
+                await self.config.user(author).OFFLINE_MESSAGE.set((offline_msg[0], 5))
+                offline_msg = offline_msg[0], 5
+            if offline_msg and author.status == discord.Status.offline:
+                if type(offline_msg) in [tuple, list]:
+                    offline_msg, delete_after = offline_msg
+                else:
+                    delete_after = None
+                if embed_links and not guild_config["TEXT_ONLY"]:
+                    em = await self.make_embed_message(author, offline_msg, "offline")
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, offline_msg, "offline")
+                    await message.channel.send(msg, delete_after=delete_after)
+                continue
+            streaming_msg = user_data["STREAMING_MESSAGE"]
+            # Convert possible `delete_after` of < 5s of before PR#212
+            if isinstance(streaming_msg, list) and streaming_msg[1] is not None and streaming_msg[1] < 5:
+                await self.config.user(author).STREAMING_MESSAGE.set((streaming_msg[0], 5))
+                streaming_msg = streaming_msg[0], 5
+            if streaming_msg and type(author.activity) is discord.Streaming:
+                streaming_msg, delete_after = streaming_msg
+                if embed_links and not guild_config["TEXT_ONLY"]:
+                    em = await self.make_embed_message(author, streaming_msg, "streaming")
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, streaming_msg, "streaming")
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                continue
+            if streaming_msg and type(author.activity) is discord.CustomActivity:
+                stream_status = [c for c in author.activities if c.type == discord.ActivityType.streaming]
+                if not stream_status:
+                    continue
+                streaming_msg, delete_after = streaming_msg
+                if embed_links and not guild_config["TEXT_ONLY"]:
+                    em = await self.make_embed_message(author, streaming_msg, "streamingcustom")
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, streaming_msg, "streamingcustom")
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                continue
+            listening_msg = user_data["LISTENING_MESSAGE"]
+            # Convert possible `delete_after` of < 5s of before PR#212
+            if isinstance(listening_msg, list) and listening_msg[1] is not None and listening_msg[1] < 5:
+                await self.config.user(author).LISTENING_MESSAGE.set((listening_msg[0], 5))
+                listening_msg = listening_msg[0], 5
+            if listening_msg and type(author.activity) is discord.Spotify:
+                listening_msg, delete_after = listening_msg
+                if embed_links and not guild_config["TEXT_ONLY"]:
+                    em = await self.make_embed_message(author, listening_msg, "listening")
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, listening_msg, "listening")
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                continue
+            if listening_msg and type(author.activity) is discord.CustomActivity:
+                listening_status = [c for c in author.activities if c.type == discord.ActivityType.listening]
+                if not listening_status:
+                    continue
+                listening_msg, delete_after = listening_msg
+                if embed_links and not guild_config["TEXT_ONLY"]:
+                    em = await self.make_embed_message(author, listening_msg, "listeningcustom")
+                    await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                    msg = await self.make_text_message(author, listening_msg, "listeningcustom")
+                    await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                continue
+            gaming_msgs = user_data["GAME_MESSAGE"]
+            # Convert possible `delete_after` of < 5s of before PR#212
+            if isinstance(gaming_msgs, list) and gaming_msgs[1] is not None and gaming_msgs[1] < 5:
+                await self.config.user(author).GAME_MESSAGE.set((gaming_msgs[0], 5))
+                gaming_msgs = gaming_msgs[0], 5
+            if gaming_msgs and type(author.activity) in [discord.Game, discord.Activity]:
+                for game in gaming_msgs:
+                    if game in author.activity.name.lower():
+                        game_msg, delete_after = gaming_msgs[game]
+                        if embed_links and not guild_config["TEXT_ONLY"]:
+                            em = await self.make_embed_message(author, game_msg, "gaming")
+                            await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                            break  # Let's not accidentally post more than one
+                        elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                            msg = await self.make_text_message(author, game_msg, "gaming")
+                            await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                            break
+            if gaming_msgs and type(author.activity) is discord.CustomActivity:
+                game_status = [c for c in author.activities if c.type == discord.ActivityType.playing]
+                if not game_status:
+                    continue
+                for game in gaming_msgs:
+                    if game in game_status[0].name.lower():
+                        game_msg, delete_after = gaming_msgs[game]
+                        if embed_links and not guild_config["TEXT_ONLY"]:
+                            em = await self.make_embed_message(author, game_msg, "gamingcustom")
+                            await message.channel.send(embed=em, delete_after=delete_after, reference=message, mention_author=False)
+                            break  # Let's not accidentally post more than one
+                        elif (embed_links and guild_config["TEXT_ONLY"]) or not embed_links:
+                            msg = await self.make_text_message(author, game_msg, "gamingcustom")
+                            await message.channel.send(msg, delete_after=delete_after, reference=message, mention_author=False)
+                            break
 
+    @commands.command(name="away")
+    async def away_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
+        """
+        Tell the bot you're away or back.
 
-def check_folder():
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
-    if not os.path.exists('data/away'):
+        `message` The custom message to display when you're mentioned
-        print('Creating data/away folder...')
+        """
-        os.makedirs('data/away')
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
 
+        author = ctx.message.author
+        mess = await self.config.user(author).MESSAGE()
+        if mess:
+            await self.config.user(author).MESSAGE.set(False)
+            msg = "You're now back."
+        else:
+            if message is None:
+                await self.config.user(author).MESSAGE.set((" ", delete_after))
+            else:
+                await self.config.user(author).MESSAGE.set((message, delete_after))
+            msg = "You're now set as away."
+        await ctx.send(msg)
 
-def check_file():
+    @commands.command(name="idle")
-    f = 'data/away/away.json'
+    async def idle_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
-    if not dataIO.is_valid_json(f):
+        """
-        dataIO.save_json(f, {})
+        Set an automatic reply when you're idle.
-        print('Creating default away.json...')
 
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
+        `message` The custom message to display when you're mentioned
+        """
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
 
-def setup(bot):
+        author = ctx.message.author
-    check_folder()
+        mess = await self.config.user(author).IDLE_MESSAGE()
-    check_file()
+        if mess:
-    n = Away(bot)
+            await self.config.user(author).IDLE_MESSAGE.set(False)
-    bot.add_listener(n.listener, 'on_message')
+            msg = "The bot will no longer reply for you when you're idle."
-    bot.add_cog(n)
+        else:
+            if message is None:
+                await self.config.user(author).IDLE_MESSAGE.set((" ", delete_after))
+            else:
+                await self.config.user(author).IDLE_MESSAGE.set((message, delete_after))
+            msg = "The bot will now reply for you when you're idle."
+        await ctx.send(msg)
+
+    @commands.command(name="offline")
+    async def offline_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
+        """
+        Set an automatic reply when you're offline.
+
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
+        `message` The custom message to display when you're mentioned
+        """
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
+
+        author = ctx.message.author
+        mess = await self.config.user(author).OFFLINE_MESSAGE()
+        if mess:
+            await self.config.user(author).OFFLINE_MESSAGE.set(False)
+            msg = "The bot will no longer reply for you when you're offline."
+        else:
+            if message is None:
+                await self.config.user(author).OFFLINE_MESSAGE.set((" ", delete_after))
+            else:
+                await self.config.user(author).OFFLINE_MESSAGE.set((message, delete_after))
+            msg = "The bot will now reply for you when you're offline."
+        await ctx.send(msg)
+
+    @commands.command(name="dnd", aliases=["donotdisturb"])
+    async def donotdisturb_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
+        """
+        Set an automatic reply when you're dnd.
+
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
+        `message` The custom message to display when you're mentioned
+        """
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
+
+        author = ctx.message.author
+        mess = await self.config.user(author).DND_MESSAGE()
+        if mess:
+            await self.config.user(author).DND_MESSAGE.set(False)
+            msg = "The bot will no longer reply for you when you're set to do not disturb."
+        else:
+            if message is None:
+                await self.config.user(author).DND_MESSAGE.set((" ", delete_after))
+            else:
+                await self.config.user(author).DND_MESSAGE.set((message, delete_after))
+            msg = "The bot will now reply for you when you're set to do not disturb."
+        await ctx.send(msg)
+
+    @commands.command(name="streaming")
+    async def streaming_(self, ctx, delete_after: Optional[int] = None, *, message: str = None):
+        """
+        Set an automatic reply when you're streaming.
+
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
+        `message` The custom message to display when you're mentioned
+        """
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
+
+        author = ctx.message.author
+        mess = await self.config.user(author).STREAMING_MESSAGE()
+        if mess:
+            await self.config.user(author).STREAMING_MESSAGE.set(False)
+            msg = "The bot will no longer reply for you when you're mentioned while streaming."
+        else:
+            if message is None:
+                await self.config.user(author).STREAMING_MESSAGE.set((" ", delete_after))
+            else:
+                await self.config.user(author).STREAMING_MESSAGE.set((message, delete_after))
+            msg = "The bot will now reply for you when you're mentioned while streaming."
+        await ctx.send(msg)
+
+    @commands.command(name="listening")
+    async def listening_(self, ctx, delete_after: Optional[int] = None, *, message: str = " "):
+        """
+        Set an automatic reply when you're listening to Spotify.
+
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
+        `message` The custom message to display when you're mentioned
+        """
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
+
+        author = ctx.message.author
+        mess = await self.config.user(author).LISTENING_MESSAGE()
+        if mess:
+            await self.config.user(author).LISTENING_MESSAGE.set(False)
+            msg = "The bot will no longer reply for you when you're mentioned while listening to Spotify."
+        else:
+            await self.config.user(author).LISTENING_MESSAGE.set((message, delete_after))
+            msg = "The bot will now reply for you when you're mentioned while listening to Spotify."
+        await ctx.send(msg)
+
+    @commands.command(name="gaming")
+    async def gaming_(self, ctx, game: str, delete_after: Optional[int] = None, *, message: str = None):
+        """
+        Set an automatic reply when you're playing a specified game.
+
+        `game` The game you would like automatic responses for
+        `delete_after` Optional seconds to delete the automatic reply. Must be minimum 5 seconds
+        `message` The custom message to display when you're mentioned
+
+        Use "double quotes" around a game's name if it is more than one word.
+        """
+        if delete_after is not None and delete_after < 5:
+            return await ctx.send("Please set a time longer than 5 seconds for the `delete_after` argument")
+
+        author = ctx.message.author
+        mess = await self.config.user(author).GAME_MESSAGE()
+        if game.lower() in mess:
+            del mess[game.lower()]
+            await self.config.user(author).GAME_MESSAGE.set(mess)
+            msg = f"The bot will no longer reply for you when you're playing {game}."
+        else:
+            if message is None:
+                mess[game.lower()] = (" ", delete_after)
+            else:
+                mess[game.lower()] = (message, delete_after)
+            await self.config.user(author).GAME_MESSAGE.set(mess)
+            msg = f"The bot will now reply for you when you're playing {game}."
+        await ctx.send(msg)
+
+    @commands.command(name="toggleaway")
+    @commands.guild_only()
+    @checks.admin_or_permissions(administrator=True)
+    async def _ignore(self, ctx, member: discord.Member=None):
+        """
+        Toggle away messages on the whole server or a specific guild member.
+
+        Mods, Admins and Bot Owner are immune to this.
+        """
+        guild = ctx.message.guild
+        if member:
+            bl_mems = await self.config.guild(guild).BLACKLISTED_MEMBERS()
+            if member.id not in bl_mems:
+                bl_mems.append(member.id)
+                await self.config.guild(guild).BLACKLISTED_MEMBERS.set(bl_mems)
+                msg = f"Away messages will not appear when {member.display_name} is mentioned in this guild."
+                await ctx.send(msg)
+            elif member.id in bl_mems:
+                bl_mems.remove(member.id)
+                await self.config.guild(guild).BLACKLISTED_MEMBERS.set(bl_mems)
+                msg = f"Away messages will appear when {member.display_name} is mentioned in this guild."
+                await ctx.send(msg)
+            return
+        if guild.id in (await self.config.ign_servers()):
+            guilds = await self.config.ign_servers()
+            guilds.remove(guild.id)
+            await self.config.ign_servers.set(guilds)
+            message = "Not ignoring this guild anymore."
+        else:
+            guilds = await self.config.ign_servers()
+            guilds.append(guild.id)
+            await self.config.ign_servers.set(guilds)
+            message = "Ignoring this guild."
+        await ctx.send(message)
+
+    @commands.command()
+    @commands.guild_only()
+    @checks.admin_or_permissions(administrator=True)
+    async def awaytextonly(self, ctx):
+        """
+        Toggle forcing the guild's away messages to be text only.
+
+        This overrides the embed_links check this cog uses for message sending.
+        """
+        text_only = await self.config.guild(ctx.guild).TEXT_ONLY()
+        if text_only:
+            message = "Away messages will now be embedded or text only based on the bot's permissions for embed links."
+        else:
+            message = (
+                "Away messages are now forced to be text only, regardless of the bot's permissions for embed links."
+            )
+        await self.config.guild(ctx.guild).TEXT_ONLY.set(not text_only)
+        await ctx.send(message)
+
+    @commands.command(name="awaysettings", aliases=["awayset"])
+    async def away_settings(self, ctx):
+        """View your current away settings"""
+        author = ctx.author
+        msg = ""
+        data = {
+            "MESSAGE": "Away",
+            "IDLE_MESSAGE": "Idle",
+            "DND_MESSAGE": "Do not disturb",
+            "OFFLINE_MESSAGE": "Offline",
+            "LISTENING_MESSAGE": "Listening",
+            "STREAMING_MESSAGE": "Streaming",
+        }
+        settings = await self.config.user(author).get_raw()
+        for attr, name in data.items():
+            if type(settings[attr]) in [tuple, list]:
+                # This is just to keep backwards compatibility
+                status_msg, delete_after = settings[attr]
+            else:
+                status_msg = settings[attr]
+                delete_after = None
+            if settings[attr] and len(status_msg) > 20:
+                status_msg = status_msg[:20] + "..."
+            if settings[attr] and len(status_msg) <= 1:
+                status_msg = "True"
+            if delete_after:
+                msg += f"{name}: {status_msg} deleted after {delete_after}s\n"
+            else:
+                msg += f"{name}: {status_msg}\n"
+        if "GAME_MESSAGE" in settings:
+            if not settings["GAME_MESSAGE"]:
+                games = "False"
+            else:
+                games = "True"
+            msg += f"Games: {games}\n"
+            for game in settings["GAME_MESSAGE"]:
+                status_msg, delete_after = settings["GAME_MESSAGE"][game]
+                if len(status_msg) > 20:
+                    status_msg = status_msg[:-20] + "..."
+                if len(status_msg) <= 1:
+                    status_msg = "True"
+                if delete_after:
+                    msg += f"{game}: {status_msg} deleted after {delete_after}s\n"
+                else:
+                    msg += f"{game}: {status_msg}\n"
+
+        if ctx.channel.permissions_for(ctx.me).embed_links:
+            em = discord.Embed(description=msg[:2048], color=author.color)
+            em.set_author(name=f"{author.display_name}'s away settings", icon_url=author.avatar_url)
+            await ctx.send(embed=em)
+        else:
+            await ctx.send(f"{author.display_name} away settings\n" + msg)

away/info.json

@@ -1,7 +1,8 @@
 {
-    "AUTHOR" : "Paddolicious#8880",
+    "author": ["aikaterna", "Axas", "TrustyJAID"],
-    "NAME" : "Away",
+    "description": "Set and unset a user as being away. Originally by Paddo.",
-    "SHORT" : "Sets and unsets a user away.",
+    "short": "Away message toggle for users",
-    "DESCRIPTION" : "Sets the user as away. When someone mentions the users the bot replies with either its own message or a message set by the user that the user is away.",
+    "tags": ["away", "afk"],
-    "TAGS": ["away", "member", "tool"]
+    "type": "COG",
+    "end_user_data_statement": "This cog stores data provided by users for the express purpose of redisplaying. It does not store user data which was not provided through a command. Users may remove their own content without making a data removal request. This cog does not support data requests, but will respect deletion requests."
 }

blurplefy/__init__.py

@@ -0,0 +1,7 @@
+from .blurplefy import Blurplefy
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Blurplefy(bot))

blurplefy/blurplefy.py

@@ -0,0 +1,439 @@
+#  Ported for Red v3 from: https://github.com/Rocked03/Blurplefied
+
+import aiohttp
+import asyncio
+import datetime
+from io import BytesIO
+import logging
+import math
+from PIL import Image, ImageEnhance, ImageSequence, UnidentifiedImageError
+import random
+import sys
+from resizeimage import resizeimage
+from types import SimpleNamespace
+
+import discord
+
+from redbot.core import Config, commands, checks
+from redbot.core.utils.predicates import MessagePredicate
+
+
+log = logging.getLogger("red.aikaterna.blurplefy")
+
+
+# LEGACY_BLURPLE = (114, 137, 218)
+# LEGACY_DARK_BLURPLE = (78, 93, 148)
+BLURPLE = (88, 101, 242)
+DARK_BLURPLE = (69, 79, 191)
+WHITE = (255, 255, 255)
+
+
+class Blurplefy(commands.Cog):
+    """Blurplefy images and check blurple content of images."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete"""
+        return
+
+    def __init__(self, bot):
+        """Blurplefy images and check blurple content of images."""
+        self.bot = bot
+        self.config = Config.get_conf(self, 2778931480, force_registration=True)
+
+        default_guild = {"role_enabled": False, "blurple_role": None}
+
+        self.config.register_guild(**default_guild)
+        self.session = aiohttp.ClientSession()
+
+    @commands.guild_only()
+    @commands.command()
+    @checks.admin_or_permissions(manage_roles=True)
+    async def blurplerole(self, ctx):
+        """Toggle a role award for having a blurple profile picture.
+
+        A user's profile picture will be checked when they use [p]blurple.
+        """
+        blurple_role_id = await self.config.guild(ctx.guild).blurple_role()
+        if blurple_role_id is None:
+            msg = "Enter the role name to award: it needs to be a valid, already existing role, "
+            msg += "and the name must match exactly (don't use a role mention)."
+            await ctx.send(msg)
+            pred = MessagePredicate.same_context(ctx)
+            try:
+                blurple_role = await ctx.bot.wait_for("message", timeout=15.0, check=pred)
+                blurple_role_obj = discord.utils.get(ctx.guild.roles, name=blurple_role.content)
+                if blurple_role_obj is None:
+                    return await ctx.send("No role with that name.")
+                return await ctx.invoke(self.blurpleroleset, role_name=blurple_role_obj)
+            except asyncio.TimeoutError:
+                return await ctx.send("No role entered, try again later.")
+
+        role_enabled = await self.config.guild(ctx.guild).role_enabled()
+        await self.config.guild(ctx.guild).role_enabled.set(not role_enabled)
+        await ctx.send(f"Blurple role awarding {'enabled' if not role_enabled else 'disabled'}.")
+
+    @commands.guild_only()
+    @commands.command()
+    @checks.admin_or_permissions(manage_roles=True)
+    async def blurpleroleset(self, ctx, *, role_name: discord.Role):
+        """Sets the role to award if blurplerole is on."""
+        await self.config.guild(ctx.guild).blurple_role.set(role_name.id)
+        blurple_role_id = await self.config.guild(ctx.guild).blurple_role()
+        blurple_role_obj = discord.utils.get(ctx.guild.roles, id=blurple_role_id)
+        await ctx.send(f"Blurple award role set to: {blurple_role_obj.name}.")
+        blurple_role_enabled = await self.config.guild(ctx.guild).role_enabled()
+        if not blurple_role_enabled:
+            await ctx.invoke(self.blurplerole)
+
+    async def blurplefy(self, ctx, user: discord.Member = None):
+        """Blurplefy a user or image."""
+        picture = None
+        link = ctx.message.attachments
+        if user is None and not link:
+            picture = ctx.author.avatar_url
+        else:
+            if not user:
+                if len(link) != 0:
+                    for image in link:
+                        picture = image.url
+            else:
+                picture = user.avatar_url
+        try:
+            async with self.session.get(str(picture)) as r:
+                response = await r.read()
+        except ValueError:
+            await ctx.send(f"{ctx.author.display_name}, please link a valid image URL.")
+            return
+
+    @commands.guild_only()
+    @commands.command()
+    @commands.cooldown(rate=1, per=30, type=commands.BucketType.user)
+    async def blurple(self, ctx, user: discord.Member = None):
+        """Check a user or an attached uploaded image for blurple content."""
+        await ctx.trigger_typing()
+        picture = None
+        link = ctx.message.attachments
+        if user is None and not link:
+            picture = ctx.author.avatar_url
+            role_check = True
+        elif not user:
+            if len(link) != 0:
+                for image in link:
+                    picture = image.url
+                    role_check = False
+        else:
+            picture = user.avatar_url
+            role_check = False
+
+        try:
+            async with self.session.get(str(picture)) as r:
+                response = await r.read()
+        except ValueError:
+            await ctx.send(f"{ctx.author.display_name}, please link a valid image URL.")
+            return
+        try:
+            im = Image.open(BytesIO(response))
+        except UnidentifiedImageError:
+            await ctx.send(f"{ctx.author.display_name}, this doesn't look like an image.")
+            return
+        except Exception as exc:
+            log.exception("Blurplefy encountered an error:\n ", exc_info=exc)
+            await ctx.send(f"{ctx.author.display_name}, please link a valid image URL.")
+            return
+
+        im = im.convert("RGBA")
+        imsize = list(im.size)
+        impixels = imsize[0] * imsize[1]
+        # 1250x1250 = 1562500
+        maxpixelcount = 1562500
+
+        if impixels > maxpixelcount:
+            downsizefraction = math.sqrt(maxpixelcount / impixels)
+            im = resizeimage.resize_width(im, (imsize[0] * downsizefraction))
+            imsize = list(im.size)
+            impixels = imsize[0] * imsize[1]
+
+            msg = f"{ctx.author.display_name}, image resized smaller for easier processing."
+            await ctx.send(msg)
+
+        image_object = await self.blurple_imager(im, imsize)
+        image = discord.File(fp=image_object.file, filename=f"{random.randint(1,10000)}_image.png")
+
+        blurpleness_percentage = round(((image_object.nooftotalpixels / image_object.noofpixels) * 100), 2)
+        percent_blurple = round(((image_object.noofblurplepixels / image_object.noofpixels) * 100), 2)
+        percent_dblurple = round(((image_object.noofdarkblurplepixels / image_object.noofpixels) * 100), 2)
+        percent_white = round(((image_object.noofwhitepixels / image_object.noofpixels) * 100), 2)
+
+        embed = discord.Embed(title="", colour=0x7289DA)
+        embed.add_field(name=f"Total amount of Blurple", value=f"{blurpleness_percentage}%", inline=False)
+        embed.add_field(name=f"Blurple (rgb(88, 101, 242))", value=f"{percent_blurple}%", inline=True)
+        embed.add_field(name=f"White (rgb(255, 255, 255))", value=f"{percent_white}%", inline=True)
+        embed.add_field(name=f"Dark Blurple (rgb(69, 79, 191))", value=f"{percent_dblurple}%", inline=True)
+        embed.add_field(
+            name="Guide",
+            value="Blurple, White, Dark Blurple =  \nBlurple, White, and Dark Blurple (respectively) \nBlack = Not Blurple, White, or Dark Blurple",
+            inline=False,
+        )
+        embed.set_footer(
+            text=f"Please note: Discord slightly reduces quality of the images, therefore the percentages may be slightly inaccurate.\nContent requested by {str(ctx.author)}"
+        )
+        embed.set_image(url="attachment://image.png")
+        embed.set_thumbnail(url=picture)
+        await ctx.send(embed=embed, file=image)
+
+        blurple_role_enabled = await self.config.guild(ctx.guild).role_enabled()
+        if role_check and blurple_role_enabled:
+            blurple_role_id = await self.config.guild(ctx.guild).blurple_role()
+            blurple_role_obj = discord.utils.get(ctx.guild.roles, id=blurple_role_id)
+            if not blurple_role_obj:
+                msg = "The role that is set for the blurple role doesn't exist, so I can't award the role to any qualifying users."
+                return await ctx.send(msg)
+            if not ctx.channel.permissions_for(ctx.me).manage_roles:
+                msg = "I need the Manage Roles permission here to be able to add the set blurple role to users that have a qualifying profile picture set."
+                return await ctx.send(msg)
+            if (
+                blurpleness_percentage > 75
+                and picture == ctx.author.avatar_url
+                and blurple_role_obj not in ctx.author.roles
+                and percent_blurple > 5
+            ):
+                msg = f"{ctx.author.display_name}, as your profile pic has enough blurple (over 75% in total and over 5% blurple), "
+                msg += f"you have recieved the role **{blurple_role_obj.name}**!"
+                await ctx.send(msg)
+                await ctx.author.add_roles(blurple_role_obj)
+            elif picture == ctx.author.avatar_url and blurple_role_obj not in ctx.author.roles:
+                msg = f"{ctx.author.display_name}, your profile pic does not have enough blurple (over 75% in total and over 5% blurple), "
+                msg += f"therefore you are not eligible for the role {blurple_role_obj.name}."
+                await ctx.send(msg)
+
+    @commands.guild_only()
+    @commands.command()
+    @commands.cooldown(rate=1, per=30, type=commands.BucketType.user)
+    async def blurplefy(self, ctx, user: discord.Member = None):
+        """Blurplefy a user or an uploaded image attached to the command."""
+        await ctx.trigger_typing()
+        picture = None
+        link = ctx.message.attachments
+        if user is None and not link:
+            picture = ctx.author.avatar_url
+        else:
+            if not user:
+                if len(link) != 0:
+                    for image in link:
+                        picture = image.url
+            else:
+                picture = user.avatar_url
+        try:
+            async with self.session.get(str(picture)) as r:
+                response = await r.read()
+        except ValueError:
+            await ctx.send(f"{ctx.author.display_name}, please link a valid image URL.")
+            return
+        try:
+            im = Image.open(BytesIO(response))
+        except UnidentifiedImageError:
+            await ctx.send(f"{ctx.author.display_name}, this doesn't look like an image.")
+            return
+        except Exception as exc:
+            log.exception("Blurplefy encountered an error:\n ", exc_info=exc)
+            await ctx.send(f"{ctx.author.display_name}, please link a valid image URL.")
+            return
+
+        imsize = list(im.size)
+        impixels = imsize[0] * imsize[1]
+        # 1250x1250 = 1562500
+        maxpixelcount = 1562500
+
+        try:
+            i = im.info["version"]
+            isgif = True
+            gifloop = int(im.info["loop"])
+        except KeyError:
+            # no version key
+            isgif = False
+        except Exception as exc:
+            log.exception("Blurplefy encountered an error:\n ", exc_info=exc)
+
+        if impixels > maxpixelcount:
+            downsizefraction = math.sqrt(maxpixelcount / impixels)
+            im = resizeimage.resize_width(im, (imsize[0] * downsizefraction))
+            imsize = list(im.size)
+            impixels = imsize[0] * imsize[1]
+            await ctx.send(f"{ctx.author.display_name}, image resized smaller for easier processing.")
+
+        if isgif is False:
+            image = await self.imager(im, imsize)
+        else:
+            image = await self.gifimager(im, gifloop, imsize)
+
+        max_size = 8 * 1024 * 1024
+        size = sys.getsizeof(image)
+        if size > max_size:
+            await ctx.send(
+                f"{ctx.author.display_name}, whoops! It looks like this image is too big to upload. Try a smaller image (less than 8mb)."
+            )
+            return
+
+        if isgif is False:
+            image = discord.File(fp=image, filename="image.png")
+        else:
+            image = discord.File(fp=image, filename="image.gif")
+
+        embed = discord.Embed(title="", colour=0x7289DA)
+        embed.set_author(name="Blurplefier - makes your image blurple!")
+        if isgif is False:
+            embed.set_image(url="attachment://image.png")
+        else:
+            embed.set_image(url="attachment://image.gif")
+        embed.set_footer(
+            text=f"Please note - This blurplefier is automated and therefore may not always give you the best result.\nContent requested by {str(ctx.author)}"
+        )
+        embed.set_thumbnail(url=picture)
+        await ctx.send(embed=embed, file=image)
+
+    @staticmethod
+    async def blurple_imager(im, imsize):
+        colourbuffer = 20
+        noofblurplepixels = 0
+        noofwhitepixels = 0
+        noofdarkblurplepixels = 0
+        nooftotalpixels = 0
+        noofpixels = 0
+
+        img = im.load()
+        for x in range(imsize[0]):
+            i = 1
+            for y in range(imsize[1]):
+                pixel = img[x, y]
+                check = 1
+                checkblurple = 1
+                checkwhite = 1
+                checkdarkblurple = 1
+                for i in range(3):
+                    if not (BLURPLE[i] + colourbuffer > pixel[i] > BLURPLE[i] - colourbuffer):
+                        checkblurple = 0
+                    if not (DARK_BLURPLE[i] + colourbuffer > pixel[i] > DARK_BLURPLE[i] - colourbuffer):
+                        checkdarkblurple = 0
+                    if not (WHITE[i] + colourbuffer > pixel[i] > WHITE[i] - colourbuffer):
+                        checkwhite = 0
+                    if checkblurple == 0 and checkdarkblurple == 0 and checkwhite == 0:
+                        check = 0
+                if check == 0:
+                    img[x, y] = (0, 0, 0, 255)
+                if check == 1:
+                    nooftotalpixels += 1
+                if checkblurple == 1:
+                    noofblurplepixels += 1
+                if checkdarkblurple == 1:
+                    noofdarkblurplepixels += 1
+                if checkwhite == 1:
+                    noofwhitepixels += 1
+                noofpixels += 1
+
+        image_file_object = BytesIO()
+        im.save(image_file_object, format="png")
+        image_file_object.seek(0)
+        return SimpleNamespace(
+            file=image_file_object,
+            noofblurplepixels=noofblurplepixels,
+            noofwhitepixels=noofwhitepixels,
+            noofdarkblurplepixels=noofdarkblurplepixels,
+            nooftotalpixels=nooftotalpixels,
+            noofpixels=noofpixels,
+        )
+
+    @staticmethod
+    async def imager(im, imsize):
+        im = im.convert(mode="L")
+        im = ImageEnhance.Contrast(im).enhance(1000)
+        im = im.convert(mode="RGB")
+
+        img = im.load()
+
+        for x in range(imsize[0] - 1):
+            i = 1
+            for y in range(imsize[1] - 1):
+                pixel = img[x, y]
+
+                if pixel != (255, 255, 255):
+                    img[x, y] = BLURPLE
+
+        image_file_object = BytesIO()
+        im.save(image_file_object, format="png")
+        image_file_object.seek(0)
+        return image_file_object
+
+    @staticmethod
+    async def gifimager(im, gifloop, imsize):
+        frames = [frame.copy() for frame in ImageSequence.Iterator(im)]
+        newgif = []
+
+        for frame in frames:
+            frame = frame.convert(mode="L")
+            frame = ImageEnhance.Contrast(frame).enhance(1000)
+            frame = frame.convert(mode="RGB")
+            img = frame.load()
+
+            for x in range(imsize[0]):
+                i = 1
+                for y in range(imsize[1]):
+                    pixel = img[x, y]
+                    if pixel != (255, 255, 255):
+                        img[x, y] = BLURPLE
+            newgif.append(frame)
+
+        image_file_object = BytesIO()
+        gif = newgif[0]
+        gif.save(image_file_object, format="gif", save_all=True, append_images=newgif[1:], loop=0)
+        image_file_object.seek(0)
+        return image_file_object
+
+    @commands.command()
+    async def countdown(self, ctx):
+        """Countdown to Discord's next anniversary."""
+        embed = discord.Embed(name="\N{ZERO WIDTH SPACE}", colour=0x7289DA)
+        now = datetime.datetime.utcnow()
+
+        timeleft = datetime.datetime(now.year, 5, 13) + datetime.timedelta(hours=7) - datetime.datetime.utcnow()
+        discord_years = now.year - 2015
+        if timeleft.total_seconds() < 0:
+            timeleft = (
+                datetime.datetime((now.year + 1), 5, 13) + datetime.timedelta(hours=7) - datetime.datetime.utcnow()
+            )
+            discord_years = (now.year + 1) - 2015
+
+        discord_years_suffix = self._get_suffix(discord_years)
+        embed.set_author(name=f"Time left until Discord's {discord_years}{discord_years_suffix} Anniversary")
+        time = self._dynamic_time(int(timeleft.total_seconds()))
+        embed.add_field(name="Countdown to midnight, May 13, California time (UTC-7):", value=f"{time}")
+        await ctx.send(embed=embed)
+
+    @staticmethod
+    def _dynamic_time(time):
+        m, s = divmod(time, 60)
+        h, m = divmod(m, 60)
+        d, h = divmod(h, 24)
+
+        if d > 0:
+            msg = "{0}d {1}h"
+        elif d == 0 and h > 0:
+            msg = "{1}h {2}m"
+        elif d == 0 and h == 0 and m > 0:
+            msg = "{2}m {3}s"
+        elif d == 0 and h == 0 and m == 0 and s > 0:
+            msg = "{3}s"
+        else:
+            msg = ""
+        return msg.format(d, h, m, s)
+
+    @staticmethod
+    def _get_suffix(num):
+        suffixes = {1: "st", 2: "nd", 3: "rd"}
+        if 10 <= num % 100 <= 20:
+            suffix = "th"
+        else:
+            suffix = suffixes.get(num % 10, "th")
+        return suffix
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

blurplefy/info.json

@@ -0,0 +1,11 @@
+{
+    "author": ["aikaterna"],
+    "description": "Blurplefy a user profile picture or image. Admins can configure an awardable role if a user's profile pic has more than a certain percentage of blurple in it.",
+    "install_msg": "Thanks for installing, have fun.",
+    "permissions" : ["embed_links", "manage_roles"],
+    "requirements": ["pillow", "python-resize-image"],
+    "short": "Blurplefy a user profile picture or image.",
+    "tags": ["blurple", "discord", "avatar"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

cah/__init__.py

@@ -0,0 +1,7 @@
+from .cah import CardsAgainstHumanity
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(CardsAgainstHumanity(bot))

cah/info.json

@@ -1,7 +1,10 @@
 {
-    "AUTHOR" : "aikaterna",
+    "author": ["aikaterna"],
-    "INSTALL_MSG" : "Thanks for installing Cards Against Humanity. I highly advise only playing this game with 3-4 people on one server, on a private bot, because of the high amount of DM's this game generates.",
+    "description": "Cards Against Humanity, played in DMs.",
-    "NAME" : "cah",
+    "install_msg": "Warning: This cog can send a lot of DMs, and the bot can become rate limited. Be warned that installing this cog on a bot with a lot of users or servers might be detrimental to the bot's performance. Thanks for installing, have fun.",
-    "SHORT" : "Cards Against Humanity.",
+    "permissions" : ["embed_links"],
-    "DESCRIPTION" : "This cog was made possible by CorpBot: https://github.com/corpnewt/CorpBot.py"
+    "short": "Cards Against Humanity.",
+    "tags": ["CAH", "cards", "game"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

chatchart/__init__.py

@@ -0,0 +1,7 @@
+from .chatchart import Chatchart
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Chatchart(bot))

chatchart/chatchart.py

@@ -1,94 +1,366 @@
-#  Lines 54 through 68 are influenced heavily by cacobot's stats module:
+#  This cog is influenced heavily by cacobot's stats module:
 #  https://github.com/Orangestar12/cacobot/blob/master/cacobot/stats.py
 #  Big thanks to Redjumpman for changing the beta version from
 #  Imagemagick/cairosvg to matplotlib.
 #  Thanks to violetnyte for suggesting this cog.
+
+import asyncio
 import discord
 import heapq
-import os
 from io import BytesIO
+from typing import List, Optional, Tuple, Union
+
+from redbot.core import checks, commands, Config
+
 import matplotlib
-matplotlib.use('agg')
+matplotlib.use("agg")
 import matplotlib.pyplot as plt
-plt.switch_backend('agg')
+plt.switch_backend("agg")
-from discord.ext import commands
 
 
-class ChatChart:
+class Chatchart(commands.Cog):
     """Show activity."""
 
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
     def __init__(self, bot):
         self.bot = bot
+        self.config = Config.get_conf(self, 2766691001, force_registration=True)
 
-    def create_chart(self, top, others):
+        default_guild = {"channel_deny": []}
+        default_global = {"limit": 0}
+
+        self.config.register_guild(**default_guild)
+        self.config.register_global(**default_global)
+
+    @staticmethod
+    def calculate_member_perc(history: List[discord.Message]) -> dict:
+        """Calculate the member count from the message history"""
+        msg_data = {"total_count": 0, "users": {}}
+        for msg in history:
+            # Name formatting
+            if len(msg.author.display_name) >= 20:
+                short_name = "{}...".format(msg.author.display_name[:20]).replace("$", "\\$")
+            else:
+                short_name = msg.author.display_name.replace("$", "\\$").replace("_", "\\_ ").replace("*", "\\*")
+            whole_name = "{}#{}".format(short_name, msg.author.discriminator)
+            if msg.author.bot:
+                pass
+            elif whole_name in msg_data["users"]:
+                msg_data["users"][whole_name]["msgcount"] += 1
+                msg_data["total_count"] += 1
+            else:
+                msg_data["users"][whole_name] = {}
+                msg_data["users"][whole_name]["msgcount"] = 1
+                msg_data["total_count"] += 1
+        return msg_data
+
+    @staticmethod
+    def calculate_top(msg_data: dict) -> Tuple[list, int]:
+        """Calculate the top 20 from the message data package"""
+        for usr in msg_data["users"]:
+            pd = float(msg_data["users"][usr]["msgcount"]) / float(msg_data["total_count"])
+            msg_data["users"][usr]["percent"] = pd * 100
+        top_twenty = heapq.nlargest(
+            20,
+            [
+                (x, msg_data["users"][x][y])
+                for x in msg_data["users"]
+                for y in msg_data["users"][x]
+                if (y == "percent" and msg_data["users"][x][y] > 0)
+            ],
+            key=lambda x: x[1],
+        )
+        others = 100 - sum(x[1] for x in top_twenty)
+        return top_twenty, others
+
+    @staticmethod
+    async def create_chart(top, others, channel_or_guild: Union[discord.Guild, discord.TextChannel]):
         plt.clf()
         sizes = [x[1] for x in top]
-        labels = ["{} {:g}%".format(x[0], x[1]) for x in top]
+        labels = ["{} {:g}%".format(x[0], round(x[1], 1)) for x in top]
-        if len(top) >= 10:
+        if len(top) >= 20:
             sizes = sizes + [others]
-            labels = labels + ["Others {:g}%".format(others)]
+            labels = labels + ["Others {:g}%".format(round(others, 1))]
-
+        if len(channel_or_guild.name) >= 19:
-        title = plt.title('User activity in the last 5000 messages')
+            if isinstance(channel_or_guild, discord.Guild):
+                channel_or_guild_name = "{}...".format(channel_or_guild.name[:19])
+            else:
+                channel_or_guild_name = "#{}...".format(channel_or_guild.name[:19])
+        else:
+            channel_or_guild_name = channel_or_guild.name
+        title = plt.title("Stats in {}".format(channel_or_guild_name), color="white")
         title.set_va("top")
-        title.set_ha("left")
+        title.set_ha("center")
         plt.gca().axis("equal")
-        colors = ['r', 'darkorange', 'gold', 'y', 'olivedrab', 'green', 'darkcyan', 'mediumblue', 'darkblue', 'blueviolet', 'indigo']
+        colors = [
+            "r",
+            "darkorange",
+            "gold",
+            "y",
+            "olivedrab",
+            "green",
+            "darkcyan",
+            "mediumblue",
+            "darkblue",
+            "blueviolet",
+            "indigo",
+            "orchid",
+            "mediumvioletred",
+            "crimson",
+            "chocolate",
+            "yellow",
+            "limegreen",
+            "forestgreen",
+            "dodgerblue",
+            "slateblue",
+            "gray",
+        ]
         pie = plt.pie(sizes, colors=colors, startangle=0)
-        plt.legend(pie[0], labels, bbox_to_anchor=(0.7, 0.5), loc="center", fontsize=10,
+        plt.legend(
-                   bbox_transform=plt.gcf().transFigure)
+            pie[0],
+            labels,
+            bbox_to_anchor=(0.7, 0.5),
+            loc="center",
+            fontsize=10,
+            bbox_transform=plt.gcf().transFigure,
+            facecolor="#ffffff",
+        )
         plt.subplots_adjust(left=0.0, bottom=0.1, right=0.45)
         image_object = BytesIO()
-        plt.savefig(image_object, format='PNG')
+        plt.savefig(image_object, format="PNG", facecolor="#36393E")
         image_object.seek(0)
         return image_object
 
-    @commands.command(pass_context=True)
+    async def fetch_channel_history(
-    @commands.cooldown(1, 10, commands.BucketType.channel)
+        self,
-    async def chatchart(self, ctx):
+        channel: discord.TextChannel,
-        """
+        animation_message: discord.Message,
-        Generates a pie chart, representing the last 5000 messages in this channel.
+        messages: int
-        """
+    ) -> List[discord.Message]:
-        channel = ctx.message.channel
+        """Fetch the history of a channel while displaying an status message with it"""
-        e = discord.Embed(description="Loading...", colour=0x00ccff)
+        animation_message_deleted = False
-        e.set_thumbnail(url="https://i.imgur.com/vSp4xRk.gif")
-        em = await self.bot.say(embed=e)
-
         history = []
-        async for msg in self.bot.logs_from(channel, 5000):
+        history_counter = 0
+        async for msg in channel.history(limit=messages):
             history.append(msg)
-        msg_data = {'total count': 0, 'users': {}}
+            history_counter += 1
+            await asyncio.sleep(0.005)
+            if history_counter % 250 == 0:
+                new_embed = discord.Embed(
+                    title=f"Fetching messages from #{channel.name}",
+                    description=f"This might take a while...\n{history_counter}/{messages} messages gathered",
+                    colour=await self.bot.get_embed_colour(location=channel),
+                )
+                if channel.permissions_for(channel.guild.me).send_messages:
+                    await channel.trigger_typing()
+                if animation_message_deleted is False:
+                    try:
+                        await animation_message.edit(embed=new_embed)
+                    except discord.NotFound:
+                        animation_message_deleted = True
+        return history
 
-        for msg in history:
+    @commands.guild_only()
-            if msg.author.bot:
+    @commands.command()
+    @commands.cooldown(1, 10, commands.BucketType.guild)
+    @commands.max_concurrency(1, commands.BucketType.guild)
+    @commands.bot_has_permissions(attach_files=True)
+    async def chatchart(self, ctx, channel: Optional[discord.TextChannel] = None, messages:int = 5000):
+        """
+        Generates a pie chart, representing the last 5000 messages in the specified channel.
+        """
+        if channel is None:
+            channel = ctx.channel
+
+        # --- Early terminations
+        if channel.permissions_for(ctx.message.author).read_messages is False:
+            return await ctx.send("You're not allowed to access that channel.")
+        if channel.permissions_for(ctx.guild.me).read_messages is False:
+            return await ctx.send("I cannot read the history of that channel.")
+        blacklisted_channels = await self.config.guild(ctx.guild).channel_deny()
+        if channel.id in blacklisted_channels:
+            return await ctx.send(f"I am not allowed to create a chatchart of {channel.mention}.")
+        if messages < 5:
+            return await ctx.send("Don't be silly.")
+
+        message_limit = await self.config.limit()
+        if (message_limit != 0) and (messages > message_limit):
+            messages = message_limit
+
+        embed = discord.Embed(
+            title=f"Fetching messages from #{channel.name}",
+            description="This might take a while...",
+            colour=await self.bot.get_embed_colour(location=channel)
+        )
+        loading_message = await ctx.send(embed=embed)
+        try:
+            history = await self.fetch_channel_history(channel, loading_message, messages)
+        except discord.errors.Forbidden:
+            try:
+                await loading_message.delete()
+            except discord.NotFound:
                 pass
-            elif msg.author.name in msg_data['users']:
+            return await ctx.send("No permissions to read that channel.")
-                msg_data['users'][msg.author.name]['msgcount'] += 1
+
-                msg_data['total count'] += 1
+        msg_data = self.calculate_member_perc(history)
+        # If no members are found.
+        if len(msg_data["users"]) == 0:
+            try:
+                await loading_message.delete()
+            except discord.NotFound:
+                pass
+            return await ctx.send(f"Only bots have sent messages in {channel.mention} or I can't read message history.")
+
+        top_twenty, others = self.calculate_top(msg_data)
+        chart = await self.create_chart(top_twenty, others, channel)
+
+        try:
+            await loading_message.delete()
+        except discord.NotFound:
+            pass
+        await ctx.send(file=discord.File(chart, "chart.png"))
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @commands.guild_only()
+    @commands.command(aliases=["guildchart"])
+    @commands.cooldown(1, 30, commands.BucketType.guild)
+    @commands.max_concurrency(1, commands.BucketType.guild)
+    @commands.bot_has_permissions(attach_files=True)
+    async def serverchart(self, ctx: commands.Context, messages: int = 1000):
+        """
+        Generates a pie chart, representing the last 1000 messages from every allowed channel in the server.
+
+        As example:
+        For each channel that the bot is allowed to scan. It will take the last 1000 messages from each channel.
+        And proceed to build a chart out of that.
+        """
+        if messages < 5:
+            return await ctx.send("Don't be silly.")
+        channel_list = []
+        blacklisted_channels = await self.config.guild(ctx.guild).channel_deny()
+        for channel in ctx.guild.text_channels:
+            channel: discord.TextChannel
+            if channel.id in blacklisted_channels:
+                continue
+            if channel.permissions_for(ctx.message.author).read_messages is False:
+                continue
+            if channel.permissions_for(ctx.guild.me).read_messages is False:
+                continue
+            channel_list.append(channel)
+
+        if len(channel_list) == 0:
+            return await ctx.send("There are no channels to read... This should theoretically never happen.")
+
+        embed = discord.Embed(
+            description="Fetching messages from the entire server this **will** take a while.",
+            colour=await self.bot.get_embed_colour(location=ctx.channel),
+        )
+        global_fetch_message = await ctx.send(embed=embed)
+        global_history = []
+
+        for channel in channel_list:
+            embed = discord.Embed(
+                title=f"Fetching messages from #{channel.name}",
+                description="This might take a while...",
+                colour=await self.bot.get_embed_colour(location=channel)
+            )
+            loading_message = await ctx.send(embed=embed)
+            try:
+                history = await self.fetch_channel_history(channel, loading_message, messages)
+                global_history += history
+                await loading_message.delete()
+            except discord.errors.Forbidden:
+                try:
+                    await loading_message.delete()
+                except discord.NotFound:
+                    continue
+            except discord.NotFound:
+                try:
+                    await loading_message.delete()
+                except discord.NotFound:
+                    continue 
+
+        msg_data = self.calculate_member_perc(global_history)
+        # If no members are found.
+        if len(msg_data["users"]) == 0:
+            try:
+                await global_fetch_message.delete()
+            except discord.NotFound:
+                pass
+            return await ctx.send(f"Only bots have sent messages in this server... Wauw...")
+
+        top_twenty, others = self.calculate_top(msg_data)
+        chart = await self.create_chart(top_twenty, others, ctx.guild)
+
+        try:
+            await global_fetch_message.delete()
+        except discord.NotFound:
+            pass
+        await ctx.send(file=discord.File(chart, "chart.png"))
+
+    @checks.mod_or_permissions(manage_channels=True)
+    @commands.guild_only()
+    @commands.command()
+    async def ccdeny(self, ctx, channel: discord.TextChannel):
+        """Add a channel to deny chatchart use."""
+        channel_list = await self.config.guild(ctx.guild).channel_deny()
+        if channel.id not in channel_list:
+            channel_list.append(channel.id)
+        await self.config.guild(ctx.guild).channel_deny.set(channel_list)
+        await ctx.send(f"{channel.mention} was added to the deny list for chatchart.")
+
+    @checks.mod_or_permissions(manage_channels=True)
+    @commands.guild_only()
+    @commands.command()
+    async def ccdenylist(self, ctx):
+        """List the channels that are denied."""
+        no_channels_msg = "Chatchart is currently allowed everywhere in this server."
+        channel_list = await self.config.guild(ctx.guild).channel_deny()
+        if not channel_list:
+            msg = no_channels_msg
         else:
-                msg_data['users'][msg.author.name] = {}
+            msg = "Chatchart is not allowed in:\n"
-                msg_data['users'][msg.author.name]['msgcount'] = 1
+            remove_list = []
-                msg_data['total count'] += 1
+            for channel in channel_list:
+                channel_obj = self.bot.get_channel(channel)
+                if not channel_obj:
+                    remove_list.append(channel)
+                else:
+                    msg += f"{channel_obj.mention}\n"
+            if remove_list:
+                new_list = [x for x in channel_list if x not in remove_list]
+                await self.config.guild(ctx.guild).channel_deny.set(new_list)
+                if len(remove_list) == len(channel_list):
+                    msg = no_channels_msg
+        await ctx.send(msg)
 
-        for usr in msg_data['users']:
+    @checks.mod_or_permissions(manage_channels=True)
-            pd = float(msg_data['users'][usr]['msgcount']) / float(msg_data['total count'])
+    @commands.guild_only()
-            msg_data['users'][usr]['percent'] = round(pd * 100, 1)
+    @commands.command()
+    async def ccallow(self, ctx, channel: discord.TextChannel):
+        """Remove a channel from the deny list to allow chatchart use."""
+        channel_list = await self.config.guild(ctx.guild).channel_deny()
+        if channel.id in channel_list:
+            channel_list.remove(channel.id)
+        else:
+            return await ctx.send("Channel is not on the deny list.")
+        await self.config.guild(ctx.guild).channel_deny.set(channel_list)
+        await ctx.send(f"{channel.mention} will be allowed for chatchart use.")
 
-        top_ten = heapq.nlargest(10, [(x, msg_data['users'][x][y])
+    @checks.is_owner()
-                                      for x in msg_data['users']
+    @commands.command()
-                                      for y in msg_data['users'][x]
+    async def cclimit(self, ctx, limit_amount: int = None):
-                                      if y == 'percent'], key=lambda x: x[1])
+        """
-        others = 100 - sum(x[1] for x in top_ten)
+        Limit the amount of messages someone can request.
-        img = self.create_chart(top_ten, others)
-        await self.bot.delete_message(em)
-        await self.bot.send_file(channel, img, filename="chart.png")
 
-
+        Use `0` for no limit.
-def check_folders():
+        """
-    if not os.path.exists("data/chatchart"):
+        if limit_amount is None:
-        print("Creating data/chatchart folder...")
+            return await ctx.send_help()
-        os.makedirs("data/chatchart")
+        if limit_amount < 0:
-
+            return await ctx.send("You need to use a number larger than 0.")
-
+        await self.config.limit.set(limit_amount)
-def setup(bot):
+        await ctx.send(f"Chatchart is now limited to {limit_amount} messages.")
-    check_folders()
-    bot.add_cog(ChatChart(bot))

chatchart/info.json

@@ -1,9 +1,10 @@
 {
-    "AUTHOR" : "aikaterna and Redjumpman",
+    "author": ["aikaterna", "Redjumpman"],
-    "INSTALL_MSG" : "Use [p]chatchart to generate a chart for that channel.",
+    "description": "Generate a pie chart from the last 5000 messages in a channel to see who's been talking the most.",
-    "NAME" : "chatchart",
+    "install_msg": "Thanks for installing, have fun.",
-    "SHORT" : "Generate a pie chart from the last 5000 messages.",
+    "short": "Generate a pie chart from the last 5000 messages",
-    "DESCRIPTION" : "Generate a pie chart from the last 5000 messages in a channel to see who's been talking the most.",
+    "tags": ["messages", "chart", "count", "activity"],
-    "REQUIREMENTS": ["matplotlib"],
+    "requirements": ["matplotlib"],
-    "TAGS": ["data", "chart", "activity"]
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
 }

dadjokes/__init__.py

@@ -0,0 +1,7 @@
+from .dadjokes import DadJokes
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(DadJokes(bot))

dadjokes/dadjokes.py

@@ -0,0 +1,26 @@
+from redbot.core import commands
+import aiohttp
+
+
+class DadJokes(commands.Cog):
+    """Random dad jokes from icanhazdadjoke.com"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+
+    @commands.command()
+    async def dadjoke(self, ctx):
+        """Gets a random dad joke."""
+        try:
+            async with aiohttp.request("GET", "https://icanhazdadjoke.com/", headers={"Accept": "text/plain"}) as r:
+                if r.status != 200:
+                    return await ctx.send("Oops! Cannot get a dad joke...")
+                result = await r.text(encoding="UTF-8")
+        except aiohttp.ClientConnectionError:
+            return await ctx.send("Oops! Cannot get a dad joke...")
+
+        await ctx.send(f"`{result}`")

dadjokes/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["UltimatePancake"],
+    "description": "Gets a random dad joke from icanhazdadjoke.com",
+    "install_msg": "Gets a random dad joke from icanhazdadjoke.com. Thanks for installing.",
+    "short": "Random dad jokes",
+    "tags": ["jokes", "dad", "dadjokes"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

dictionary/__init__.py

@@ -0,0 +1,7 @@
+from .dictionary import Dictionary
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Dictionary(bot))

dictionary/dictionary.py

@@ -0,0 +1,157 @@
+import aiohttp
+import discord
+import contextlib
+from bs4 import BeautifulSoup
+import json
+import logging
+import re
+from redbot.core import commands
+from redbot.core.utils.chat_formatting import pagify
+
+
+log = logging.getLogger("red.aikaterna.dictionary")
+
+
+class Dictionary(commands.Cog):
+    """
+    Word, yo
+    Parts of this cog are adapted from the PyDictionary library.
+    """
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete"""
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.session = aiohttp.ClientSession()
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())
+
+    @commands.command()
+    async def define(self, ctx, *, word: str):
+        """Displays definitions of a given word."""
+        search_msg = await ctx.send("Searching...")
+        search_term = word.split(" ", 1)[0]
+        result = await self._definition(ctx, search_term)
+        str_buffer = ""
+        if not result:
+            with contextlib.suppress(discord.NotFound):
+                await search_msg.delete()
+            await ctx.send("This word is not in the dictionary.")
+            return
+        for key in result:
+            str_buffer += f"\n**{key}**: \n"
+            counter = 1
+            j = False
+            for val in result[key]:
+                if val.startswith("("):
+                    str_buffer += f"{str(counter)}. *{val})* "
+                    counter += 1
+                    j = True
+                else:
+                    if j:
+                        str_buffer += f"{val}\n"
+                        j = False
+                    else:
+                        str_buffer += f"{str(counter)}. {val}\n"
+                        counter += 1
+        with contextlib.suppress(discord.NotFound):
+            await search_msg.delete()
+        for page in pagify(str_buffer, delims=["\n"]):
+            await ctx.send(page)
+
+    async def _definition(self, ctx, word):
+        data = await self._get_soup_object(f"http://wordnetweb.princeton.edu/perl/webwn?s={word}")
+        if not data:
+            return await ctx.send("Error fetching data.")
+        types = data.findAll("h3")
+        length = len(types)
+        lists = data.findAll("ul")
+        out = {}
+        if not lists:
+            return
+        for a in types:
+            reg = str(lists[types.index(a)])
+            meanings = []
+            for x in re.findall(r">\s\((.*?)\)\s<", reg):
+                if "often followed by" in x:
+                    pass
+                elif len(x) > 5 or " " in str(x):
+                    meanings.append(x)
+            name = a.text
+            out[name] = meanings
+        return out
+
+    @commands.command()
+    async def antonym(self, ctx, *, word: str):
+        """Displays antonyms for a given word."""
+        search_term = word.split(" ", 1)[0]
+        result = await self._antonym_or_synonym(ctx, "antonyms", search_term)
+        if not result:
+            await ctx.send("This word is not in the dictionary or nothing was found.")
+            return
+
+        result_text = "*, *".join(result)
+        msg = f"Antonyms for **{search_term}**: *{result_text}*"
+        for page in pagify(msg, delims=["\n"]):
+            await ctx.send(page)
+
+    @commands.command()
+    async def synonym(self, ctx, *, word: str):
+        """Displays synonyms for a given word."""
+        search_term = word.split(" ", 1)[0]
+        result = await self._antonym_or_synonym(ctx, "synonyms", search_term)
+        if not result:
+            await ctx.send("This word is not in the dictionary or nothing was found.")
+            return
+
+        result_text = "*, *".join(result)
+        msg = f"Synonyms for **{search_term}**: *{result_text}*"
+        for page in pagify(msg, delims=["\n"]):
+            await ctx.send(page)
+
+    async def _antonym_or_synonym(self, ctx, lookup_type, word):
+        if lookup_type not in ["antonyms", "synonyms"]:
+            return None
+        data = await self._get_soup_object(f"http://www.thesaurus.com/browse/{word}")
+        if not data:
+            await ctx.send("Error getting information from the website.")
+            return
+
+        website_data = None
+        script = data.find_all("script")
+        for item in script:
+            if item.string:
+                if "window.INITIAL_STATE" in item.string:
+                    content = item.string
+                    content = content.lstrip("window.INITIAL_STATE =").rstrip(";")
+                    content = content.replace("undefined", '"None"').replace(": true", ': "True"').replace(": false", ': "False"')
+                    try:
+                        website_data = json.loads(content)
+                    except json.decoder.JSONDecodeError:
+                        return None
+                    except Exception as e:
+                        log.exception(e, exc_info=e)
+                        await ctx.send("Something broke. Check your console for more information.")
+                        return None
+
+        final = []
+        if website_data:
+            tuna_api_data = website_data["searchData"]["tunaApiData"]
+            if not tuna_api_data:
+                return None
+            syn_list = tuna_api_data["posTabs"][0][lookup_type]
+            for syn in syn_list:
+                final.append(syn["term"])
+
+        return final
+
+    async def _get_soup_object(self, url):
+        try:
+            async with self.session.request("GET", url) as response:
+                return BeautifulSoup(await response.text(), "html.parser")
+        except Exception:
+            log.error("Error fetching dictionary.py related webpage", exc_info=True)
+            return None

dictionary/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["UltimatePancake", "aikaterna"],
+    "description": "Gets definitions, antonyms, or synonyms for given words",
+    "install_msg": "After loading the cog with `[p]load dictionary`, use [p]help Dictionary to view commands.",
+    "short": "Gets definitions, antonyms, or synonyms for given words",
+    "tags": ["dictionary", "synonym", "antonym"],
+    "requirements": ["beautifulsoup4"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

discordexperiments/__init__.py

@@ -0,0 +1,7 @@
+from .discordexperiments import DiscordExperiments
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(DiscordExperiments(bot))

discordexperiments/discordexperiments.py

@@ -0,0 +1,217 @@
+import discord
+from discord.http import Route
+from redbot.core import checks, commands
+
+
+class DiscordExperiments(commands.Cog):
+    """Create voice channel invites to access experimental applications on Discord."""
+
+    def __init__(self, bot):
+        self.bot = bot
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete"""
+        return
+
+    async def _create_invite(self, ctx, app_id: int, max_age: int, app_name: str):
+        voice = ctx.author.voice
+        if not voice:
+            return await ctx.send("You have to be in a voice channel to use this command.")
+        if not voice.channel.permissions_for(ctx.me).create_instant_invite == True:
+            return await ctx.send(
+                "I need the `Create Invite` permission for your channel before you can use this command."
+            )
+
+        r = Route("POST", "/channels/{channel_id}/invites", channel_id=voice.channel.id)
+        payload = {"max_age": max_age, "target_type": 2, "target_application_id": app_id}
+        reason = (
+            f"DiscordExperiments: {ctx.author} ({ctx.author.id}) created an invite for {app_name}."
+        )
+        code = (await self.bot.http.request(r, json=payload, reason=reason))["code"]
+
+        await ctx.send(
+            embed=discord.Embed(
+                description=f"[Click here to join {app_name} in {voice.channel.name}!](https://discord.gg/{code})",
+                color=0x2F3136,
+            )
+        )
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def ytparty(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a YouTube Together voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "YouTube Together"
+        await self._create_invite(ctx, 880218394199220334, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command(hidden=True)
+    async def betrayal(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Betrayal.io voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Betrayal game"
+        await self._create_invite(ctx, 773336526917861400, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command(hidden=True)
+    async def fishington(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Fishington.io voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Fishington game"
+        await self._create_invite(ctx, 814288819477020702, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def pokernight(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Poker Night voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "Poker Night"
+        await self._create_invite(ctx, 755827207812677713, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def chess(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Chess in the Park voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "Chess in the Park"
+        await self._create_invite(ctx, 832012774040141894, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def sketchheads(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Sketch Heads voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Sketch Heads game"
+        await self._create_invite(ctx, 902271654783242291, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def letterleague(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Letter League voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Letter League game"
+        await self._create_invite(ctx, 879863686565621790, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def wordsnacks(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Word Snacks voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Word Snacks game"
+        await self._create_invite(ctx, 879863976006127627, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def spellcast(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a SpellCast voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the SpellCast game"
+        await self._create_invite(ctx, 852509694341283871, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def checkers(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Checkers in the Park voice channel invite.
+
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "Checkers in the Park"
+        await self._create_invite(ctx, 832013003968348200, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def blazing8s(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Blazing 8s voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Blazing 8s game"
+        await self._create_invite(ctx, 832025144389533716, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def puttparty(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Putt Party voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Putt Party game"
+        await self._create_invite(ctx, 945737671223947305, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def landio(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Land-io voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Land-io game"
+        await self._create_invite(ctx, 903769130790969345, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def bobbleleague(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Bobble League voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Bobble League game"
+        await self._create_invite(ctx, 947957217959759964, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def askaway(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create an Ask Away voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Ask Away game"
+        await self._create_invite(ctx, 976052223358406656, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def knowwhatimeme(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Know What I Meme voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Know What I Meme game"
+        await self._create_invite(ctx, 950505761862189096, invite_max_age_in_seconds, app_name)
+
+    @commands.cooldown(1, 10, discord.ext.commands.BucketType.guild)
+    @commands.command()
+    async def bashout(self, ctx, invite_max_age_in_seconds=86400):
+        """
+        Create a Bash Out voice channel invite.
+        Use `0` for `invite_max_age_in_seconds` if you want the invite to be permanent.
+        """
+        app_name = "the Bash Out game"
+        await self._create_invite(ctx, 1006584476094177371, invite_max_age_in_seconds, app_name)

discordexperiments/info.json

@@ -0,0 +1,8 @@
+{
+    "author": ["aikaterna"],
+    "install_msg": "⚠ **THIS COG IS NOT FOR GENERAL USE** ⚠\nThis cog creates voice invites for experimental applications that Discord is still working on.\nAnything can break at any time.\nI am not responsible for anything that happens to your Discord account or your bot while using this cog.\nUsers are required to use OAuth authentication to access some of these applications on joining the voice channels and interacting with it. This interaction/authentication is between Discord and the service(s) providing the experiments.\nI do not recommend installing this cog on a public bot.\nDO NOT LOAD THIS COG IF YOU DO NOT AGREE TO THE RISKS. NOT ALL RISKS HAVE BEEN EXPLAINED HERE.",
+    "short": "Create voice invites for experimental Discord applications.",
+    "description": "Create voice invites for experimental Discord applications.",
+    "tags": ["discord"],
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

embedpeek/__init__.py

@@ -0,0 +1,7 @@
+from .embedpeek import EmbedPeek
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(EmbedPeek(bot))

embedpeek/embedpeek.py

@@ -0,0 +1,89 @@
+import discord
+from redbot.core import commands
+from redbot.core.utils.chat_formatting import box, pagify
+
+
+class EmbedPeek(commands.Cog):
+    """Take a closer look at an embed."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete"""
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self._grave = "\N{GRAVE ACCENT}"
+
+    @commands.command()
+    async def embedpeek(self, ctx, message_link: str):
+        """
+        Take a closer look at an embed.
+
+        On a webhook message or other multi-embed messages, this will only display the first embed.
+        """
+        bad_link_msg = "That doesn't look like a message link, I can't reach that message, or that link does not have an embed."
+        no_guild_msg = "You aren't in that guild."
+        no_channel_msg = "You can't view that channel."
+        no_message_msg = "That message wasn't found."
+
+        if not "discord.com/channels/" in message_link:
+            return await ctx.send(bad_link_msg)
+        ids = message_link.split("/")
+        if len(ids) != 7:
+            return await ctx.send(bad_link_msg)
+
+        guild = self.bot.get_guild(int(ids[4]))
+        channel = self.bot.get_channel(int(ids[5]))
+        try:
+            message = await channel.fetch_message(int(ids[6]))
+        except discord.errors.NotFound:
+            return await ctx.send(no_message_msg)
+
+        if ctx.author not in guild.members:
+            return await ctx.send(no_guild_msg)
+        if not channel.permissions_for(ctx.author).read_messages:
+            return await ctx.send(no_channel_msg)
+
+        components = [guild, channel, message]
+        valid_components = [x for x in components if x != None]
+        if len(valid_components) < 3:
+            return await ctx.send(bad_link_msg)
+
+        try:
+            embed = message.embeds[0]
+        except IndexError:
+            return await ctx.send(bad_link_msg)
+
+        info = embed.to_dict()
+        sorted_info = dict(sorted(info.items()))
+        msg = ""
+
+        for k, v in sorted_info.items():
+            if k == "type":
+                continue
+            msg += f"+ {k}\n"
+            if isinstance(v, str):
+                msg += f"{v.replace(self._grave, '~')}\n\n"
+            elif isinstance(v, list):
+                for i, field in enumerate(v):
+                    msg += f"--- field {i+1} ---\n"
+                    for m, n in field.items():
+                        msg += f"- {str(m).replace(self._grave, '~')}\n"
+                        msg += f"{str(n).replace(self._grave, '~')}\n"
+                    msg += "\n"
+            elif isinstance(v, dict):
+                msg += self._dict_cleaner(v)
+                msg += "\n"
+            else:
+                msg += f"{str(v)}\n\n"
+
+        for page in pagify(msg, delims=f"{'-' * 20}", page_length=1500):
+            await ctx.send(box(page, lang="diff"))
+
+    def _dict_cleaner(self, d: dict):
+        msg = ""
+        for k, v in d.items():
+            k = str(k).replace(self._grave, "~")
+            v = str(v).replace(self._grave, "~")
+            msg += f"- {k}\n{v}\n"
+        return msg

embedpeek/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["aikaterna"],
+    "description": "Dev tool to display the content of an embed.",
+    "install_msg": "Thanks for installing.",
+    "short": "Dev tool to display the content of an embed.",
+    "tags": ["embed"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

forwarding/forwarding.py

@@ -1,49 +0,0 @@
-#  forwarding.py is ported from another bot:
-#  https://github.com/jacobcheatley/dankbot
-
-import discord
-from discord.ext import commands
-from .utils.dataIO import dataIO
-from .utils import checks
-
-
-class Forwarding:
-    def __init__(self, bot: commands.Bot):
-        self.bot = bot
-        self.owner = self.get_owner()
-
-    def get_owner(self):
-        owner_id = dataIO.load_json("data/red/settings.json")["OWNER"]
-        return discord.utils.find(lambda m: m.id == owner_id, self.bot.get_all_members())
-
-    async def send_to_owner(self, **kwargs):
-        if self.owner is None:
-            self.owner = self.get_owner()
-        await self.bot.send_message(self.owner, **kwargs)
-
-    async def on_message(self, message: discord.Message):
-        if self.owner is None:
-            self.owner = self.get_owner()
-        if not message.channel.is_private or message.channel.user.id == self.owner.id:
-            return
-
-        embed = discord.Embed()
-        if message.author == self.bot.user:
-            embed.title = 'Sent PM to {}#{} ({}).'.format(message.channel.user.name, message.channel.user.discriminator, message.channel.user.id)
-        else:
-            embed.set_author(name=message.author, icon_url=message.author.avatar_url or message.author.default_avatar_url)
-            embed.title = '{} messaged me:'.format(message.channel.user.id)
-        embed.description = message.content
-        embed.timestamp = message.timestamp
-
-        await self.send_to_owner(embed=embed)
-
-    @commands.command()
-    @checks.is_owner()
-    async def pm(self, user: discord.User, *, content: str):
-        """PMs a person."""
-        await self.bot.send_message(user, content)
-
-
-def setup(bot):
-    bot.add_cog(Forwarding(bot))

forwarding/info.json

@@ -1,7 +0,0 @@
-{
-    "AUTHOR" : "aikaterna",
-    "NAME" : "forwarding",
-    "SHORT" : "Forwards DMs sent to the bot to the owner.",
-    "DESCRIPTION" : "Forwards DMs sent to the bot to the owner.",
-    "TAGS": ["message", "dm"]
-}

hunting/__init__.py

@@ -0,0 +1,14 @@
+from .hunting import Hunting
+
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. "
+    "This cog does store discord IDs as needed for operation. "
+    "This cog does store user stats for the cog such as their score. "
+    "Users may remove their own content without making a data removal request."
+    "This cog does not support data requests, "
+    "but will respect deletion requests."
+)
+
+
+async def setup(bot):
+    bot.add_cog(Hunting(bot))

hunting/hunting.py

@@ -1,240 +1,488 @@
-from __main__ import send_cmd_help
-from .utils.dataIO import dataIO
-from discord.ext import commands
-from .utils import checks
-import datetime
 import asyncio
-import discord
+import datetime
+from logging import warning
+import math
 import random
 import time
-import os
+from typing import Literal
 
-# TODO
+import discord
-# Show error when timing intervals are the same
+from redbot.core import Config, checks, commands, bank
+from redbot.core.errors import BalanceTooHigh
+from redbot.core.utils.chat_formatting import (bold, box, humanize_list,
+                                               humanize_number, pagify)
+from redbot.core.utils.menus import DEFAULT_CONTROLS, menu
+from redbot.core.utils.predicates import MessagePredicate
+
+__version__ = "3.1.9"
 
 
-class Hunting:
+class Hunting(commands.Cog):
+    """Hunting, it hunts birds and things that fly."""
+
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        await self.config.user_from_id(user_id).clear()
+
     def __init__(self, bot):
         self.bot = bot
-        self.scores = dataIO.load_json('data/hunting/scores.json')
+        self.config = Config.get_conf(self, 2784481002, force_registration=True)
-        self.subscriptions = dataIO.load_json('data/hunting/subscriptions.json')
+
-        self.settings = dataIO.load_json('data/hunting/settings.json')
+        self.animals = {
-        self.animals = {'duck': ':duck: **_Quack!_**', 'penguin': ':penguin: **_Noot!_**', 'chicken': ':rooster: **_Bah-gawk!_**', 'pigeon': ':dove: **_Coo!_**'}
+            "dove": ":dove: **_Coo!_**",
+            "penguin": ":penguin: **_Noot!_**",
+            "chicken": ":chicken: **_Bah-gawk!_**",
+            "duck": ":duck: **_Quack!_**",
+        }
         self.in_game = []
         self.paused_games = []
-        self._latest_message_check_message_limit = 5
+        self.next_bang = {}
-        self._latest_message_check_wait_limit = self.settings['hunt_interval_maximum'] * 2
+        self.game_tasks = []
-        self.next = None
 
-    async def _save_scores(self):
+        default_guild = {
-        dataIO.save_json('data/hunting/scores.json', self.scores)
+            "hunt_interval_minimum": 900,
+            "hunt_interval_maximum": 3600,
+            "wait_for_bang_timeout": 20,
+            "channels": [],
+            "bang_time": False,
+            "bang_words": True,
+            "reward_range": [],
+        }
+        default_global = {
+            "reward_range": [],  # For bots with global banks
+        }
+        default_user = {"score": {}, "total": 0}
+        self.config.register_user(**default_user)
+        self.config.register_guild(**default_guild)
+        self.config.register_global(**default_global)
 
-    async def _save_subscriptions(self):
+    @commands.guild_only()
-        dataIO.save_json('data/hunting/subscriptions.json', self.subscriptions)
+    @commands.group()
-
+    async def hunting(self, ctx):
-    async def _save_settings(self):
+        """Hunting, it hunts birds and things that fly."""
-        dataIO.save_json('data/hunting/settings.json', self.settings)
+        if ctx.invoked_subcommand is None:
-
+            guild_data = await self.config.guild(ctx.guild).all()
-    @commands.group(pass_context=True, no_pm=True, name='hunting')
+            if not guild_data["channels"]:
-    async def _hunting(self, context):
+                channel_names = ["No channels set."]
-        """Hunting, it hunts birds... and things that fly"""
-        if context.invoked_subcommand is None:
-            await send_cmd_help(context)
-
-    @_hunting.command(pass_context=True, no_pm=True, name='start')
-    async def _start(self, context):
-        """Start the hunt"""
-        server = context.message.server
-        channel = context.message.channel
-        if server.id in self.subscriptions:
-            message = '**We\'re already hunting!**'
             else:
-            self.subscriptions[server.id] = channel.id
+                channel_names = []
-            message = '**The hunt has started. Good luck to all.**'
+                for channel_id in guild_data["channels"]:
-            await self._save_subscriptions()
+                    channel_obj = self.bot.get_channel(channel_id)
-        await self.bot.say(message)
+                    if channel_obj:
+                        channel_names.append(channel_obj.name)
 
-    @_hunting.command(pass_context=True, no_pm=True, name='stop')
+            hunting_mode = "Words" if guild_data["bang_words"] else "Reactions"
-    async def _stop(self, context):
+            reaction_time = "On" if guild_data["bang_time"] else "Off"
-        """Stop the hunt"""
+
-        server = context.message.server
+            msg = f"[Hunting in]:                 {humanize_list(channel_names)}\n"
-        if server.id not in self.subscriptions:
+            msg += f"[Bang timeout]:               {guild_data['wait_for_bang_timeout']} seconds\n"
-            message = '**We\'re not hunting!**'
+            msg += f"[Hunt interval minimum]:      {guild_data['hunt_interval_minimum']} seconds\n"
+            msg += f"[Hunt interval maximum]:      {guild_data['hunt_interval_maximum']} seconds\n"
+            msg += f"[Hunting mode]:               {hunting_mode}\n"
+            msg += f"[Bang response time message]: {reaction_time}\n"
+
+            if await bank.is_global():
+                reward = await self.config.reward_range()
+                if reward:
+                    reward = f"{reward[0]} - {reward[1]}"
+                msg += f"[Hunting reward range]:       {reward if reward else 'None'}\n"
             else:
-            del self.subscriptions[server.id]
+                reward = guild_data['reward_range']
-            message = '**The hunt has stopped.**'
+                if reward:
-            await self._save_subscriptions()
+                    reward = f"{reward[0]} - {reward[1]}"
-        await self.bot.say(message)
+                msg += f"[Hunting reward range]:       {reward if reward else 'None'}\n"
 
-    @_hunting.command(no_pm=True, name='timing')
+            for page in pagify(msg, delims=["\n"]):
-    @checks.is_owner()
+                await ctx.send(box(page, lang="ini"))
-    async def _timing(self, interval_min: int, interval_max: int, bang_timeout: int):
+
-        """Change the timing"""
+    @hunting.command()
-        if interval_min > interval_max:
+    async def leaderboard(self, ctx, global_leaderboard=False):
-            message = '**`interval_min` needs to be lower than `interval_max`**'
+        """
-        elif interval_min < 0 and interval_max < 0 and bang_timeout < 0:
+        This will show the top 50 hunters for the server.
-            message = '**Please no negative numbers!**'
+        Use True for the global_leaderboard variable to show the global leaderboard.
-        elif interval_min == interval_max:
+        """
-            message = '**`interval_min` and `interval_max` cannot be the same**'
+        userinfo = await self.config._all_from_scope(scope="USER")
+        if not userinfo:
+            return await ctx.send(bold("Please shoot something before you can brag about it."))
+
+        async with ctx.typing():
+            sorted_acc = sorted(userinfo.items(), key=lambda x: (x[1]["total"]), reverse=True)[:50]
+
+        if not hasattr(ctx.guild, "members"):
+            global_leaderboard = True
+
+        pound_len = len(str(len(sorted_acc)))
+        score_len = 10
+        header = "{score:{score_len}}{name:2}\n".format(
+            score="# Birds Shot",
+            score_len=score_len + 5,
+            name="Name" if not str(ctx.author.mobile_status) in ["online", "idle", "dnd"] else "Name",
+        )
+        temp_msg = header
+        for account in sorted_acc:
+            if account[1]["total"] == 0:
+                continue
+            if global_leaderboard or (account[0] in [member.id for member in ctx.guild.members]):
+                user_obj = self.bot.get_user(account[0]) or account[0]
             else:
-            self.settings['hunt_interval_minimum'] = interval_min
+                continue
-            self.settings['hunt_interval_maximum'] = interval_max
+            if isinstance(user_obj, discord.User) and len(str(user_obj)) > 28:
-            self.settings['wait_for_bang_timeout'] = bang_timeout
+                user_name = f"{user_obj.name[:19]}...#{user_obj.discriminator}"
-            await self._save_settings()
+            else:
-            message = '**Timing has been set.**'
+                user_name = str(user_obj)
-        await self.bot.say(message)
+            if user_obj == ctx.author:
+                temp_msg += f"{humanize_number(account[1]['total']) + '   ': <{score_len + 4}} <<{user_name}>>\n"
+            else:
+                temp_msg += f"{humanize_number(account[1]['total']) + '   ': <{score_len + 4}} {user_name}\n"
 
-    @_hunting.command(pass_context=True, no_pm=True, name='next')
+        page_list = []
-    @checks.is_owner()
+        pages = 1
-    async def _next(self, context):
+        for page in pagify(temp_msg, delims=["\n"], page_length=800):
-        """When will the next occurance happen?"""
+            if global_leaderboard:
-        if self.next:
+                title = "Global Hunting Leaderboard"
-            time = abs(datetime.datetime.utcnow() - self.next)
+            else:
+                title = f"Hunting Leaderboard For {ctx.guild.name}"
+            embed = discord.Embed(
+                colour=await ctx.bot.get_embed_color(location=ctx.channel),
+                description=box(title, lang="prolog") + (box(page, lang="md")),
+            )
+            embed.set_footer(text=f"Page {humanize_number(pages)}/{humanize_number(math.ceil(len(temp_msg) / 800))}")
+            pages += 1
+            page_list.append(embed)
+        if len(page_list) == 1:
+            await ctx.send(embed=page_list[0])
+        else:
+            await menu(ctx, page_list, DEFAULT_CONTROLS)
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def bangtime(self, ctx):
+        """Toggle displaying the bang response time from users."""
+        toggle = await self.config.guild(ctx.guild).bang_time()
+        await self.config.guild(ctx.guild).bang_time.set(not toggle)
+        toggle_text = "will not" if toggle else "will"
+        await ctx.send(f"Bang reaction time {toggle_text} be shown.\n")
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def mode(self, ctx):
+        """Toggle whether the bot listens for 'bang' or a reaction."""
+        toggle = await self.config.guild(ctx.guild).bang_words()
+        await self.config.guild(ctx.guild).bang_words.set(not toggle)
+        toggle_text = "Use the reaction" if toggle else "Type 'bang'"
+        await ctx.send(f"{toggle_text} to react to the bang message when it appears.\n")
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def reward(self, ctx, min_reward: int = None, max_reward: int = None):
+        """
+        Set a credit reward range for successfully shooting a bird
+
+        Leave the options blank to disable bang rewards
+        """
+        bank_is_global = await bank.is_global()
+        if ctx.author.id not in self.bot.owner_ids and bank_is_global:
+            return await ctx.send("Bank is global, only bot owner can set a reward range.")
+        if not min_reward or not max_reward:
+            if min_reward != 0 and not max_reward:  # Maybe they want users to sometimes not get rewarded
+                if bank_is_global:
+                    await self.config.reward_range.set([])
+                else:
+                    await self.config.guild(ctx.guild).reward_range.set([])
+                msg = "Reward range reset to default(None)."
+                return await ctx.send(msg)
+        if min_reward > max_reward:
+            return await ctx.send("Your minimum reward is greater than your max reward...")
+        reward_range = [min_reward, max_reward]
+        currency_name = await bank.get_currency_name(ctx.guild)
+        if bank_is_global:
+            await self.config.reward_range.set(reward_range)
+        else:
+            await self.config.guild(ctx.guild).reward_range.set(reward_range)
+        msg = f"Users can now get {min_reward} to {max_reward} {currency_name} for shooting a bird."
+        await ctx.send(msg)
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def next(self, ctx):
+        """When will the next occurrence happen?"""
+        try:
+            hunt = self.next_bang[ctx.guild.id]
+            time = abs(datetime.datetime.utcnow() - hunt)
             total_seconds = int(time.total_seconds())
             hours, remainder = divmod(total_seconds, 60 * 60)
             minutes, seconds = divmod(remainder, 60)
-            message = '**The next occurance will be in {} hours and {} minutes.**'.format(hours, minutes)
+            message = f"The next occurrence will be in {hours} hours and {minutes} minutes."
-        else:
+        except KeyError:
-            message = '**There is currently no hunt.**'
+            message = "There is currently no hunt."
-        await self.bot.say(message)
+        await ctx.send(bold(message))
 
-    @_hunting.command(pass_context=True, no_pm=True, name='score')
+    @hunting.command(name="score")
-    async def _score(self, context, member: discord.Member):
+    async def score(self, ctx, member: discord.Member = None):
-        """This will show the score of a hunter"""
+        """This will show the score of a hunter."""
-        server = context.message.server
+        if not member:
-        if server.id in self.scores:
+            member = ctx.author
-            if member.id in self.scores[server.id]:
+        score = await self.config.user(member).score()
-                message = '**{} shot a total of {} animals ({})**'.format(member.mention, self.scores[server.id][member.id]['total'], ', '.join([str(self.scores[server.id][member.id]['score'][x]) + ' ' + x.capitalize() + 's' for x in self.scores[server.id][member.id]['score']]))  # (', '.join([str(self.scores[server.id][member.id]['score'][x]) + ' ' + x.capitalize() + 's' for x in self.scores[server.id][member.id]['score']]))
+        total = 0
-            else:
+        kill_list = []
-                message = '**Please shoot something before you can brag about it.**'
+        if not score:
-        else:
+            message = "Please shoot something before you can brag about it."
-            message = '**Please shoot something before you can brag about it.**'
-        await self.bot.say(message)
 
-    @_hunting.command(pass_context=True, no_pm=True, name='clearscore')
+        for animal in score.items():
-    @checks.serverowner()
+            total = total + animal[1]
-    async def _clearscore(self, context):
+            if animal[1] == 1 or animal[0][-1] == "s":
-        """Clear the leaderboard"""
+                kill_list.append(f"{animal[1]} {animal[0].capitalize()}")
-        server = context.message.server
-        if server.id in self.scores:
-            self.scores[server.id] = {}
-            await self._save_scores()
-            message = 'Leaderboard is cleared'
             else:
-            message = 'There\'s nothing to clear'
+                kill_list.append(f"{animal[1]} {animal[0].capitalize()}s")
-        await self.bot.say(message)
+            message = f"{member.name} shot a total of {total} animals ({humanize_list(kill_list)})"
+        await ctx.send(bold(message))
 
-    @_hunting.command(pass_context=True, no_pm=True, name='leaderboard', aliases=['scores'])
+    @checks.mod_or_permissions(manage_guild=True)
-    async def _huntingboard(self, context):
+    @hunting.command()
-        """This will show the top hunters on this server"""
+    async def start(self, ctx, channel: discord.TextChannel = None):
-        server = context.message.server
+        """Start the hunt."""
-        if server.id in self.scores:
+        if not channel:
-            p = self.scores[server.id]
+            channel = ctx.channel
-            scores = sorted(p, key=lambda x: (p[x]['total']), reverse=True)
+
-            message = '```\n{:<4}{:<8}{}\n\n'.format('#', 'TOTAL', 'USERNAME')
+        if not channel.permissions_for(ctx.guild.me).send_messages:
-            for i, hunter in enumerate(scores, 1):
+            return await ctx.send(bold("I can't send messages in that channel!"))
-                if i > 10:
+
-                    break
+        channel_list = await self.config.guild(ctx.guild).channels()
-                message += '{:<4}{:<8}{} ({})\n'.format(i, p[hunter]['total'], p[hunter]['author_name'], ', '.join([str(p[hunter]['score'][x]) + ' ' + x.capitalize() + 's' for x in p[hunter]['score']]))
+        if channel.id in channel_list:
-            message += '```'
+            message = f"We're already hunting in {channel.mention}!"
         else:
-            message = '**Please shoot something before you can brag about it.**'
+            channel_list.append(channel.id)
-        await self.bot.say(message)
+            message = f"The hunt has started in {channel.mention}. Good luck to all."
+            await self.config.guild(ctx.guild).channels.set(channel_list)
 
-    async def add_score(self, server, author, avian):
+        await ctx.send(bold(message))
-        if server.id not in self.scores:
-            self.scores[server.id] = {}
-        if author.id not in self.scores[server.id]:
-            self.scores[server.id][author.id] = {}
-            self.scores[server.id][author.id]['score'] = {}
-            self.scores[server.id][author.id]['total'] = 0
-            self.scores[server.id][author.id]['author_name'] = ''
-            for a in list(self.animals.keys()):
-                self.scores[server.id][author.id]['score'][a] = 0
-        if avian not in self.scores[server.id][author.id]['score']:
-            self.scores[server.id][author.id]['score'][avian] = 0
-        self.scores[server.id][author.id]['author_name'] = author.display_name
-        self.scores[server.id][author.id]['score'][avian] += 1
-        self.scores[server.id][author.id]['total'] += 1
-        await self._save_scores()
 
-    async def _wait_for_bang(self, server, channel):
+    @checks.mod_or_permissions(manage_guild=True)
-        def check(message):
+    @hunting.command()
-            return message.content.lower().split(' ')[0] == 'bang' or message.content.lower() == 'b' if message.content else False
+    async def stop(self, ctx, channel: discord.TextChannel = None):
+        """Stop the hunt."""
+        if not channel:
+            channel = ctx.channel
+        channel_list = await self.config.guild(ctx.guild).channels()
 
-        animal = random.choice(list(self.animals.keys()))
+        if channel.id not in channel_list:
-        await self.bot.send_message(channel, self.animals[animal])
+            message = f"We're not hunting in {channel.mention}!"
-        message = await self.bot.wait_for_message(channel=channel, timeout=self.settings['wait_for_bang_timeout'], check=check)
-        if message:
-            author = message.author
-            if random.randrange(0, 17) > 1:
-                await self.add_score(server, author, animal)
-                msg = '**{} shot a {}!**'.format(author.mention, animal)
         else:
-                msg = '**{} missed the shot and the {} got away!**'.format(author.mention, animal)
+            channel_list.remove(channel.id)
+            message = f"The hunt has stopped in {channel.mention}."
+            await self.config.guild(ctx.guild).channels.set(channel_list)
+
+        await ctx.send(bold(message))
+
+    @checks.is_owner()
+    @hunting.command()
+    async def clearleaderboard(self, ctx):
+        """
+        Clear all the scores from the leaderboard.
+        """
+        warning_string = (
+            "Are you sure you want to clear all the scores from the leaderboard?\n"
+            "This is a global wipe and **cannot** be undone!\n"
+            "Type \"Yes\" to confirm, or \"No\" to cancel."
+        )
+
+        await ctx.send(warning_string)
+        pred = MessagePredicate.yes_or_no(ctx)
+        try:
+            await self.bot.wait_for("message", check=pred, timeout=15)
+            if pred.result is True:
+                await self.config.clear_all_users()
+                return await ctx.send("Done!")
             else:
-            msg = '**The {} got away!** :confused:'.format(animal)
+                return await ctx.send("Alright, not clearing the leaderboard.")
-        self.in_game.remove(channel.id)
+        except asyncio.TimeoutError:
-        await self.bot.send_message(channel, msg)
+            return await ctx.send("Response timed out.")
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @hunting.command()
+    async def timing(self, ctx, interval_min: int, interval_max: int, bang_timeout: int):
+        """
+        Change the hunting timing.
+
+        `interval_min` = Minimum time in seconds for a new bird. (120s min)
+        `interval_max` = Maximum time in seconds for a new bird. (240s min)
+        `bang_timeout` = Time in seconds for users to shoot a bird before it flies away. (10s min)
+        """
+        message = ""
+        if interval_min > interval_max:
+            return await ctx.send("`interval_min` needs to be lower than `interval_max`.")
+        if interval_min < 0 and interval_max < 0 and bang_timeout < 0:
+            return await ctx.send("Please no negative numbers!")
+        if interval_min < 120:
+            interval_min = 120
+            message += "Minimum interval set to minimum of 120s.\n"
+        if interval_max < 240:
+            interval_max = 240
+            message += "Maximum interval set to minimum of 240s.\n"
+        if bang_timeout < 10:
+            bang_timeout = 10
+            message += "Bang timeout set to minimum of 10s.\n"
+
+        await self.config.guild(ctx.guild).hunt_interval_minimum.set(interval_min)
+        await self.config.guild(ctx.guild).hunt_interval_maximum.set(interval_max)
+        await self.config.guild(ctx.guild).wait_for_bang_timeout.set(bang_timeout)
+        message += (
+            f"Timing has been set:\nMin time {interval_min}s\nMax time {interval_max}s\nBang timeout {bang_timeout}s"
+        )
+        await ctx.send(bold(message))
+
+    @hunting.command()
+    async def version(self, ctx):
+        """Show the cog version."""
+        await ctx.send(f"Hunting version {__version__}.")
+
+    async def _add_score(self, guild, author, avian):
+        user_data = await self.config.user(author).all()
+        try:
+            user_data["score"][avian] += 1
+        except KeyError:
+            user_data["score"][avian] = 1
+        user_data["total"] += 1
+        await self.config.user(author).set_raw(value=user_data)
 
     async def _latest_message_check(self, channel):
-        async for message in self.bot.logs_from(channel, limit=self._latest_message_check_message_limit, reverse=True):
+        hunt_int_max = await self.config.guild(channel.guild).hunt_interval_maximum()
-            delta = datetime.datetime.utcnow() - message.timestamp
+        async for message in channel.history(limit=5):
-            if delta.total_seconds() < self._latest_message_check_wait_limit and message.author.id != self.bot.user.id:
+            delta = datetime.datetime.utcnow() - message.created_at
+            if delta.total_seconds() < hunt_int_max * 2 and message.author.id != self.bot.user.id:
                 if channel.id in self.paused_games:
                     self.paused_games.remove(channel.id)
                 return True
         if channel.id not in self.paused_games:
             self.paused_games.append(channel.id)
-            await self.bot.send_message(channel, '**It seems there are no hunters here. The hunt will be resumed when someone treads here again.**')
+            await channel.send(
+                bold("It seems there are no hunters here. The hunt will be resumed when someone treads here again.")
+            )
         return False
 
-    async def _hunting_loop(self):
+    def _next_sorter(self, guild_id, value):
-        while self == self.bot.get_cog('Hunting'):
+        try:
-            wait_time = random.randrange(self.settings['hunt_interval_minimum'], self.settings['hunt_interval_maximum'])
+            self.next_bang[guild_id]
-            self.next = datetime.datetime.fromtimestamp(int(time.mktime(datetime.datetime.utcnow().timetuple())) + wait_time)
+        except KeyError:
+            self.next_bang[guild_id] = value
+
+    async def _wait_for_bang(self, guild, channel):
+        animal = random.choice(list(self.animals.keys()))
+        animal_message = await channel.send(self.animals[animal])
+        now = time.time()
+        timeout = await self.config.guild(guild).wait_for_bang_timeout()
+
+        shooting_type = await self.config.guild(guild).bang_words()
+        if shooting_type:
+
+            def check(message):
+                if guild != message.guild:
+                    return False
+                if channel != message.channel:
+                    return False
+                return message.content.lower().split(" ")[0] == "bang" if message.content else False
+
+            try:
+                bang_msg = await self.bot.wait_for("message", check=check, timeout=timeout)
+            except asyncio.TimeoutError:
+                self.in_game.remove(channel.id)
+                return await channel.send(f"The {animal} got away!")
+            author = bang_msg.author
+
+        else:
+            emoji = "\N{COLLISION SYMBOL}"
+            await animal_message.add_reaction(emoji)
+
+            def check(reaction, user):
+                if user.bot:
+                    return False
+                if guild != reaction.message.guild:
+                    return False
+                if channel != reaction.message.channel:
+                    return False
+                return user and str(reaction.emoji) == "💥"
+
+            try:
+                await self.bot.wait_for("reaction_add", check=check, timeout=timeout)
+            except asyncio.TimeoutError:
+                self.in_game.remove(channel.id)
+                return await channel.send(f"The {animal} got away!")
+
+            message_with_reacts = await animal_message.channel.fetch_message(animal_message.id)
+            reacts = message_with_reacts.reactions[0]
+            async for user in reacts.users():
+                if user.bot:
+                    continue
+                author = user
+                break
+
+        bang_now = time.time()
+        time_for_bang = "{:.3f}".format(bang_now - now)
+        bangtime = "" if not await self.config.guild(guild).bang_time() else f" in {time_for_bang}s"
+
+        if random.randrange(0, 17) > 1:
+            await self._add_score(guild, author, animal)
+            reward = await self.maybe_send_reward(guild, author)
+            if reward:
+                cur_name = await bank.get_currency_name(guild)
+                msg = f"{author.display_name} shot a {animal}{bangtime} and earned {reward} {cur_name}!"
+            else:
+                msg = f"{author.display_name} shot a {animal}{bangtime}!"
+        else:
+            msg = f"{author.display_name} missed the shot and the {animal} got away!"
+
+        self.in_game.remove(channel.id)
+        await channel.send(bold(msg))
+
+    async def maybe_send_reward(self, guild, author) -> int:
+        max_bal = await bank.get_max_balance(guild)
+        user_bal = await bank.get_balance(author)
+        if await bank.is_global():
+            range_to_give = await self.config.reward_range()
+        else:
+            range_to_give = await self.config.guild(guild).reward_range()
+        to_give = random.choice(range(range_to_give[0], range_to_give[1] + 1))
+        if to_give + user_bal > max_bal:
+            to_give = max_bal - user_bal
+        try:
+            await bank.deposit_credits(author, to_give)
+        except BalanceTooHigh as e:  # This shouldn't throw since we already compare to max bal
+            await bank.set_balance(author, e.max_balance)
+        return to_give
+
+    @commands.Cog.listener()
+    async def on_message(self, message):
+        if not message.guild:
+            return
+        if message.author.bot:
+            return
+        if not message.channel.permissions_for(message.guild.me).send_messages:
+            return
+        if message.channel.id in self.in_game:
+            return
+        channel_list = await self.config.guild(message.guild).channels()
+        if not channel_list:
+            return
+        if message.channel.id not in channel_list:
+            return
+
+        if await self._latest_message_check(message.channel):
+            self.in_game.append(message.channel.id)
+
+        guild_data = await self.config.guild(message.guild).all()
+        wait_time = random.randrange(guild_data["hunt_interval_minimum"], guild_data["hunt_interval_maximum"])
+        self.next_bang[message.guild.id] = datetime.datetime.fromtimestamp(
+            int(time.mktime(datetime.datetime.utcnow().timetuple())) + wait_time
+        )
         await asyncio.sleep(wait_time)
-            for server in self.subscriptions:
+        task = self.bot.loop.create_task(self._wait_for_bang(message.guild, message.channel))
-                if self.subscriptions[server] not in self.in_game:
+        self.game_tasks.append(task)
-                    channel = self.bot.get_channel(self.subscriptions[server])
+        try:
-                    server = self.bot.get_server(server)
+            del self.next_bang[message.guild.id]
-                    if await self._latest_message_check(channel):
+        except (KeyError, AttributeError):
-                        self.in_game.append(self.subscriptions[server.id])
+            pass
-                        self.bot.loop = asyncio.get_event_loop()
-                        self.bot.loop.create_task(self._wait_for_bang(server, channel))
 
-
+    def cog_unload(self):
-def check_folder():
+        for task in self.game_tasks:
-    if not os.path.exists('data/hunting'):
+            task.cancel()
-        print('Creating data/hunting folder...')
-        os.makedirs('data/hunting')
-
-
-def check_files():
-    f = 'data/hunting/settings.json'
-    if not dataIO.is_valid_json(f):
-        print('Creating empty settings.json...')
-        data = {}
-        data['hunt_interval_minimum'] = 300
-        data['hunt_interval_maximum'] = 600
-        data['wait_for_bang_timeout'] = 30
-        dataIO.save_json(f, data)
-
-    f = 'data/hunting/subscriptions.json'
-    if not dataIO.is_valid_json(f):
-        print('Creating empty subscriptions.json...')
-        dataIO.save_json(f, {})
-
-    f = 'data/hunting/scores.json'
-    if not dataIO.is_valid_json(f):
-        print('Creating empty scores.json...')
-        dataIO.save_json(f, {})
-
-
-def setup(bot):
-    check_folder()
-    check_files()
-    cog = Hunting(bot)
-    loop = asyncio.get_event_loop()
-    loop.create_task(cog._hunting_loop())
-    bot.add_cog(cog)

hunting/info.json

@@ -1,7 +1,9 @@
 {
-    "AUTHOR" : "Paddolicious#8880",
+    "author": ["aikaterna", "Paddo"],
-    "NAME" : "Hunting",
+    "description": "Hunting, it hunts birds and things that fly.",
-    "SHORT" : "Hunting, it hunts birds... and things that fly",
+    "install_msg": "Check out [p]hunting to get started.",
-    "DESCRIPTION" : "Hunting, it hunts birds... and things that fly",
+    "short": "A bird hunting game.",
-    "TAGS": ["Hunting", "hunt", "birds", "paddo"]
+    "tags": ["hunting", "hunt", "game"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store end user data. This cog does store discord IDs as needed for operation. This cog does store user stats for the cog such as their score. Users may remove their own content without making a data removal request. This cog does not support data requests, but will respect deletion requests."
 }

icyparser/__init__.py

@@ -0,0 +1,7 @@
+from .icyparser import IcyParser
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(IcyParser(bot))

icyparser/icyparser.py

@@ -0,0 +1,330 @@
+import aiohttp
+from aiohttp.client_proto import ResponseHandler
+from aiohttp.http_parser import HttpResponseParserPy
+import discord
+import functools
+import io
+import lavalink
+import logging
+from pkg_resources import parse_version
+import struct
+import re
+from types import SimpleNamespace
+from typing import List, Pattern, Optional
+
+from redbot.core import commands
+from redbot.core.utils.chat_formatting import pagify
+from redbot.core.utils.menus import menu, DEFAULT_CONTROLS
+
+
+log = logging.getLogger("red.aikaterna.icyparser")
+
+
+HTML_CLEANUP: Pattern = re.compile("<.*?>|&([a-z0-9]+|#[0-9]{1,6}|#x[0-9a-f]{1,6});")
+
+
+# Now utilizing Jack1142's answer for ICY 200 OK -> 200 OK at
+# https://stackoverflow.com/questions/4247248/record-streaming-and-saving-internet-radio-in-python/71890980
+
+
+class ICYHttpResponseParser(HttpResponseParserPy):
+    def parse_message(self, lines):
+        if lines[0].startswith(b"ICY "):
+            lines[0] = b"HTTP/1.0 " + lines[0][4:]
+        return super().parse_message(lines)
+
+
+class ICYResponseHandler(ResponseHandler):
+    def set_response_params(
+        self,
+        *,
+        timer=None,
+        skip_payload=False,
+        read_until_eof=False,
+        auto_decompress=True,
+        read_timeout=None,
+        read_bufsize=2 ** 16,
+        timeout_ceil_threshold=5,
+    ) -> None:
+        # this is a copy of the implementation from here:
+        # https://github.com/aio-libs/aiohttp/blob/v3.8.1/aiohttp/client_proto.py#L137-L165
+        self._skip_payload = skip_payload
+
+        self._read_timeout = read_timeout
+        self._reschedule_timeout()
+
+        self._timeout_ceil_threshold = timeout_ceil_threshold
+
+        self._parser = ICYHttpResponseParser(
+            self,
+            self._loop,
+            read_bufsize,
+            timer=timer,
+            payload_exception=aiohttp.ClientPayloadError,
+            response_with_body=not skip_payload,
+            read_until_eof=read_until_eof,
+            auto_decompress=auto_decompress,
+        )
+
+        if self._tail:
+            data, self._tail = self._tail, b""
+            self.data_received(data)
+
+
+class ICYConnector(aiohttp.TCPConnector):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._factory = functools.partial(ICYResponseHandler, loop=self._loop)
+
+
+class IcyParser(commands.Cog):
+    """Icyparser/Shoutcast stream reader."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete."""
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.timeout = aiohttp.ClientTimeout(total=20)
+        self.session = session = aiohttp.ClientSession(
+            connector=ICYConnector(), headers={"Icy-MetaData": "1"}, timeout=self.timeout
+        )
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())
+
+    @commands.guild_only()
+    @commands.command(aliases=["icynp"])
+    async def icyparser(self, ctx, url=None):
+        """Show Icecast or Shoutcast stream information, if any.
+
+        Supported link formats:
+        \tDirect links to MP3, AAC, or OGG/Opus encoded Icecast or Shoutcast streams
+        \tLinks to PLS, M3U, or M3U8 files that contain said stream types
+        """
+        if not url:
+            audiocog = self.bot.get_cog("Audio")
+            if not audiocog:
+                return await ctx.send(
+                    "The Audio cog is not loaded. Provide a url with this command instead, to read from an online Icecast or Shoutcast stream."
+                )
+
+            if parse_version(lavalink.__version__) <=  parse_version("0.9.0"):
+                try:
+                    player = lavalink.get_player(ctx.guild.id)
+                except KeyError:
+                    return await ctx.send("The bot is not playing any music.")
+            else:
+                try:
+                    player = lavalink.get_player(ctx.guild.id)
+                except lavalink.PlayerNotFound:
+                    return await ctx.send("The bot is not playing any music.")
+            if not player.current:
+                return await ctx.send("The bot is not playing any music.")
+            if not player.current.is_stream:
+                return await ctx.send("The bot is not playing a stream.")
+            async with ctx.typing():
+                radio_obj = await self._icyreader(ctx, player.current.uri)
+        else:
+            async with ctx.typing():
+                radio_obj = await self._icyreader(ctx, url)
+
+        if not radio_obj:
+            return
+
+        embed_menu_list = []
+
+        # Now Playing embed
+        title = radio_obj.title if radio_obj.title is not None else "No stream title available"
+        song = f"**[{title}]({player.current.uri if not url else url})**\n"
+        embed = discord.Embed(colour=await ctx.embed_colour(), title="Now Playing", description=song)
+
+        # Set radio image if scraped or provided by the Icy headers
+        if radio_obj.image:
+            embed.set_thumbnail(url=radio_obj.image)
+        else:
+            icylogo = dict(radio_obj.resp_headers).get("icy-logo", None)
+            if icylogo:
+                embed.set_thumbnail(url=icylogo)
+            else:
+                icyfavicon = dict(radio_obj.resp_headers).get("icy-favicon", None)
+                if icyfavicon:
+                    embed.set_thumbnail(url=icyfavicon)
+
+        # Set radio description if present
+        radio_station_description = dict(radio_obj.resp_headers).get("icy-description", None)
+        if radio_station_description == "Unspecified description":
+            radio_station_description = None
+        if radio_station_description:
+            embed.set_footer(text=radio_station_description)
+
+        embed_menu_list.append(embed)
+
+        # Metadata info embed(s)
+        stream_info_text = ""
+        sorted_radio_obj_dict = dict(sorted(radio_obj.resp_headers))
+        for k, v in sorted_radio_obj_dict.items():
+            v = self._clean_html(v)
+            stream_info_text += f"**{k}**: {v}\n"
+
+        if len(stream_info_text) > 1950:
+            for page in pagify(stream_info_text, delims=["\n"], page_length=1950):
+                info_embed = discord.Embed(
+                    colour=await ctx.embed_colour(), title="Radio Station Metadata", description=page
+                )
+                embed_menu_list.append(info_embed)
+        else:
+            info_embed = discord.Embed(
+                colour=await ctx.embed_colour(), title="Radio Station Metadata", description=stream_info_text
+            )
+            embed_menu_list.append(info_embed)
+
+        await menu(ctx, embed_menu_list, DEFAULT_CONTROLS)
+
+    async def _icyreader(self, ctx: commands.Context, url: Optional[str]) -> Optional[SimpleNamespace]:
+        """
+        Icecast/Shoutcast stream reader.
+        """
+        try:
+            extensions = [".pls", ".m3u", ".m3u8"]
+            if any(url.endswith(x) for x in extensions):
+                async with self.session.get(url) as resp:
+                    lines = []
+                    async for line in resp.content:
+                        lines.append(line)
+
+                    if url.endswith(".pls"):
+                        url = await self._pls_reader(lines)
+                    else:
+                        url = await self._m3u_reader(lines)
+
+                    if url:
+                        await self._icyreader(ctx, url)
+                    else:
+                        await ctx.send("That url didn't seem to contain any valid Icecast or Shoutcast links.")
+                        return
+
+            async with self.session.get(url) as resp:
+                metaint = await self._metaint_read(ctx, resp)
+                if metaint:
+                    radio_obj = await self._metadata_read(int(metaint), resp)
+                    return radio_obj
+
+        except aiohttp.client_exceptions.InvalidURL:
+            await ctx.send(f"{url} is not a valid url.")
+            return None
+        except aiohttp.client_exceptions.ClientConnectorError:
+            await ctx.send("The connection failed.")
+            return None
+        except aiohttp.client_exceptions.ClientPayloadError as e:
+            friendly_msg = "The website closed the connection prematurely or the response was malformed.\n"
+            friendly_msg += f"The error returned was: `{str(e)}`\n"
+            await ctx.send(friendly_msg)
+            return None
+        except asyncio.exceptions.TimeoutError:
+            await ctx.send("The bot timed out while trying to access that url.")
+            return None
+        except aiohttp.client_exceptions.ServerDisconnectedError:
+            await ctx.send("The target server disconnected early without a response.")
+            return None
+        except Exception:
+            log.error(
+                f"Icyparser's _icyreader encountered an error while trying to read a stream at {url}", exc_info=True
+            )
+            return None
+
+    @staticmethod
+    async def _metaint_read(ctx: commands.Context, resp: aiohttp.client_reqrep.ClientResponse) -> Optional[int]:
+        """Fetch the metaint value to know how much of the stream header to read, for metadata."""
+        metaint = resp.headers.get("icy-metaint", None)
+        if not metaint:
+            error_msg = (
+                "The url provided doesn't seem like an Icecast or Shoutcast direct stream link, "
+                "or doesn't contain a supported format stream link: couldn't read the metadata length."
+            )
+            await ctx.send(error_msg)
+            return None
+
+        try:
+            metaint = int(metaint)
+            return metaint
+        except ValueError:
+            return None
+
+    @staticmethod
+    async def _metadata_read(metaint: int, resp: aiohttp.client_reqrep.ClientResponse) -> Optional[SimpleNamespace]:
+        """Read the metadata at the beginning of the stream chunk."""
+        try:
+            for _ in range(5):
+                await resp.content.readexactly(metaint)
+                metadata_length = struct.unpack("B", await resp.content.readexactly(1))[0] * 16
+                metadata = await resp.content.readexactly(metadata_length)
+                m = re.search(br"StreamTitle='([^']*)';", metadata.rstrip(b"\0"))
+                if m:
+                    title = m.group(1)
+                    if len(title) > 0:
+                        title = title.decode("utf-8", errors="replace")
+                    else:
+                        title = None
+                else:
+                    title = None
+
+                image = False
+                t = re.search(br"StreamUrl='([^']*)';", metadata.rstrip(b"\0"))
+                if t:
+                    streamurl = t.group(1)
+                    if streamurl:
+                        streamurl = streamurl.decode("utf-8", errors="replace")
+                        image_ext = ["webp", "png", "jpg", "gif"]
+                        if streamurl.split(".")[-1] in image_ext:
+                            image = True
+                else:
+                    streamurl = None
+
+                radio_obj = SimpleNamespace(title=title, image=streamurl, resp_headers=resp.headers.items())
+                return radio_obj
+
+        except Exception:
+            log.error(
+                f"Icyparser's _metadata_read encountered an error while trying to read a stream at {url}", exc_info=True
+            )
+        return None
+
+    @staticmethod
+    def _clean_html(html: str) -> str:
+        """
+        Strip out any html, as subtle as a hammer.
+        """
+        plain_text = re.sub(HTML_CLEANUP, "", html)
+        return plain_text
+
+    @staticmethod
+    async def _m3u_reader(readlines: List[bytes]) -> Optional[str]:
+        """
+        Helper function for a quick and dirty M3U or M3U8 file read.
+        M3U8's will most likely contain .ts files, which are not readable by this cog.
+
+        Some M3Us seem to follow the standard M3U format, some only have a bare url in
+        the file, so let's just return the very first url with an http or https prefix
+        found, if it's formatted like a real url and not a relative url, and is not a .ts chunk.
+        """
+        for text_line in readlines:
+            text_line_str = text_line.decode()
+            if text_line_str.startswith("http"):
+                if not text_line_str.endswith(".ts"):
+                    return text_line_str
+
+        return None
+
+    @staticmethod
+    async def _pls_reader(readlines: List[bytes]) -> Optional[str]:
+        """
+        Helper function for a quick and dirty PLS file read.
+        """
+        for text_line in readlines:
+            text_line_str = text_line.decode()
+            if text_line_str.startswith("File1="):
+                return text_line_str[6:]
+
+        return None

icyparser/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["aikaterna"],
+    "description": "Audio addon cog for dislaying icecast/shoutcast info.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Audio addon cog for dislaying icecast/shoutcast info",
+    "tags": ["audio", "icecast", "shoutcast"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

imgwelcome/imgwelcome.py

@@ -1,615 +0,0 @@
-#  _is_hex, _hex_to_rgb, _rgb_to_hex are from Stevy's leveler.py
-#  Also thanks to Stevy for nice, smooth circles.
-#  https://github.com/AznStevy/Maybe-Useful-Cogs
-#  imgwelcomeset_upload is based on code in orels' drawing.py
-#  https://github.com/orels1/ORELS-Cogs
-#  Parts of _create_welcome and on_member_join are from the Welcomer bot:
-#  https://discordbots.org/bot/330416853971107840
-#  Font switcher, font outline, and bonus text announcement toggles
-#  thanks to Sitryk.
-#  Font listing from FlapJack + aikaterna's yet unpublished wordcloud cog.
-import asyncio
-import aiohttp
-import datetime
-import discord
-import os
-import re
-import time
-from __main__ import send_cmd_help
-from cogs.utils.dataIO import dataIO
-from cogs.utils import checks
-from copy import deepcopy
-from discord.ext import commands
-from io import BytesIO
-from PIL import Image, ImageFont, ImageOps, ImageDraw
-
-
-default_settings = {"ANNOUNCE": False,
-                    "BACKGROUND": "data/imgwelcome/transparent.png",
-                    "BONUSES": {"ACCOUNT_WARNINGS": True,
-                                "SPECIAL_USERS": True
-                                },
-                    "BORDER": [255, 255, 255, 230],
-                    "CHANNEL": None,
-                    "OUTLINE": [0, 0, 0, 255],
-                    "SERVERTEXT": [255, 255, 255, 230],
-                    "TEXT": [255, 255, 255, 230],
-                    "FONT": {"WELCOME_FONT": {"PATH": "data/imgwelcome/fonts/UniSansHeavy.otf",
-                                               "SIZE": 50},
-                             "SERVER_FONT": {"PATH": "data/imgwelcome/fonts/UniSansHeavy.otf",
-                                              "SIZE": 20},
-                             "NAME_FONT": {"PATH": "data/imgwelcome/fonts/UniSansHeavy.otf",
-                                            "SIZE": {"NORMAL": 30,
-                                                      "MEDIUM": 22,
-                                                      "SMALL": 18,
-                                                      "SMALLEST": 12
-                                                    }
-                                            }
-                            }
-                    }
-
-
-class ImgWelcome:
-    """Welcomes a user to the server with an image."""
-
-    def __init__(self, bot):
-        self.bot = bot
-        self.settings = dataIO.load_json('data/imgwelcome/settings.json')
-        self.version = "0.1.6"
-
-    async def save_settings(self):
-        dataIO.save_json('data/imgwelcome/settings.json', self.settings)
-
-    async def _create_welcome(self, member, url, test_member_number: int = None):
-        server = member.server
-        wfont = self.settings[server.id]["FONT"]["WELCOME_FONT"]
-        sfont = self.settings[server.id]["FONT"]["SERVER_FONT"]
-        nfont = self.settings[server.id]["FONT"]["NAME_FONT"]
-        welcome_font = ImageFont.truetype(wfont["PATH"], wfont["SIZE"])
-        server_font = ImageFont.truetype(sfont["PATH"], sfont["SIZE"])
-
-        name_font = ImageFont.truetype(nfont["PATH"], nfont["SIZE"]["NORMAL"])
-        name_font_medium = ImageFont.truetype(nfont["PATH"], nfont["SIZE"]["MEDIUM"])
-        name_font_small = ImageFont.truetype(nfont["PATH"], nfont["SIZE"]["SMALL"])
-        name_font_smallest = ImageFont.truetype(nfont["PATH"], nfont["SIZE"]["SMALLEST"])
-        background = Image.open(self.settings[server.id]["BACKGROUND"]).convert('RGBA')
-        no_profile_picture = Image.open("data/imgwelcome/noimage.png")
-
-        global welcome_picture
-        welcome_picture = Image.new("RGBA", (500, 150))
-        welcome_picture = ImageOps.fit(background, (500, 150), centering=(0.5, 0.5))
-        welcome_picture.paste(background)
-        welcome_picture = welcome_picture.resize((500, 150), Image.NEAREST)
-
-        profile_area = Image.new("L", (512, 512), 0)
-        draw = ImageDraw.Draw(profile_area)
-        draw.ellipse(((0, 0), (512, 512)), fill=255)
-        circle_img_size = tuple(self.settings[member.server.id]["CIRCLE"])
-        profile_area = profile_area.resize((circle_img_size), Image.ANTIALIAS)
-        try:
-            url = url.replace('webp?size=1024', 'png')
-            url = url.replace('gif?size=1024', 'png')
-            await self._get_profile(url)
-            profile_picture = Image.open('data/imgwelcome/profilepic.png')
-        except:
-            profile_picture = no_profile_picture
-        profile_area_output = ImageOps.fit(profile_picture, (circle_img_size), centering=(0, 0))
-        profile_area_output.putalpha(profile_area)
-
-        bordercolor = tuple(self.settings[member.server.id]["BORDER"])
-        fontcolor = tuple(self.settings[member.server.id]["TEXT"])
-        servercolor = tuple(self.settings[member.server.id]["SERVERTEXT"])
-        textoutline = tuple(self.settings[server.id]["OUTLINE"])
-
-        mask = Image.new('L', (512, 512), 0)
-        draw_thumb = ImageDraw.Draw(mask)
-        draw_thumb.ellipse((0, 0) + (512, 512), fill=255, outline=0)
-        circle = Image.new("RGBA", (512, 512))
-        draw_circle = ImageDraw.Draw(circle)
-        draw_circle.ellipse([0, 0, 512, 512], fill=(bordercolor[0], bordercolor[1], bordercolor[2], 180), outline=(255, 255, 255, 250))
-        circle_border_size = await self._circle_border(circle_img_size)
-        circle = circle.resize((circle_border_size), Image.ANTIALIAS)
-        circle_mask = mask.resize((circle_border_size), Image.ANTIALIAS)
-        circle_pos = (7 + int((136 - circle_border_size[0]) / 2))
-        border_pos = (11 + int((136 - circle_border_size[0]) / 2))
-        drawtwo = ImageDraw.Draw(welcome_picture)
-        welcome_picture.paste(circle, (circle_pos, circle_pos), circle_mask)
-        welcome_picture.paste(profile_area_output, (border_pos, border_pos), profile_area_output)
-
-        uname = (str(member.name) + "#" + str(member.discriminator))
-
-        def _outline(original_position: tuple, text: str, pixel_displacement: int, font, textoutline):
-            op = original_position
-            pd = pixel_displacement
-
-            left = (op[0] - pd, op[1])
-            right = (op[0] + pd, op[1])
-            up = (op[0], op[1] - pd)
-            down = (op[0], op[1] + pd)
-
-            drawtwo.text(left, text, font=font, fill=(textoutline))
-            drawtwo.text(right, text, font=font, fill=(textoutline))
-            drawtwo.text(up, text, font=font, fill=(textoutline))
-            drawtwo.text(down, text, font=font, fill=(textoutline))
-
-            drawtwo.text(op, text, font=font, fill=(textoutline))
-
-        _outline((150, 16), "Welcome", 1, welcome_font, (textoutline))
-        drawtwo.text((150, 16), "Welcome", font=welcome_font, fill=(fontcolor))
-
-        if len(uname) <= 17:
-            _outline((152, 63), uname, 1, name_font, (textoutline))
-            drawtwo.text((152, 63), uname, font=name_font, fill=(fontcolor))
-
-        if len(uname) > 17:
-            if len(uname) <= 23:
-                _outline((152, 66), uname, 1,  name_font_medium, (textoutline))
-                drawtwo.text((152, 66), uname, font=name_font_medium, fill=(fontcolor))
-
-        if len(uname) >= 24:
-            if len(uname) <= 32:
-                _outline((152, 70), uname, 1,  name_font_small, (textoutline))
-                drawtwo.text((152, 70), uname, font=name_font_small, fill=(fontcolor))
-
-        if len(uname) >= 33:
-            drawtwo.text((152, 73), uname, 1,  name_font_smallest, (textoutline))
-            drawtwo.text((152, 73), uname, font=name_font_smallest, fill=(fontcolor))
-
-        if test_member_number is None:
-            members = sorted(server.members,
-                               key=lambda m: m.joined_at).index(member) + 1
-        else:
-            members = test_member_number
-
-        member_number = str(members) + self._get_suffix(members)
-        sname = str(member.server.name) + '!' if len(str(member.server.name)) <= 28 else str(member.server.name)[:23] + '...'
-
-        _outline((152, 96), "You are the " + str(member_number) + " member", 1, server_font, (textoutline))
-        drawtwo.text((152, 96), "You are the " + str(member_number) + " member", font=server_font, fill=(servercolor))
-        _outline((152, 116), 'of ' + sname, 1, server_font, (textoutline))
-        drawtwo.text((152, 116), 'of ' + sname, font=server_font, fill=(servercolor))
-
-        image_object = BytesIO()
-        welcome_picture.save(image_object, format="PNG")
-        image_object.seek(0)
-        return image_object
-
-    async def _circle_border(self, circle_img_size: tuple):
-        border_size = []
-        for i in range(len(circle_img_size)):
-            border_size.append(circle_img_size[0] + 8)
-        return tuple(border_size)
-
-    async def _data_check(self, ctx):
-        server = ctx.message.server
-        if server.id not in self.settings:
-            self.settings[server.id] = deepcopy(default_settings)
-            self.settings[server.id]["CHANNEL"] = ctx.message.channel.id
-            await self.save_settings()
-
-        if "BONUSES" not in self.settings[server.id].keys():
-            self.settings[server.id]["BONUSES"] = {"ACCOUNT_WARNINGS": True,
-                                                   "SPECIAL_USERS": True
-                                                   }
-            await self.save_settings()
-
-        if "CIRCLE" not in self.settings[server.id].keys():
-            self.settings[server.id]["CIRCLE"] = [128, 128]
-            await self.save_settings()
-
-        if "CHANNEL" not in self.settings[server.id].keys():
-            self.settings[server.id]["CHANNEL"] = ctx.message.channel.id
-            await self.save_settings()
-
-        if "FONT" not in self.settings[server.id].keys():
-            self.settings[server.id]["FONT"] = {"WELCOME_FONT": {"PATH": "data/imgwelcome/fonts/UniSansHeavy.otf",
-                                                                  "SIZE": 50},
-                                                "SERVER_FONT": {"PATH": "data/imgwelcome/fonts/UniSansHeavy.otf",
-                                                                 "SIZE": 20},
-                                                "NAME_FONT": {"PATH": "data/imgwelcome/fonts/UniSansHeavy.otf",
-                                                               "SIZE": {"NORMAL": 30,
-                                                                         "MEDIUM": 22,
-                                                                         "SMALL": 18,
-                                                                         "SMALLEST": 12
-                                                                        }
-                                                                }
-                                                }
-
-        if "OUTLINE" not in self.settings[server.id].keys():
-            self.settings[server.id]["OUTLINE"] = [0, 0, 0, 255]
-            await self.save_settings()
-
-    async def _get_profile(self, url):
-        async with aiohttp.get(url) as r:
-            image = await r.content.read()
-        with open('data/imgwelcome/profilepic.png', 'wb') as f:
-            f.write(image)
-
-    def _get_suffix(self, num):
-        suffixes = {1: 'st', 2: 'nd', 3: 'rd'}
-        if 10 <= num % 100 <= 20:
-            suffix = 'th'
-        else:
-            suffix = suffixes.get(num % 10, 'th')
-        return suffix
-
-    def _hex_to_rgb(self, hex_num: str, a: int):
-        h = hex_num.lstrip('#')
-
-        # if only 3 characters are given
-        if len(str(h)) == 3:
-            expand = ''.join([x*2 for x in str(h)])
-            h = expand
-
-        colors = [int(h[i:i+2], 16) for i in (0, 2, 4)]
-        colors.append(a)
-        return tuple(colors)
-
-    def _is_hex(self, color: str):
-        if color is not None and len(color) != 4 and len(color) != 7:
-            return False
-
-        reg_ex = r'^#(?:[0-9a-fA-F]{3}){1,2}$'
-        return re.search(reg_ex, str(color))
-
-    def _rgb_to_hex(self, rgb):
-        rgb = tuple(rgb[:3])
-        return '#%02x%02x%02x' % rgb
-
-    @checks.admin_or_permissions(manage_server=True)
-    @commands.group(pass_context=True)
-    async def imgwelcome(self, ctx):
-        """Configuration options for the welcome image."""
-        if ctx.invoked_subcommand is None:
-            await send_cmd_help(ctx)
-            return
-
-    @imgwelcome.command(pass_context=True, name="border", no_pm=True)
-    async def imgwelcome_border(self, ctx, bordercolor=None):
-        """Set the profile image border color.
-        Use hex codes for colors and ‘clear’ for transparent."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        default_a = 230
-        valid = True
-
-        if bordercolor == "clear":
-            self.settings[server.id]["BORDER"] = [0, 0, 0, 0]
-        elif self._is_hex(bordercolor):
-            self.settings[server.id]["BORDER"] = self._hex_to_rgb(bordercolor, default_a)
-        else:
-            await self.bot.say('Border color is invalid. Use #000000 as a format.')
-            valid = False
-
-        if valid:
-            await self.bot.say('The profile border color has been set.')
-            await self.save_settings()
-
-    @imgwelcome.command(pass_context=True, name="channel", no_pm=True)
-    async def imgwelcome_channel(self, ctx, channel: discord.Channel):
-        """Set the announcement channel."""
-        server = ctx.message.server
-        if not server.me.permissions_in(channel).send_messages:
-            await self.bot.say("No permissions to speak in that channel.")
-            return
-        await self._data_check(ctx)
-        self.settings[server.id]["CHANNEL"] = channel.id
-        await self.save_settings()
-        await self.bot.send_message(channel, "This channel will be used for welcome messages.")
-
-    @imgwelcome.command(name='clear', pass_context=True, no_pm=True)
-    async def imgwelcome_clear(self, ctx):
-        """Set the background to transparent."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]['BACKGROUND'] = 'data/imgwelcome/transparent.png'
-        await self.save_settings()
-        await self.bot.say('Welcome image background is now transparent.')
-
-    @imgwelcome.command(pass_context=True, name="outline", no_pm=True)
-    async def imgwelcome_outline(self, ctx, outline=None):
-        """Set the text outline. White or black."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        valid = True
-        if outline == "white":
-            self.settings[server.id]["OUTLINE"] = [255, 255, 255, 255]
-            await self.save_settings()
-        elif outline == "black":
-            self.settings[server.id]["OUTLINE"] = [0, 0, 0, 255]
-            await self.save_settings()
-        else:
-            await self.bot.say('Outline color is invalid. Use white or black.')
-            valid = False
-
-        if valid:
-            await self.bot.say('The text outline has been set.')
-
-    @imgwelcome.command(name="preview", pass_context=True, no_pm=True)
-    async def imagewelcome_preview(self, ctx, member: discord.Member=None, number: int=None):
-        """Show a welcome image with the current settings."""
-        server = ctx.message.server
-        channel = ctx.message.channel
-        if member is None:
-            member = ctx.message.author
-        await self._data_check(ctx)
-        channel_object = self.bot.get_channel(channel.id)
-        await self.bot.send_typing(channel_object)
-        image_object = await self._create_welcome(member, member.avatar_url, number)
-        await self.bot.send_file(channel_object, image_object, filename="welcome.png")
-
-    @imgwelcome.command(pass_context=True, name="size", no_pm=True)
-    async def imgwelcome_profilesize(self, ctx, profilesize: int):
-        """Set the profile size in pixels. Use one number, 128 is recommended."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        if profilesize is 0:
-            await self.bot.say("Profile picture size must be larger than 0.")
-            return
-        else:
-            self.settings[server.id]["CIRCLE"] = [profilesize, profilesize]
-            await self.save_settings()
-            await self.bot.say('The profile picture size has been set.')
-
-    @imgwelcome.command(pass_context=True, name="text", no_pm=True)
-    async def imgwelcome_text(self, ctx, textcolor: str, servercolor: str):
-        """Set text colors. Use hex code for colors."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        default_a = 230
-        valid = True
-
-        if self._is_hex(textcolor):
-            self.settings[server.id]["TEXT"] = self._hex_to_rgb(textcolor, default_a)
-        else:
-            await self.bot.say('Welcome text color is invalid. Use #000000 as a format.')
-            valid = False
-
-        if self._is_hex(servercolor):
-            self.settings[server.id]["SERVERTEXT"] = self._hex_to_rgb(servercolor, default_a)
-        else:
-            await self.bot.say('Server text color is invalid. Use #000000 as a format.')
-            valid = False
-
-        if valid:
-            await self.bot.say('The text colors have been set.')
-            await self.save_settings()
-
-    @imgwelcome.command(pass_context=True, name="toggle", no_pm=True)
-    async def imgwelcome_toggle(self, ctx):
-        """Toggle welcome messages on the server."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]["ANNOUNCE"] = not self.settings[server.id]["ANNOUNCE"]
-        if self.settings[server.id]["ANNOUNCE"]:
-            await self.bot.say("Now welcoming new users.")
-        else:
-            await self.bot.say("No longer welcoming new users.")
-        await self.save_settings()
-
-    @imgwelcome.command(name='upload', pass_context=True, no_pm=True)
-    async def imgwelcome_upload(self, ctx, default=None):
-        """Upload a background through Discord. 500px x 150px.
-        This must be an image file and not a url."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        await self.bot.say("Please send the file to use as a background. File must be 500px x 150px.")
-        answer = await self.bot.wait_for_message(timeout=30, author=ctx.message.author)
-
-        try:
-            bg_url = answer.attachments[0]["url"]
-            success = True
-        except Exception as e:
-            success = False
-            print(e)
-
-        serverimage = Image
-
-        if success:
-            try:
-                async with aiohttp.get(bg_url) as r:
-                    image = await r.content.read()
-                    if not os.path.exists('data/imgwelcome/{}'.format(server.id)):
-                        os.makedirs('data/imgwelcome/{}'.format(server.id))
-                serverbg = 'data/imgwelcome/{}/serverbg.png'.format(server.id)
-                with open(serverbg, 'wb') as f:
-                    f.write(image)
-                    serverimage = Image.open(serverbg).convert('RGBA')
-                    success = True
-
-            except Exception as e:
-                success = False
-                print(e)
-            if success:
-                if serverimage.size == (500, 150):
-                    self.settings[server.id]['BACKGROUND'] = "data/imgwelcome/" + ctx.message.server.id + "/serverbg.png"
-                    await self.save_settings()
-                else:
-                    await self.bot.say("Image needs to be 500x150.")
-                    return
-                background_img = ('data/imgwelcome/{}/serverbg.png'.format(server.id))
-                self.settings[server.id]['BACKGROUND'] = (background_img)
-                await self.save_settings()
-                await self.bot.say('Welcome image for this server set to uploaded file.')
-            else:
-                await self.bot.say("Couldn't get the image from Discord.")
-        else:
-            await self.bot.say("Couldn't get the image.")
-
-    @imgwelcome.group(pass_context=True, name='bonus', no_pm=True)
-    async def imgwelcome_bonus(self, ctx):
-        """Toggle display of additional text welcome messages when a user joins the server."""
-        if ctx.invoked_subcommand is None or isinstance(ctx.invoked_subcommand, commands.Group):
-            await send_cmd_help(ctx)
-            return
-
-    @imgwelcome_bonus.command(pass_context=True, name='user', no_pm=True)
-    async def bonus_user(self, ctx):
-        """Toggle text announcement when a user is x 100th to join or #1337."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]["BONUSES"]["SPECIAL_USERS"] = not self.settings[server.id]["BONUSES"]["SPECIAL_USERS"]
-        await self.save_settings()
-        if self.settings[server.id]["BONUSES"]["SPECIAL_USERS"]:
-            msg = "I will now announce when special users join."
-        else:
-            msg = "I will no longer announce when special users join."
-        await self.bot.say(msg)
-
-    @imgwelcome_bonus.command(pass_context=True, name='warn', no_pm=True)
-    async def bonus_warn(self, ctx):
-        """Toggle text announcement when a new user's account is <7d old."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]["BONUSES"]["ACCOUNT_WARNINGS"] = not self.settings[server.id]["BONUSES"]["ACCOUNT_WARNINGS"]
-        await self.save_settings()
-        if self.settings[server.id]["BONUSES"]["ACCOUNT_WARNINGS"]:
-            msg = "I will now announce when new accounts join."
-        else:
-            msg = "I will no longer announce when new accounts join."
-        await self.bot.say(msg)
-
-    @imgwelcome.group(pass_context=True, name='font', no_pm=True)
-    async def imgwelcome_font(self, ctx):
-        """Place your font files in the data/imgwelcome/fonts/ directory.
-        Valid font areas to change are: welcome, server and name.
-        """
-        if ctx.invoked_subcommand is None or isinstance(ctx.invoked_subcommand, commands.Group):
-            await send_cmd_help(ctx)
-            return
-
-    @imgwelcome_font.command(pass_context=True, name='list', no_pm=True)
-    async def fontg_list(self, ctx):
-        """List fonts in the directory."""
-        channel = ctx.message.channel
-        directory = "data/imgwelcome/fonts/"
-        fonts = sorted(os.listdir(directory))
-
-        if len(fonts) == 0:
-            await self.bot.send_message(channel, "No fonts found. Place "
-                                        "fonts in /data/imgwelcome/fonts/.")
-            return
-
-        pager = commands.formatter.Paginator(prefix='```', suffix='```', max_size=2000)
-        pager.add_line('Current fonts:')
-        for font_name in fonts:
-            pager.add_line(font_name)
-        for page in pager.pages:
-            await self.bot.send_message(channel, page)
-
-    @imgwelcome_font.command(pass_context=True, name='name', no_pm=True)
-    async def fontg_name(self, ctx, font_name: str, size: int=None):
-        """Change the name text font.
-        e.g. [p]imgwelcome font name "UniSansHeavy.otf"
-        """
-        await self._data_check(ctx)
-        server = ctx.message.server
-
-        directory = "data/imgwelcome/fonts/"
-        if size is None:
-            size = self.settings[server.id]["FONT"]["NAME_FONT"]["SIZE"]["NORMAL"]
-
-        try:
-            ImageFont.truetype(directory + font_name, size)
-        except:
-            await self.bot.say("I could not find that font file.")
-            return
-
-        self.settings[server.id]["FONT"]["NAME_FONT"]["PATH"] = directory + font_name
-        self.settings[server.id]["FONT"]["NAME_FONT"]["SIZE"]["NORMAL"] = size
-        self.settings[server.id]["FONT"]["NAME_FONT"]["SIZE"]["MEDIUM"] = size - 8
-        self.settings[server.id]["FONT"]["NAME_FONT"]["SIZE"]["SMALL"] = size - 12
-        self.settings[server.id]["FONT"]["NAME_FONT"]["SIZE"]["SMALLEST"] = size - 18
-        await self.save_settings()
-        await self.bot.say("Name font changed to: {}".format(font_name[:-4]))
-
-    @imgwelcome_font.command(pass_context=True, name='server', no_pm=True)
-    async def fontg_server(self, ctx, font_name: str, size: int=None):
-        """Change the server text font."""
-        await self._data_check(ctx)
-        server = ctx.message.server
-
-        directory = "data/imgwelcome/fonts/"
-        if size is None:
-            size = self.settings[server.id]["FONT"]["SERVER_FONT"]["SIZE"]
-
-        try:
-            ImageFont.truetype(directory + font_name, size)
-        except:
-            await self.bot.say("I could not find that font file.")
-            return
-
-        self.settings[server.id]["FONT"]["SERVER_FONT"]["PATH"] = directory + font_name
-        self.settings[server.id]["FONT"]["SERVER_FONT"]["SIZE"] = size
-        await self.save_settings()
-        await self.bot.say("Server text font changed to: {}".format(font_name[:-4]))
-        pass
-
-    @imgwelcome_font.command(pass_context=True, name='welcome', no_pm=True)
-    async def fontg_welcome(self, ctx, font_name: str, size: int=None):
-        """Change the welcome text font."""
-        # try open file_name, if fail tell user
-        # if opens change settings, tell user success
-        # if file_name doesn't exist, list available fonts
-        await self._data_check(ctx)
-        server = ctx.message.server
-
-        directory = "data/imgwelcome/fonts/"
-        if size is None:
-            size = self.settings[server.id]["FONT"]["WELCOME_FONT"]["SIZE"]
-
-        try:
-            ImageFont.truetype(directory + font_name, size)
-        except:
-            await self.bot.say("I could not find that font file.")
-            return
-
-        self.settings[server.id]["FONT"]["WELCOME_FONT"]["PATH"] = directory + font_name
-        self.settings[server.id]["FONT"]["WELCOME_FONT"]["SIZE"] = size
-        await self.save_settings()
-        await self.bot.say("Welcome font changed to: {}".format(font_name[:-4]))
-        pass
-
-    @imgwelcome.command(name="version", pass_context=True, hidden=True)
-    async def imagewelcomeset_version(self):
-        """Displays the imgwelcome version."""
-        await self.bot.say("imgwelcome version {}.".format(self.version))
-
-    async def on_member_join(self, member):
-        server = member.server
-        if server.id not in self.settings:
-            self.settings[server.id] = deepcopy(default_settings)
-            await self.save_settings()
-        if not self.settings[server.id]["ANNOUNCE"]:
-            return
-        channelid = self.settings[server.id]["CHANNEL"]
-        channel_object = self.bot.get_channel(channelid)
-        await self.bot.send_typing(channel_object)
-        image_object = await self._create_welcome(member, member.avatar_url)
-        await self.bot.send_file(channel_object, image_object, filename="welcome.png")
-        if (len(member.server.members) % 100) == 0 or (len(member.server.members) == 1337) and self.settings[server.id]["SPECIAL_USERS"]:
-            msg = "\N{PARTY POPPER} Thanks <@" + member.id + ">, you're the ***" + str(len(member.server.members)) + "*** th user on this server! \N{PARTY POPPER}"
-            await self.bot.send_message(channel_object, msg)
-        date_join = datetime.datetime.strptime(str(member.created_at), "%Y-%m-%d %H:%M:%S.%f")
-        date_now = datetime.datetime.now(datetime.timezone.utc)
-        date_now = date_now.replace(tzinfo=None)
-        since_join = date_now - date_join
-        if since_join.days < 7 and self.settings[server.id]["ACCOUNT_WARNINGS"]:
-            await self.bot.send_message(channel_object, "\N{WARNING SIGN} This account was created less than a week ago (" + str(since_join.days) + " days ago)")
-
-
-def check_folders():
-    if not os.path.exists('data/imgwelcome/'):
-        os.mkdir('data/imgwelcome/')
-
-
-def check_files():
-    if not dataIO.is_valid_json('data/imgwelcome/settings.json'):
-        defaults = {}
-        dataIO.save_json('data/imgwelcome/settings.json', defaults)
-
-
-def setup(bot):
-    check_folders()
-    check_files()
-    bot.add_cog(ImgWelcome(bot))

imgwelcome/info.json

@@ -1,9 +0,0 @@
-{
-    "AUTHOR" : "aikaterna",
-    "INSTALL_MSG" : "Use [p]imgwelcome to change settings.",
-    "NAME" : "imgwelcome",
-    "SHORT" : "Welcome users to your server with an image.",
-    "DESCRIPTION" : "Welcome users to your server with an image.",
-    "REQUIREMENTS": ["Pillow"],
-    "TAGS": ["welcome", "welcome image", "images"]
-}

info.json

@@ -1,7 +1,7 @@
 {
-    "AUTHOR" : "aikaterna",
+    "author" : ["aikaterna (aikaterna#1393)"],
-    "INSTALL_MSG" : "Thanks for installing. Please PR any issues or code changes, I'm sure some cogs of mine will need some work.",
+    "install_msg" : "Thanks for installing. Please submit issue reports on my repo if something's broken. You can find me in the Red servers or at the invite on my repo.",
-    "NAME" : "aikaterna-cogs",
+    "name" : "aikaterna-cogs",
-    "SHORT" : "Some cogs I've mashed together while learning Python.",
+    "short" : "Utility and fun cogs",
-    "DESCRIPTION" : "Someday, this repository will have cogs that I actually wrote by myself. Until then, enjoy my learning process of taking code and modifying it."
+    "description" : "Cogs requested by others, personal cogs, or orphaned cogs."
 }

inspirobot/__init__.py

@@ -0,0 +1,7 @@
+from .inspirobot import Inspirobot
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Inspirobot(bot))

inspirobot/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna"],
+    "description": "Fetch a random 'inspiring' message from http://inspirobot.me",
+    "install_msg": "Thanks for installing, have fun.",
+    "permissions" : ["embed_links"],
+    "short": "Fetch 'inspiring' messages.",
+    "tags": ["inspire", "inspirobot"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

inspirobot/inspirobot.py

@@ -0,0 +1,30 @@
+import aiohttp
+import discord
+from redbot.core import commands
+
+
+class Inspirobot(commands.Cog):
+    """Posts images generated by https://inspirobot.me"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.session = aiohttp.ClientSession()
+
+    @commands.command()
+    async def inspireme(self, ctx):
+        """Fetch a random "inspirational message" from the bot."""
+        try:
+            async with self.session.request("GET", "http://inspirobot.me/api?generate=true") as page:
+                pic = await page.text(encoding="utf-8")
+                em = discord.Embed()
+                em.set_image(url=pic)
+                await ctx.send(embed=em)
+        except Exception as e:
+            await ctx.send(f"Oops, there was a problem: {e}")
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

invites/__init__.py

@@ -0,0 +1,7 @@
+from .invites import Invites
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Invites(bot))

invites/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna"],
+    "description": "Invite count display and leaderboard.",
+    "install_msg": "Thanks for installing. Use `[p]invites` to get started.",
+    "short": "Invite count display and leaderboard.",
+    "tags": ["invites"],
+    "permissions": ["administrator", "embed_links"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

invites/invites.py

@@ -0,0 +1,316 @@
+from __future__ import annotations
+import discord
+from datetime import datetime
+import re
+from typing import List, Callable
+from redbot.core import commands, checks, Config
+from redbot.core.utils import chat_formatting as cf
+from redbot.vendored.discord.ext import menus
+
+
+OLD_CODE_RE = re.compile("^[0-9a-zA-Z]{16}$")
+CODE_RE = re.compile("^[0-9a-zA-Z]{6,7}$")
+NEW10_CODE_RE = re.compile("^[0-9a-zA-Z]{10}$")
+NEW8_CODE_RE = re.compile("^[0-9a-zA-Z]{8}$")
+
+FAILURE_MSG = "That invite doesn't seem to be valid."
+PERM_MSG = "I need the Administrator permission on this guild to view invite information."
+
+__version__ = "0.0.7"
+
+
+class Invites(commands.Cog):
+    def __init__(self, bot):
+        self.bot = bot
+        self.config = Config.get_conf(self, 2713371001, force_registration=True)
+
+        default_guild = {"pinned_invites": []}
+
+        self.config.register_guild(**default_guild)
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete"""
+        return
+
+    @commands.guild_only()
+    @commands.group()
+    async def invites(self, ctx: commands.Context):
+        """Invite information."""
+        pass
+
+    @commands.max_concurrency(1, commands.BucketType.user)
+    @invites.command()
+    async def show(self, ctx: commands.Context, invite_code_or_url: str = None):
+        """Show the stats for an invite, or show all invites."""
+        if not ctx.me.permissions_in(ctx.channel).administrator:
+            return await self._send_embed(ctx, PERM_MSG)
+
+        if not invite_code_or_url:
+            pages = MenuInvitePages(await ctx.guild.invites())
+        else:
+            invite_code = await self._find_invite_code(invite_code_or_url)
+            if not invite_code:
+                return await self._send_embed(ctx, FAILURE_MSG)
+            pages = MenuInvitePages([x for x in await ctx.guild.invites() if x.code == invite_code])
+        await self._menu(ctx, pages)
+
+    @invites.command()
+    async def leaderboard(self, ctx: commands.Context, list_all_invites: bool = False):
+        """List pinned invites or all invites in a leaderboard style."""
+        if not ctx.me.permissions_in(ctx.channel).administrator:
+            return await self._send_embed(ctx, PERM_MSG)
+
+        if not list_all_invites:
+            pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+            if not pinned_invites:
+                return await self._send_embed(ctx, "No invites are pinned, or there are no invites to display.")
+        else:
+            pinned_invites = await ctx.guild.invites()
+        invite_info = ""
+        for i, invite_code_or_object in enumerate(pinned_invites):
+            if not list_all_invites:
+                inv_object = await self._get_invite_from_code(ctx, invite_code_or_object)
+            else:
+                inv_object = invite_code_or_object
+            if not inv_object:
+                # Someone deleted a pinned invite or it expired
+                pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+                pinned_invites.remove(invite_code_or_object)
+                await self.config.guild(ctx.guild).pinned_invites.set(pinned_invites)
+                continue
+            max_uses = await self.get_invite_max_uses(ctx, inv_object)
+            inv_details = f"{i+1}. {inv_object.url} [ {inv_object.uses} uses / {max_uses} max ]\n"
+            invite_info += inv_details
+
+        pagified_stings = [x for x in cf.pagify(invite_info, delims=["\n"], shorten_by=16)]
+        pages = MenuLeaderboardPages(ctx, pagified_stings, show_all=list_all_invites)
+        await self._menu(ctx, pages)
+
+    @invites.command(aliases=["listpinned"])
+    async def listpin(self, ctx: commands.Context):
+        """List pinned invites."""
+        pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+        invite_list = "None." if len(pinned_invites) == 0 else "\n".join(pinned_invites)
+        await self._send_embed(ctx, "Pinned Invites", invite_list)
+
+    @invites.command()
+    async def pin(self, ctx: commands.Context, invite_code_or_url: str):
+        """Pin an invite to the leaderboard."""
+        if not ctx.me.permissions_in(ctx.channel).administrator:
+            return await self._send_embed(ctx, PERM_MSG)
+
+        invite_code = await self._find_invite_code(invite_code_or_url)
+        invite_code = await self._check_invite_code(ctx, invite_code)
+        if not invite_code:
+            return await self._send_embed(ctx, FAILURE_MSG)
+
+        existing_pins = await self.config.guild(ctx.guild).pinned_invites()
+        if invite_code not in existing_pins:
+            existing_pins.append(invite_code)
+            await self.config.guild(ctx.guild).pinned_invites.set(existing_pins)
+            await self._send_embed(ctx, f"{invite_code} was added to the pinned list.")
+        else:
+            await self._send_embed(ctx, f"{invite_code} is already in the pinned list.")
+
+    @invites.command()
+    async def unpin(self, ctx: commands.Context, invite_code_or_url: str):
+        """Unpin an invite from the leaderboard."""
+        invite_code = await self._find_invite_code(invite_code_or_url)
+        if not invite_code:
+            return await self._send_embed(ctx, FAILURE_MSG)
+
+        pinned_invites = await self.config.guild(ctx.guild).pinned_invites()
+        if invite_code in pinned_invites:
+            pinned_invites.remove(invite_code)
+        else:
+            return await self._send_embed(ctx, f"{invite_code} isn't in the pinned list.")
+        await self.config.guild(ctx.guild).pinned_invites.set(pinned_invites)
+        await self._send_embed(ctx, f"{invite_code} was removed from the pinned list.")
+
+    @invites.command(hidden=True)
+    async def version(self, ctx):
+        """Invites version."""
+        await self._send_embed(ctx, __version__)
+
+    @staticmethod
+    async def _check_invite_code(ctx: commands.Context, invite_code: str):
+        for invite in await ctx.guild.invites():
+            if invite.code == invite_code:
+                return invite_code
+            else:
+                continue
+
+            return None
+
+    @staticmethod
+    async def _find_invite_code(invite_code_or_url: str):
+        invite_match = (
+            re.fullmatch(OLD_CODE_RE, invite_code_or_url)
+            or re.fullmatch(CODE_RE, invite_code_or_url)
+            or re.fullmatch(NEW10_CODE_RE, invite_code_or_url)
+            or re.fullmatch(NEW8_CODE_RE, invite_code_or_url)
+        )
+        if invite_match:
+            return invite_code_or_url
+        else:
+            sep = invite_code_or_url.rfind("/")
+            if sep:
+                try:
+                    invite_code = invite_code_or_url.rsplit("/", 1)[1]
+                    return invite_code
+                except IndexError:
+                    return None
+
+            return None
+
+    @staticmethod
+    async def _get_invite_from_code(ctx: commands.Context, invite_code: str):
+        for invite in await ctx.guild.invites():
+            if invite.code == invite_code:
+                return invite
+            else:
+                continue
+
+            return None
+
+    @classmethod
+    async def get_invite_max_uses(self, ctx: commands.Context, invite_object: discord.Invite):
+        if invite_object.max_uses == 0:
+            return "\N{INFINITY}"
+        else:
+            return invite_object.max_uses
+
+    async def _menu(self, ctx: commands.Context, pages: List[discord.Embed]):
+        # `wait` in this function is whether the menus wait for completion.
+        # An example of this is with concurrency:
+        # If max_concurrency's wait arg is False (the default):
+        # This function's wait being False will not follow the expected max_concurrency behaviour
+        # This function's wait being True will follow the expected max_concurrency behaviour
+        await MenuActions(source=pages, delete_message_after=False, clear_reactions_after=True, timeout=180).start(
+            ctx, wait=True
+        )
+
+    @staticmethod
+    async def _send_embed(ctx: commands.Context, title: str = None, description: str = None):
+        title = "\N{ZERO WIDTH SPACE}" if title is None else title
+        embed = discord.Embed()
+        embed.title = title
+        if description:
+            embed.description = description
+        embed.colour = await ctx.embed_colour()
+        await ctx.send(embed=embed)
+
+
+class MenuInvitePages(menus.ListPageSource):
+    def __init__(self, methods: List[discord.Invite]):
+        super().__init__(methods, per_page=1)
+
+    async def format_page(self, menu: MenuActions, invite: discord.Invite) -> discord.Embed:
+        # Use the menu to generate pages as they are needed instead of giving it a list of
+        # already-generated embeds.
+        embed = discord.Embed(title=f"Invites for {menu.ctx.guild.name}")
+        max_uses = await Invites.get_invite_max_uses(menu.ctx, invite)
+        msg = f"{cf.bold(invite.url)}\n\n"
+        msg += f"Uses: {invite.uses}/{max_uses}\n"
+        msg += f"Target Channel: {invite.channel.mention}\n"
+        msg += f"Created by: {invite.inviter.mention}\n"
+        msg += f"Created at: {invite.created_at.strftime('%m-%d-%Y @ %H:%M:%S UTC')}\n"
+        if invite.temporary:
+            msg += "Temporary invite\n"
+        if invite.max_age == 0:
+            max_age = f""
+        else:
+            max_age = f"Max age: {self._dynamic_time(int(invite.max_age))}"
+        msg += f"{max_age}"
+        embed.description = msg
+
+        return embed
+
+    @staticmethod
+    def _dynamic_time(time: int):
+        m, s = divmod(time, 60)
+        h, m = divmod(m, 60)
+        d, h = divmod(h, 24)
+
+        if d > 0:
+            msg = "{0}d {1}h"
+        elif d == 0 and h > 0:
+            msg = "{1}h {2}m"
+        elif d == 0 and h == 0 and m > 0:
+            msg = "{2}m {3}s"
+        elif d == 0 and h == 0 and m == 0 and s > 0:
+            msg = "{3}s"
+        else:
+            msg = ""
+        return msg.format(d, h, m, s)
+
+
+class MenuLeaderboardPages(menus.ListPageSource):
+    def __init__(self, ctx: commands.Context, entries: List[str], show_all: bool):
+        super().__init__(entries, per_page=1)
+        self.show_all = show_all
+        self.ctx = ctx
+
+    async def format_page(self, menu: MenuActions, page: str) -> discord.Embed:
+        embed = discord.Embed(title=f"Invite Usage for {self.ctx.guild.name}", description=page)
+        if self.show_all is False:
+            embed.set_footer(text="Only displaying pinned invites.")
+        else:
+            embed.set_footer(text="Displaying all invites.")
+        return embed
+
+
+class MenuActions(menus.MenuPages, inherit_buttons=False):
+    def reaction_check(self, payload):
+        """The function that is used to check whether the payload should be processed.
+        This is passed to :meth:`discord.ext.commands.Bot.wait_for <Bot.wait_for>`.
+
+        There should be no reason to override this function for most users.
+        This is done this way in this cog to let a bot owner operate the menu
+        along with the original command invoker.
+
+        Parameters
+        ------------
+        payload: :class:`discord.RawReactionActionEvent`
+            The payload to check.
+
+        Returns
+        ---------
+        :class:`bool`
+            Whether the payload should be processed.
+        """
+        if payload.message_id != self.message.id:
+            return False
+        if payload.user_id not in (*self.bot.owner_ids, self._author_id):
+            return False
+
+        return payload.emoji in self.buttons
+
+    async def show_checked_page(self, page_number: int) -> None:
+        # This is a custom impl of show_checked_page that allows looping around back to the
+        # beginning of the page stack when at the end and using next, or looping to the end
+        # when at the beginning page and using prev.
+        max_pages = self._source.get_max_pages()
+        try:
+            if max_pages is None:
+                await self.show_page(page_number)
+            elif page_number >= max_pages:
+                await self.show_page(0)
+            elif page_number < 0:
+                await self.show_page(max_pages - 1)
+            elif max_pages > page_number >= 0:
+                await self.show_page(page_number)
+        except IndexError:
+            pass
+
+    @menus.button("\N{UP-POINTING RED TRIANGLE}", position=menus.First(1))
+    async def prev(self, payload: discord.RawReactionActionEvent):
+        await self.show_checked_page(self.current_page - 1)
+
+    @menus.button("\N{DOWN-POINTING RED TRIANGLE}", position=menus.First(2))
+    async def next(self, payload: discord.RawReactionActionEvent):
+        await self.show_checked_page(self.current_page + 1)
+
+    @menus.button("\N{CROSS MARK}", position=menus.Last(0))
+    async def close_menu(self, payload: discord.RawReactionActionEvent) -> None:
+        self.stop()

latex/__init__.py

@@ -0,0 +1,6 @@
+from .latex import Latex
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+def setup(bot):
+  bot.add_cog(Latex(bot))

latex/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna", "Stevy"],
+    "description": "Generates an image for a LaTeX expression.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Generates an image for a LaTeX expression.",
+    "tags": ["latex"],
+    "requirements": ["pillow"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

latex/latex.py

@@ -0,0 +1,64 @@
+import aiohttp
+import discord
+import io
+import logging
+import re
+from PIL import Image, ImageOps
+import urllib.parse as parse
+from redbot.core import commands
+
+
+log = logging.getLogger("red.aikaterna.latex")
+
+START_CODE_BLOCK_RE = re.compile(r"^((```(la)?tex)(?=\s)|(```))")
+
+
+class Latex(commands.Cog):
+    """LaTeX expressions via an image."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete."""
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.session = aiohttp.ClientSession()
+
+    @staticmethod
+    def cleanup_code_block(content):
+        # remove ```latex\n```/```tex\n```/``````
+        if content.startswith("```") and content.endswith("```"):
+            return START_CODE_BLOCK_RE.sub("", content)[:-3]
+        
+        # remove `foo`
+        return content.strip("` \n")
+
+    @commands.guild_only()
+    @commands.command()
+    async def latex(self, ctx, *, equation):
+        """Takes a LaTeX expression and makes it pretty."""
+        base_url = "https://latex.codecogs.com/gif.latex?%5Cbg_white%20%5CLARGE%20"
+        equation = self.cleanup_code_block(equation)
+        equation = parse.quote(equation)
+        url = f"{base_url}{equation}"
+
+        try:
+            async with self.session.get(url) as r:
+                image = await r.read()
+            image = Image.open(io.BytesIO(image)).convert("RGBA")
+        except Exception as exc:
+            log.exception("Something went wrong while trying to read the image:\n ", exc_info=exc)
+            image = None
+
+        if not image:
+            return await ctx.send("I can't get the image from the website, check your console for more information.")
+
+        image = ImageOps.expand(image, border=10, fill="white")
+        image_file_object = io.BytesIO()
+        image.save(image_file_object, format="png")
+        image_file_object.seek(0)
+        image_final = discord.File(fp=image_file_object, filename="latex.png")
+        await ctx.send(file=image_final)
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())

luigipoker/__init__.py

@@ -0,0 +1,7 @@
+from .luigipoker import LuigiPoker
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(LuigiPoker(bot))

luigipoker/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["aikaterna", "themario30"],
+    "description": "Play the Luigi Poker minigame from New Super Mario Brothers.",
+    "install_msg": "Thanks for installing.",
+    "short": "A Luigi poker minigame.",
+    "tags": ["poker", "game"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

luigipoker/luigipoker.py

@@ -0,0 +1,428 @@
+import asyncio
+import logging
+from random import randint
+from redbot.core import commands
+from redbot.core.utils.chat_formatting import box
+from redbot.core.utils.predicates import MessagePredicate
+
+
+log = logging.getLogger("red.aikaterna.luigipoker")
+
+
+class Card:
+    def __init__(self, card_number=None):
+        self._number = card_number if card_number else randint(1, 6)
+        self._suit = self._suit()
+
+    def _suit(self):
+        if self._number == 1:
+            suit = "\N{CLOUD}\N{VARIATION SELECTOR-16}"
+        elif self._number == 2:
+            suit = "\N{MUSHROOM}"
+        elif self._number == 3:
+            suit = "\N{SUNFLOWER}"
+        elif self._number == 4:
+            suit = "\N{LARGE GREEN SQUARE}"
+        elif self._number == 5:
+            suit = "\N{LARGE RED SQUARE}"
+        elif self._number == 6:
+            suit = "\N{WHITE MEDIUM STAR}"
+        else:
+            suit = "Error!"
+
+        return suit
+
+    def __repr__(self):
+        return f"{self._suit}"
+
+    def num(self):
+        return self._number
+
+    def suit(self):
+        return self._suit
+
+
+class Deck:
+    def __init__(self):
+        self._length = 5
+        self._deck = self._create_deck()
+        self.first_pair = 0
+        self.second_pair = 0
+        self.new_deck()
+
+    def _create_deck(self):
+        temp = [Card() for x in range(0, self._length)]
+        return temp
+
+    def _new_card(self, i):
+        self._deck[i] = Card()
+
+    def _sort_deck(self):
+        self._deck.sort(key=lambda x: x.num(), reverse=True)
+
+    def new_deck(self):
+        self._deck = self._create_deck()
+        self._sort_deck()
+
+    def deck(self):
+        return self._deck
+
+    def num(self, i):
+        return self._deck[i].num()
+
+    def swap(self, i):
+        for x in i:
+            self._new_card(int(x) - 1)
+        self._sort_deck()
+
+    def suit(self, i):
+        return self._deck[i].suit()
+
+    def len(self):
+        return self._length
+
+
+class LuigiPoker(commands.Cog):
+    """The Luigi Poker minigame from New Super Mario Brothers."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    __version__ = "0.1.2"
+
+    def __init__(self, bot):
+        self.bot = bot
+        self._in_game = {}
+        self._hit = {}
+        self.player_deck = Deck()
+        self.dealer_deck = Deck()
+
+    @commands.group()
+    async def poker(self, ctx):
+        """The Luigi Poker minigame from New Super Mario Brothers."""
+        if ctx.invoked_subcommand is None:
+            space = "\N{EN SPACE}"
+            msg = (
+                f"I'm Luigi, Number 1!\n"
+                f"This game plays the same as Luigi's "
+                f"Poker in Super Mario 64 DS Minigames.\n"
+                f"The card's worth is based on the suit.\n"
+                f"Starman > Mario > Luigi > Fire Flower > Mushroom > Cloud.\n"
+                f"{space*3}{Card(6)}{space*4}>{space*3}{Card(5)}{space*3}>{space*3}{Card(4)}{space*3}"
+                f">{space*6}{Card(3)}{space*6}>{space*4}{Card(2)}{space*5}>{space*4}{Card(1)}\n"
+                f"---------------------------------------------------------\n"
+                f"The following table represents the winning matches.\n"
+                f"For example, a Full House is greater than Three of a Kind, but "
+                f"less than a Four of a Kind.\n"
+                f"---------------------------------------------------------\n"
+                f"Flush:           {Card(6)}{Card(6)}{Card(6)}{Card(6)}{Card(6)}\n"
+                f"Four of a Kind:  {Card(6)}{Card(6)}{Card(6)}{Card(6)}\n"
+                f"Full House:      {Card(6)}{Card(6)}{Card(6)}{Card(3)}{Card(3)}\n"
+                f"Three of a Kind: {Card(6)}{Card(6)}{Card(6)}\n"
+                f"Two Pairs:       {Card(6)}{Card(6)}{Card(2)}{Card(2)}\n"
+                f"Pair:            {Card(6)}{Card(6)}\n"
+            )
+            await ctx.send(box(msg))
+            return await ctx.send(
+                f"Are you ready to play my game?! What are you waiting for? Start the game using `{ctx.prefix}poker play`!"
+            )
+
+    @poker.command()
+    async def play(self, ctx):
+        """Starts the Game!"""
+        if not self._in_game.get(ctx.guild.id, False):
+            self._in_game[ctx.guild.id] = True
+            self.player_deck.new_deck()
+            self.dealer_deck.new_deck()
+        else:
+            return await ctx.send("You're already in a game...")
+
+        square = "\N{WHITE MEDIUM SMALL SQUARE}"
+        msg = (
+            f"Dealer's Deck: {square*5}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+
+        await ctx.send(box(msg))
+
+        if self._hit.get(ctx.guild.id, False):
+            await ctx.send("`Stay` or `fold`?")
+            answers = ["stay", "fold"]
+        else:
+            await ctx.send("`Stay`, `hit`, or `fold`?")
+            answers = ["stay", "hit", "fold"]
+        await self._play_response(ctx, answers)
+
+    async def _play_response(self, ctx, answers):
+        pred = MessagePredicate.lower_contained_in(answers, ctx=ctx)
+        try:
+            user_resp = await ctx.bot.wait_for("message", timeout=120, check=pred)
+        except asyncio.TimeoutError:
+            await ctx.send("No response.")
+            return await self.fold(ctx)
+        if "stay" in user_resp.content.lower():
+            return await self.stay(ctx)
+        elif "hit" in user_resp.content.lower():
+            return await self.hit(ctx)
+        elif "fold" in user_resp.content.lower():
+            return await self.fold(ctx)
+        else:
+            log.error(
+                "LuigiPoker: Something broke unexpectedly in _play_response. Please report it.", exc_info=True,
+            )
+
+    async def hit(self, ctx):
+        card_question = await ctx.send(
+            "What cards do you want to swap out?\n"
+            "Use numbers 1 through 5 to specify, with commas in between.\n"
+            "Examples: `1,3,5` or `4, 5`"
+        )
+        try:
+            user_resp = await ctx.bot.wait_for("message", timeout=60, check=MessagePredicate.same_context(ctx))
+        except asyncio.TimeoutError:
+            await ctx.send("No response.")
+            return await self.fold(ctx)
+
+        user_answers = user_resp.content.strip().split(",")
+        user_answers_valid = list(set(user_answers) & set(["1", "2", "3", "4", "5"]))
+        if len(user_answers_valid) == 0:
+            return await self.hit(ctx)
+
+        await ctx.send("Swapping Cards...")
+        self.player_deck.swap(user_answers_valid)
+        square = "\N{WHITE MEDIUM SMALL SQUARE}"
+        msg = (
+            f"Dealer's Deck: {square*5}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+        await ctx.send(box(msg))
+        await ctx.send("`Stay` or `fold`?")
+        self._hit[ctx.guild.id] = True
+        answers = ["stay", "fold"]
+        await self._play_response(ctx, answers)
+
+    async def fold(self, ctx):
+        msg = "You have folded.\n"
+        msg += box(
+            f"Dealer's Deck: {self.dealer_deck.suit(0)}{self.dealer_deck.suit(1)}"
+            f"{self.dealer_deck.suit(2)}{self.dealer_deck.suit(3)}{self.dealer_deck.suit(4)}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+
+        self._in_game[ctx.guild.id] = False
+        self._hit[ctx.guild.id] = False
+        await ctx.send(msg)
+
+    async def stay(self, ctx):
+        say = ""
+        win = False
+        same_move = False
+        tied = False
+
+        # Flush
+        if self.flush(self.player_deck) != self.flush(self.dealer_deck):
+            say = "a Flush"
+            if self.flush(self.player_deck):
+                win = True
+        elif self.flush(self.player_deck) and self.flush(self.dealer_deck):
+            say = "Flush"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+
+        # Four of a Kind
+        elif self.four_of_a_kind(self.player_deck) != self.four_of_a_kind(self.dealer_deck):
+            say = "a Four of a Kind"
+            if self.four_of_a_kind(self.player_deck):
+                win = True
+        elif self.four_of_a_kind(self.player_deck) and self.four_of_a_kind(self.dealer_deck):
+            say = "Four of a Kind"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+
+        # Full House
+        elif self.full_house(self.player_deck) != self.full_house(self.dealer_deck):
+            say = "a Full House"
+            if self.full_house(self.player_deck):
+                win = True
+        elif self.full_house(self.player_deck) and self.full_house(self.dealer_deck):
+            say = "Full House"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.second_pair > self.dealer_deck.second_pair:
+                win = True
+            elif (
+                self.player_deck.first_pair == self.dealer_deck.first_pair
+                and self.player_deck.second_pair == self.dealer_deck.second_pair
+            ):
+                tied = True
+
+        # Full House
+        elif self.three_of_a_kind(self.player_deck) != self.three_of_a_kind(self.dealer_deck):
+            say = "a Three of a Kind"
+            if self.three_of_a_kind(self.player_deck):
+                win = True
+        elif self.three_of_a_kind(self.player_deck) and self.three_of_a_kind(self.dealer_deck):
+            say = "Three of a Kind"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+
+        # Two Pairs
+        elif self.two_pair(self.player_deck) != self.two_pair(self.dealer_deck):
+            say = "Two Pairs"
+            if self.two_pair(self.player_deck):
+                win = True
+        elif self.two_pair(self.player_deck) and self.two_pair(self.dealer_deck):
+            say = "Two Pairs"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.second_pair > self.dealer_deck.second_pair:
+                win = True
+            elif (
+                self.player_deck.first_pair == self.dealer_deck.first_pair
+                and self.player_deck.second_pair == self.dealer_deck.second_pair
+            ):
+                tied = True
+
+        # One Pair
+        elif self.one_pair(self.player_deck) != self.one_pair(self.dealer_deck):
+            say = "a Pair"
+            if self.one_pair(self.player_deck):
+                win = True
+        elif self.one_pair(self.player_deck) and self.one_pair(self.dealer_deck):
+            say = "Pair"
+            same_move = True
+            if self.player_deck.first_pair > self.dealer_deck.first_pair:
+                win = True
+            elif self.player_deck.first_pair == self.dealer_deck.first_pair:
+                tied = True
+        else:
+            tied = True
+
+        msg = "You've stayed.\n"
+
+        if same_move:
+            if win:
+                msg += f"You won! Your {say} is greater than Dealer's {say}!"
+            else:
+                msg += f"You lost! The Dealer's {say} is greater than your {say}!"
+        elif win:
+            msg += f"You won! You got {say}!"
+        elif tied:
+            msg += "Both the Dealer and the Player have tied."
+        else:
+            msg += f"You lost! The Dealer got {say}."
+
+        msg += box(
+            f"Dealer's Deck: {self.dealer_deck.suit(0)}{self.dealer_deck.suit(1)}"
+            f"{self.dealer_deck.suit(2)}{self.dealer_deck.suit(3)}{self.dealer_deck.suit(4)}\n"
+            f"Your Deck:     {self.player_deck.suit(0)}{self.player_deck.suit(1)}"
+            f"{self.player_deck.suit(2)}{self.player_deck.suit(3)}{self.player_deck.suit(4)}"
+        )
+        self._in_game[ctx.guild.id] = False
+        self._hit[ctx.guild.id] = False
+        await ctx.send(msg)
+
+    @staticmethod
+    def one_pair(deck):
+        answer = False
+        for x in range(0, deck.len() - 1):
+            if deck.num(x) == deck.num(x + 1):
+                deck.first_pair = deck.num(x)
+                answer = True
+
+        return answer
+
+    @staticmethod
+    def two_pair(deck):
+        answer = False
+        first_pair = 0
+        second_pair = 0
+
+        for x in range(0, deck.len() - 1):
+            if deck.num(x) == deck.num(x + 1):
+                if first_pair == 0:
+                    first_pair = deck.num(x)
+                elif first_pair != deck.num(x) and second_pair == 0:
+                    second_pair = deck.num(x)
+
+        if first_pair != 0 and second_pair != 0:
+            deck.first_pair = first_pair
+            deck.second_pair = second_pair
+            answer = True
+
+        return answer
+
+    @staticmethod
+    def three_of_a_kind(deck):
+        answer = False
+        for x in range(0, deck.len() - 2):
+            if deck.num(x) == deck.num(x + 1) and deck.num(x + 1) == deck.num(x + 2):
+                deck.first_pair = deck.num(x)
+                answer = True
+
+        return answer
+
+    @staticmethod
+    def full_house(deck):
+        answer = False
+        first_pair = 0
+        second_pair = 0
+        for x in range(0, deck.len() - 2):
+            if deck.num(x) == deck.num(x + 1) and deck.num(x + 1) == deck.num(x + 2):
+                if first_pair == 0:
+                    first_pair = deck.num(x)
+        for x in range(0, deck.len() - 1):
+            if deck.num(x) == deck.num(x + 1):
+                if first_pair != deck.num(x) and second_pair == 0:
+                    second_pair = deck.num(x)
+
+        if first_pair != 0 and second_pair != 0:
+            deck.first_pair = first_pair
+            deck.second_pair = second_pair
+            answer = True
+
+        return answer
+
+    @staticmethod
+    def four_of_a_kind(deck):
+        answer = False
+        for x in range(0, deck.len() - 3):
+            if (
+                deck.num(x) == deck.num(x + 1)
+                and deck.num(x + 1) == deck.num(x + 2)
+                and deck.num(x + 2) == deck.num(x + 3)
+            ):
+                deck.first_pair = deck.num(x)
+                answer = True
+
+        return answer
+
+    @staticmethod
+    def flush(deck):
+        answer = False
+        x = 0
+        if (
+            deck.num(x) == deck.num(x + 1)
+            and deck.num(x + 1) == deck.num(x + 2)
+            and deck.num(x + 2) == deck.num(x + 3)
+            and deck.num(x + 3) == deck.num(x + 4)
+        ):
+            deck.first_pair = deck.num(x)
+            answer = True
+
+        return answer

massunban/__init__.py

@@ -0,0 +1,7 @@
+from .massunban import MassUnban
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(MassUnban(bot))

massunban/info.json

@@ -0,0 +1,7 @@
+{
+    "author": ["aikaterna"],
+    "install_msg": "Thanks for installing. Please read the help for the `massunban` command to get started, once you have loaded the cog.",
+    "short": "Mass unban users.",
+    "description": "Mass unban users by the ban reason used.",
+    "tags": ["unban"]
+}

massunban/massunban.py

@@ -0,0 +1,78 @@
+import asyncio
+import discord
+from redbot.core import checks, commands
+from redbot.core.utils.predicates import MessagePredicate
+
+
+class MassUnban(commands.Cog):
+    """Unban all users, or users with a specific ban reason."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """Nothing to delete."""
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+
+    @commands.guild_only()
+    @commands.command()
+    @checks.admin_or_permissions(manage_guild=True)
+    async def massunban(self, ctx, *, ban_reason = None):
+        """
+        Mass unban everyone, or specific people.
+        
+        `ban_reason` is what the bot looks for in the original ban reason to qualify a user for an unban. It is case-insensitive.
+        
+        When Red is used to ban a user, the ban reason looks like:
+        `action requested by aikaterna#1393 (id 154497072148643840). reason: bad person`
+        Using `[p]massunban bad person` will unban this user as "bad person" is contained in the original ban reason.
+        Using `[p]massunban aikaterna` will unban every user banned by aikaterna, if Red was used to ban them in the first place.
+        For users banned using the right-click ban option in Discord, the ban reason is only what the mod puts when it asks for a reason, so using the mod name to unban won't work.
+        
+        Every unban will show up in your modlog if mod logging is on for unbans. Check `[p]modlogset cases` to verify if mod log creation on unbans is on.
+        This can mean that your bot will be ratelimited on sending messages if you unban lots of users as it will create a modlog entry for each unban.
+        """
+        try:
+            banlist = await ctx.guild.bans()
+        except discord.errors.Forbidden:
+            msg = "I need the `Ban Members` permission to fetch the ban list for the guild."
+            await ctx.send(msg)
+            return
+
+        bancount = len(banlist)
+        if bancount == 0:
+            await ctx.send("No users are banned from this server.")
+            return
+
+        unban_count = 0
+        if not ban_reason:
+            warning_string = (
+                "Are you sure you want to unban every banned person on this server?\n"
+                f"**Please read** `{ctx.prefix}help massunban` **as this action can cause a LOT of modlog messages!**\n"
+                "Type `Yes` to confirm, or `No` to cancel."
+            )
+            await ctx.send(warning_string)
+            pred = MessagePredicate.yes_or_no(ctx)
+            try:
+                await self.bot.wait_for("message", check=pred, timeout=15)
+                if pred.result is True:
+                    async with ctx.typing():
+                        for ban_entry in banlist:
+                            await ctx.guild.unban(ban_entry.user, reason=f"Mass Unban requested by {str(ctx.author)} ({ctx.author.id})")
+                            await asyncio.sleep(0.5)
+                            unban_count += 1
+                else:
+                    return await ctx.send("Alright, I'm not unbanning everyone.")
+            except asyncio.TimeoutError:
+                return await ctx.send("Response timed out. Please run this command again if you wish to try again.")
+        else:
+            async with ctx.typing():
+                for ban_entry in banlist:
+                    if not ban_entry.reason:
+                        continue
+                    if ban_reason.lower() in ban_entry.reason.lower():
+                        await ctx.guild.unban(ban_entry.user, reason=f"Mass Unban requested by {str(ctx.author)} ({ctx.author.id})")
+                        await asyncio.sleep(0.5)
+                        unban_count += 1
+
+        await ctx.send(f"Done. Unbanned {unban_count} users.")

noflippedtables/__init__.py

@@ -0,0 +1,7 @@
+from .noflippedtables import NoFlippedTables
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(NoFlippedTables(bot))

noflippedtables/info.json

@@ -0,0 +1,8 @@
+{
+    "author" : ["irdumb", "aikaterna"],
+    "short" : "Unflip some tables.",
+    "description" : "Unflip all the flipped tables.",
+    "install_msg" : "Usage: [p]help tableset",
+    "tags" : ["noflippedtables", "no flip", "tables"],
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

noflippedtables/noflippedtables.py

@@ -0,0 +1,137 @@
+import asyncio
+from random import uniform as randfloat
+import re
+from redbot.core import commands, checks, Config
+from redbot.core.utils.chat_formatting import box
+
+
+class NoFlippedTables(commands.Cog):
+    """For the table sympathizers"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.config = Config.get_conf(self, 2712290002, force_registration=True)
+
+        default_guild = {
+            "ALL_TABLES": True,
+            "BOT_EXEMPT": False,
+            "SNACKBEAR": False,
+            "TOGGLE": False,
+        }
+
+        self.config.register_guild(**default_guild)
+
+        self.flippedTables = {}
+
+    @checks.mod_or_permissions(manage_guild=True)
+    @commands.group()
+    async def tableset(self, ctx):
+        """Got some nice settings for my UNflipped tables"""
+        if ctx.invoked_subcommand is None:
+            settings = await self.config.guild(ctx.guild).all()
+            msg = "[Current Settings]\n"
+            for k, v in settings.items():
+                msg += str(k) + ": " + str(v) + "\n"
+            await ctx.send(box(msg, lang="ini"))
+
+    @tableset.command()
+    async def flipall(self, ctx):
+        """Enables/disables right all unflipped tables in a message"""
+        settings = await self.config.guild(ctx.guild).ALL_TABLES()
+        await self.config.guild(ctx.guild).ALL_TABLES.set(not settings)
+        if not settings:
+            await ctx.send("All tables will now be unflipped.")
+        else:
+            await ctx.send("Now only one table unflipped per message.")
+
+    @tableset.command()
+    async def flipbot(self, ctx):
+        """Enables/disables allowing bot to flip tables"""
+        settings = await self.config.guild(ctx.guild).BOT_EXEMPT()
+        await self.config.guild(ctx.guild).BOT_EXEMPT.set(not settings)
+        if not settings:
+            await ctx.send("Bot is now allowed to leave its own tables flipped.")
+        else:
+            await ctx.send("Bot must now unflip tables that itself flips.")
+
+    @tableset.command()
+    async def snackbear(self, ctx):
+        """Snackburr is unflipping tables!"""
+        settings = await self.config.guild(ctx.guild).SNACKBEAR()
+        await self.config.guild(ctx.guild).SNACKBEAR.set(not settings)
+        if not settings:
+            await ctx.send("Snackburr will now unflip tables.")
+        else:
+            await ctx.send("Snackburr is heading off for his errands!")
+
+    @tableset.command()
+    async def toggle(self, ctx):
+        """Toggle the unflipping on or off."""
+        settings = await self.config.guild(ctx.guild).TOGGLE()
+        await self.config.guild(ctx.guild).TOGGLE.set(not settings)
+        if not settings:
+            await ctx.send("No table shall be left unflipped in this server.")
+        else:
+            await ctx.send("No more unflipping here.")
+
+    @commands.Cog.listener()
+    # so much fluff just for this OpieOP
+    async def on_message(self, message):
+        channel = message.channel
+        user = message.author
+        if not message.guild:
+            return
+        if not channel.permissions_for(message.guild.me).send_messages:
+            return
+        if hasattr(user, "bot") and user.bot is True:
+            return
+        toggle = await self.config.guild(message.guild).TOGGLE()
+        if not toggle:
+            return
+        if channel.id not in self.flippedTables:
+            self.flippedTables[channel.id] = {}
+        # ┬─┬ ┬┬ ┻┻ ┻━┻ ┬───┬ ┻━┻ will leave 3 tables left flipped
+        # count flipped tables
+        for m in re.finditer("┻━*┻|┬─*┬", message.content):
+            t = m.group()
+            bot_exempt = await self.config.guild(message.guild).BOT_EXEMPT()
+            if "┻" in t and not (message.author.id == self.bot.user.id and bot_exempt):
+                if t in self.flippedTables[channel.id]:
+                    self.flippedTables[channel.id][t] += 1
+                else:
+                    self.flippedTables[channel.id][t] = 1
+                    all_tables = await self.config.guild(message.guild).ALL_TABLES()
+                    if not all_tables:
+                        break
+            else:
+                f = t.replace("┬", "┻").replace("─", "━")
+                if f in self.flippedTables[channel.id]:
+                    if self.flippedTables[channel.id][f] <= 0:
+                        del self.flippedTables[channel.id][f]
+                    else:
+                        self.flippedTables[channel.id][f] -= 1
+        # wait random time. some tables may be unflipped by now.
+        await asyncio.sleep(randfloat(0, 1.5))
+        tables = ""
+
+        deleteTables = []
+        # unflip tables in self.flippedTables[channel.id]
+        for t, n in self.flippedTables[channel.id].items():
+            snackburr = await self.config.guild(message.guild).SNACKBEAR()
+            if snackburr:
+                unflipped = t.replace("┻", "┬").replace("━", "─") + " ノʕ •ᴥ•ノʔ" + "\n"
+            else:
+                unflipped = t.replace("┻", "┬").replace("━", "─") + " ノ( ゜-゜ノ)" + "\n"
+            for i in range(0, n):
+                tables += unflipped
+                # in case being processed in parallel
+                self.flippedTables[channel.id][t] -= 1
+            deleteTables.append(t)
+        for t in deleteTables:
+            del self.flippedTables[channel.id][t]
+        if tables != "":
+            await channel.send(tables)

otherbot/__init__.py

@@ -0,0 +1,11 @@
+from .otherbot import Otherbot
+
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. " "This cog does store discord IDs as needed for operation. "
+)
+
+
+async def setup(bot):
+    cog = Otherbot(bot)
+    await cog.generate_cache()
+    bot.add_cog(cog)

otherbot/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna", "Predä"],
+    "description": "Alerts a role when bot(s) go offline.",
+    "install_msg": "Thanks for installing, have fun.",
+    "permissions" : ["manage_roles"],
+    "short": "Alerts a role when bot(s) go offline.",
+    "tags": ["bot", "offline", "uptime"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store end user data. This cog does store discord IDs as needed for operation. "
+}

otherbot/otherbot.py

@@ -1,17 +1,428 @@
+from typing import Literal
+
 import discord
+from redbot.core.bot import Red
+from redbot.core import commands, checks, Config
 
-class OtherbotStatus:
+from datetime import datetime
-    def __init__(self, bot):
+
+DEFAULT_OFFLINE_EMOJI = "\N{LARGE RED CIRCLE}"
+DEFAULT_ONLINE_EMOJI = "\N{WHITE HEAVY CHECK MARK}"
+
+
+class Otherbot(commands.Cog):
+    __author__ = ["aikaterna", "Predä 。#1001"]
+    __version__ = "0.10"
+
+    async def red_delete_data_for_user(
+        self, *, requester: Literal["discord", "owner", "user", "user_strict"], user_id: int,
+    ):
+        if requester == "discord":
+            # user is deleted, just comply
+
+            data = await self.config.all_guilds()
+            for guild_id, guild_data in data.items():
+                if user_id in guild_data.get("watching", []):
+                    bypass = guild_data.get("watching", [])
+                    bypass = set(bypass)
+                    bypass.discard(user_id)
+                    await self.config.guild_from_id(guild_id).bypass.set(list(bypass))
+
+    def __init__(self, bot: Red):
         self.bot = bot
+        self.config = Config.get_conf(self, 2730321001, force_registration=True)
+        self.config.register_guild(
+            ping=None,
+            reporting=None,
+            watching=[],
+            online_watching=[],
+            offline_emoji=DEFAULT_OFFLINE_EMOJI,
+            online_emoji=DEFAULT_ONLINE_EMOJI,
+            embed_offline=True,
+            embed_online=True,
+        )
 
-    async def on_member_update(self, before, after):
+    async def generate_cache(self):
-        if after.status == discord.Status.offline and after.id == "000000000000000000":  #  this is the bot id that you want to watch
+        self.otherbot_cache = await self.config.all_guilds()
-            channel_object = self.bot.get_channel("000000000000000000") #  this is the channel id for the watcher bot to scream in
+
-            await self.bot.send_message(channel_object, "<@000000000000000000>, the bot is offline.")  # this is the person to ping and the message
+    def cog_unload(self):
+        self.otherbot_cache.clear()
+
+    async def get_watching(self, watch_list: list, watch_type: str, guild: int):
+        data = []
+        for user_id in watch_list:
+            user = self.bot.get_user(user_id)
+            if not user:
+                async with self.config.guild_from_id(guild).all() as config:
+                    config[watch_type].remove(user_id)
             else:
-            pass
+                data.append(user.mention)
+        return data
 
+    @commands.group()
+    @commands.guild_only()
+    @checks.admin_or_permissions(manage_roles=True)
+    async def otherbot(self, ctx: commands.Context):
+        """Otherbot configuration options."""
+        # Following logic from Trusty's welcome cog:
+        # https://github.com/TrustyJAID/Trusty-cogs/blob/master/welcome/welcome.py#L81
+        guild = ctx.guild
+        if not ctx.invoked_subcommand:
+            guild_data = await self.config.guild(guild).all()
+            settings_name = dict(
+                ping="Ping role",
+                reporting="Channel reporting",
+                watching="Offline tracking",
+                online_watching="Online tracking",
+                offline_emoji="Offline emoji",
+                online_emoji="Online emoji",
+                embed_offline="Offline embed",
+                embed_online="Online embed",
+            )
+            msg = ""
+            if ctx.channel.permissions_for(ctx.me).embed_links:
+                em = discord.Embed(
+                    color=await ctx.embed_colour(), title=f"Otherbot settings for {guild.name}"
+                )
+                for attr, name in settings_name.items():
+                    if attr == "ping":
+                        role = guild.get_role(guild_data["ping"])
+                        if role:
+                            msg += f"**{name}**: {role.mention}\n"
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    elif attr == "reporting":
+                        channel = guild.get_channel(guild_data["reporting"])
+                        if channel:
+                            msg += f"**{name}**: {channel.mention}\n"
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    elif attr == "watching":
+                        if guild_data["watching"]:
+                            msg += (
+                                f"**{name}**: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["watching"], "watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    elif attr == "online_watching":
+                        if guild_data["online_watching"]:
+                            msg += (
+                                f"**{name}**: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["online_watching"], "online_watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"**{name}**: Not set.\n"
+                    else:
+                        msg += f"**{name}**: {guild_data[attr]}\n"
+                em.description = msg
+                em.set_thumbnail(url=guild.icon_url)
+                await ctx.send(embed=em)
+            else:
+                msg = "```\n"
+                for attr, name in settings_name.items():
+                    if attr == "ping":
+                        role = guild.get_role(guild_data["ping"])
+                        if role:
+                            msg += f"{name}: {role.mention}\n"
+                        else:
+                            msg += f"{name}: Not set.\n"
+                    elif attr == "reporting":
+                        channel = guild.get_channel(guild_data["reporting"])
+                        if channel:
+                            msg += f"{name}: {channel.mention}\n"
+                        else:
+                            msg += f"{name}: Not set.\n"
+                    elif attr == "watching":
+                        if guild_data["watching"]:
+                            msg += (
+                                f"{name}: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["watching"], "watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"{name}: Not set."
+                    elif attr == "online_watching":
+                        if guild_data["online_watching"]:
+                            msg += (
+                                f"{name}: "
+                                + " ".join(
+                                    await self.get_watching(
+                                        guild_data["online_watching"], "online_watching", guild.id
+                                    )
+                                )
+                                + "\n"
+                            )
+                        else:
+                            msg += f"{name}: Not set.\n"
+                    else:
+                        msg += f"**{name}**: {guild_data[attr]}\n"
+                msg += "```"
+                await ctx.send(msg)
 
-def setup(bot):
+    @otherbot.command()
-    n = OtherbotStatus(bot)
+    async def channel(self, ctx: commands.Context, channel: discord.TextChannel = None):
-    bot.add_cog(n)
+        """
+        Sets the channel to report in.
+        
+        Default to the current one.
+        """
+        if not channel:
+            channel = ctx.channel
+        await self.config.guild(ctx.guild).reporting.set(channel.id)
+        await ctx.send(f"Reporting channel set to: {channel.mention}.")
+        await self.generate_cache()
+
+    @otherbot.command()
+    async def pingrole(self, ctx: commands.Context, role_name: discord.Role = None):
+        """Sets the role to use for pinging. Leave blank to reset it."""
+        if not role_name:
+            await self.config.guild(ctx.guild).ping.set(None)
+            return await ctx.send("Ping role cleared.")
+        await self.config.guild(ctx.guild).ping.set(role_name.id)
+        pingrole_id = await self.config.guild(ctx.guild).ping()
+        pingrole_obj = discord.utils.get(ctx.guild.roles, id=pingrole_id)
+        await ctx.send(f"Ping role set to: `{pingrole_obj.name}`.")
+        await self.generate_cache()
+
+    @otherbot.group(name="watch", aliases=["watching"])
+    async def otherbot_watch(self, ctx: commands.Context):
+        """Watch settings."""
+
+    @otherbot_watch.group(name="offline")
+    async def otherbot_watch_offline(self, ctx: commands.Context):
+        """Manage offline notifications."""
+
+    @otherbot_watch_offline.command(name="add")
+    async def otherbot_watch_offline_add(self, ctx: commands.Context, bot: discord.Member):
+        """Add a bot that will be tracked when it goes offline."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't track normal users. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).watching() as watch_list:
+            watch_list.append(bot.id)
+        await ctx.send(f"I will now track {bot.mention} when it goes offline.")
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="remove")
+    async def otherbot_watch_offline_remove(self, ctx: commands.Context, bot: discord.Member):
+        """Removes a bot currently tracked."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't choose a normal user. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).watching() as watch_list:
+            try:
+                watch_list.remove(bot.id)
+                await ctx.send(
+                    f"Successfully removed {bot.mention} from offline tracked bot list."
+                )
+            except ValueError:
+                await ctx.send(f"{bot.mention} is not currently tracked.")
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="list")
+    async def otherbot_watch_offline_list(self, ctx: commands.Context):
+        """Lists currently tracked bots."""
+        watching = await self.config.guild(ctx.guild).watching()
+        if not watching:
+            return await ctx.send("There is currently no bots tracked for offline status.")
+
+        watching_list = await self.get_watching(watching, "watching", ctx.guild.id)
+        await ctx.send(
+            f"{len(watching):,} bot{'s' if len(watching) > 1 else ''} are currently tracked for offline status:\n"
+            + ", ".join(watching_list)
+        )
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="emoji")
+    async def otherbot_watch_offline_emoji(self, ctx: commands.Context, *, emoji: str = None):
+        """Choose which emoji that will be used for offline messages."""
+        if not emoji:
+            await self.config.guild(ctx.guild).offline_emoji.set(DEFAULT_OFFLINE_EMOJI)
+            await ctx.send(f"Offline emoji resetted to default: {DEFAULT_OFFLINE_EMOJI}")
+        else:
+            await self.config.guild(ctx.guild).offline_emoji.set(emoji)
+            await ctx.tick()
+        await self.generate_cache()
+
+    @otherbot_watch_offline.command(name="embed")
+    async def otherbot_watch_offline_embed(self, ctx: commands.Context):
+        """Set wether you want to receive notifications in embed or not."""
+        current = await self.config.guild(ctx.guild).embed_offline()
+        await self.config.guild(ctx.guild).embed_offline.set(not current)
+        await ctx.send(
+            "I will now send offline notifications in embeds."
+            if not current
+            else "I will no longer send offline notifications in embeds."
+        )
+        await self.generate_cache()
+
+    @otherbot_watch.group(name="online")
+    async def otherbot_watch_online(self, ctx: commands.Context):
+        """Manage online notifications."""
+
+    @otherbot_watch_online.command(name="add")
+    async def otherbot_watch_online_add(self, ctx: commands.Context, bot: discord.Member):
+        """Add a bot that will be tracked when it comes back online."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't track normal users. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).online_watching() as watch_list:
+            watch_list.append(bot.id)
+        await ctx.send(f"I will now track {bot.mention} when it goes back online.")
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="remove")
+    async def otherbot_watch_online_remove(self, ctx: commands.Context, bot: discord.Member):
+        """Removes a bot currently tracked."""
+        if not bot.bot:
+            return await ctx.send(
+                "You can't choose a normal user. Please try again with a bot user."
+            )
+
+        async with self.config.guild(ctx.guild).online_watching() as watch_list:
+            try:
+                watch_list.remove(bot.id)
+                await ctx.send(f"Successfully removed {bot.mention} from online tracked bot list.")
+            except ValueError:
+                await ctx.send(f"{bot.mention} is not currently tracked.")
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="list")
+    async def otherbot_watch_online_list(self, ctx: commands.Context):
+        """Lists currently tracked bots."""
+        watching = await self.config.guild(ctx.guild).online_watching()
+        if not watching:
+            return await ctx.send("There is currently no bots tracked for online status.")
+
+        watching_list = await self.get_watching(watching, "online_watching", ctx.guild.id)
+        await ctx.send(
+            f"{len(watching):,} bot{'s' if len(watching) > 1 else ''} are currently tracked for online status:\n"
+            + ", ".join(watching_list)
+        )
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="emoji")
+    async def otherbot_watch_online_emoji(self, ctx: commands.Context, *, emoji: str = None):
+        """Choose which emoji that will be used for online messages."""
+        if not emoji:
+            await self.config.guild(ctx.guild).online_emoji.set(DEFAULT_ONLINE_EMOJI)
+            await ctx.send(f"Online emoji resetted to default: {DEFAULT_ONLINE_EMOJI}")
+        else:
+            await self.config.guild(ctx.guild).online_emoji.set(emoji)
+            await ctx.tick()
+        await self.generate_cache()
+
+    @otherbot_watch_online.command(name="embed")
+    async def otherbot_watch_online_embed(self, ctx: commands.Context):
+        """Set wether you want to receive notifications in embed or not."""
+        current = await self.config.guild(ctx.guild).embed_online()
+        await self.config.guild(ctx.guild).embed_online.set(not current)
+        await ctx.send(
+            "I will now send online notifications in embeds."
+            if not current
+            else "I will no longer send online notifications in embeds."
+        )
+        await self.generate_cache()
+
+    @commands.Cog.listener()
+    async def on_member_update(self, before: discord.Member, after: discord.Member):
+        if after.guild is None or not after.bot:
+            return
+
+        data = self.otherbot_cache.get(after.guild.id)
+        if data is None:
+            return
+        channel = self.bot.get_channel(data["reporting"])
+        if not channel:
+            return
+        if not (data["watching"] or data["online_watching"]):
+            return
+        if (
+            before.status != discord.Status.offline
+            and after.status == discord.Status.offline
+            and (after.id in data["watching"])
+        ):
+            try:
+                if data["embed_offline"]:
+                    em = discord.Embed(
+                        color=0x8B0000,
+                        description=f"{after.mention} is offline. {data['offline_emoji']}",
+                        timestamp=datetime.utcnow(),
+                    )
+                    if not data["ping"]:
+                        await channel.send(embed=em)
+                    else:
+                        if discord.version_info.minor < 4:
+                            await channel.send(f"<@&{data['ping']}>", embed=em)
+                        else:
+                            await channel.send(
+                                f"<@&{data['ping']}>",
+                                embed=em,
+                                allowed_mentions=discord.AllowedMentions(roles=True),
+                            )
+                else:
+                    if not data["ping"]:
+                        await channel.send(f"{after.mention} is offline. {data['offline_emoji']}")
+                    else:
+                        await channel.send(
+                            f"<@&{data['ping']}>, {after.mention} is offline. {data['offline_emoji']}"
+                        )
+            except discord.Forbidden:
+                async with self.config.guild(after.guild).watching() as old_data:
+                    old_data.remove(after.id)
+        elif (
+            before.status == discord.Status.offline
+            and after.status != discord.Status.offline
+            and (after.id in data["online_watching"])
+        ):
+            try:
+                if data["embed_online"]:
+                    em = discord.Embed(
+                        color=0x008800,
+                        description=f"{after.mention} is back online. {data['online_emoji']}",
+                        timestamp=datetime.utcnow(),
+                    )
+                    if not data["ping"]:
+                        await channel.send(embed=em)
+                    else:
+                        if discord.version_info.minor < 4:
+                            await channel.send(f"<@&{data['ping']}>", embed=em)
+                        else:
+                            await channel.send(
+                                f"<@&{data['ping']}>",
+                                embed=em,
+                                allowed_mentions=discord.AllowedMentions(roles=True),
+                            )
+                else:
+                    if not data["ping"]:
+                        await channel.send(
+                            f"{after.mention} is back online. {data['online_emoji']}"
+                        )
+                    else:
+                        await channel.send(
+                            f"<@&{data['ping']}>, {after.mention} is back online. {data['online_emoji']}"
+                        )
+            except discord.Forbidden:
+                async with self.config.guild(after.guild).online_watching() as old_data:
+                    old_data.remove(after.id)

partycrash/__init__.py

@@ -0,0 +1,7 @@
+from .partycrash import PartyCrash
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(PartyCrash(bot))

partycrash/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna", "Will (tekulvw)"],
+    "description": "Posts invites to servers, if the bot is allowed to view them. Does not generate new invites.",
+    "install_msg": "Note that having an invite available for a server does not automatically grant you permissions to join said server. Thanks for installing, have fun.",
+    "permissions" : ["manage_guild"],
+    "short": "Post server invites.",
+    "tags": ["invite"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

partycrash/partycrash.py

@@ -0,0 +1,84 @@
+import discord
+from redbot.core import commands, checks
+from redbot.core.utils.chat_formatting import box, pagify
+import asyncio
+
+
+class PartyCrash(commands.Cog):
+    """Partycrash inspired by v2 Admin by Will
+       Does not generate invites, only lists existing invites."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+
+    async def _get_invites(self, guild, ctx):
+        answers = ("yes", "y")
+        if not guild:
+            return await ctx.send("I'm not in that server.")
+        try:
+            invites = await guild.invites()
+        except discord.errors.Forbidden:
+            return await ctx.send(f"I don't have permission to view invites for {guild.name}.")
+        if not invites:
+            return await ctx.send("I couldn't access any invites.")
+        await ctx.send(f"Are you sure you want to post the invite(s) to {guild.name} here?")
+
+        def check(m):
+            return m.author == ctx.author
+
+        try:
+            msg = await ctx.bot.wait_for("message", timeout=15.0, check=check)
+            if msg.content.lower().strip() in answers:
+                msg = f"Invite(s) for **{guild.name}**:"
+                for url in invites:
+                    msg += f"\n{url}"
+                await ctx.send(msg)
+            else:
+                await ctx.send("Alright then.")
+        except asyncio.TimeoutError:
+            await ctx.send("I guess not.")
+
+    @commands.command()
+    @checks.is_owner()
+    async def partycrash(self, ctx, idnum=None):
+        """Lists servers and existing invites for them."""
+        if idnum:
+            guild = self.bot.get_guild(int(idnum))
+            await self._get_invites(guild, ctx)
+        else:
+            msg = ""
+            guilds = sorted(self.bot.guilds, key=lambda s: s.name)
+            for i, guild in enumerate(guilds, 1):
+                if len(guild.name) > 32:
+                    guild_name = f"{guild.name[:32]}..."
+                else:
+                    guild_name = guild.name
+                if i < 10:
+                    i = f"0{i}"
+                msg += f"{i}: {guild_name:35} ({guild.id})\n"
+            msg += "\nTo post the existing invite(s) for a server just type its number."
+            for page in pagify(msg, delims=["\n"]):
+                await ctx.send(box(page))
+
+            def check(m):
+                return m.author == ctx.author
+
+            try:
+                msg = await ctx.bot.wait_for("message", timeout=20.0, check=check)
+                try:
+                    guild_no = int(msg.content.strip())
+                    guild = guilds[guild_no - 1]
+                except ValueError:
+                    return await ctx.send("You must enter a number.")
+                except IndexError:
+                    return await ctx.send("Index out of range.")
+                try:
+                    await self._get_invites(guild, ctx)
+                except discord.errors.Forbidden:
+                    return await ctx.send(f"I don't have permission to get invites for {guild.name}.")
+            except asyncio.TimeoutError:
+                return await ctx.send("No server number entered, try again later.")

picwelcome/info.json

@@ -1,9 +0,0 @@
-{
-    "AUTHOR" : "aikaterna",
-    "INSTALL_MSG" : "Use [p]picwelcome to change settings.",
-    "NAME" : "picwelcome",
-    "SHORT" : "Welcome users to your server with a picture.",
-    "DESCRIPTION" : "Welcome users to your server with a picture.",
-    "REQUIREMENTS": ["Pillow"],
-    "TAGS": ["welcome", "welcome image", "images"]
-}

picwelcome/picwelcome.py

@@ -1,170 +0,0 @@
-#  picwelcomeset_upload is based on code in orels' drawing.py
-#  https://github.com/orels1/ORELS-Cogs
-
-import asyncio
-import aiohttp
-import datetime
-import discord
-import os
-from __main__ import send_cmd_help
-from cogs.utils.dataIO import dataIO
-from cogs.utils import checks
-from copy import deepcopy
-from discord.ext import commands
-from PIL import Image
-
-
-default_settings = {"ANNOUNCE": False,
-                    "PICTURE": "data/picwelcome/default.png",
-                    "CHANNEL": None,
-                    }
-
-
-class PicWelcome:
-    """Welcome new users with a static image."""
-
-    def __init__(self, bot):
-        self.bot = bot
-        self.settings = dataIO.load_json('data/picwelcome/settings.json')
-        self.version = "0.0.1"
-
-    async def save_settings(self):
-        dataIO.save_json('data/picwelcome/settings.json', self.settings)
-
-    async def _data_check(self, ctx):
-        server = ctx.message.server
-        if server.id not in self.settings:
-            self.settings[server.id] = deepcopy(default_settings)
-            self.settings[server.id]["CHANNEL"] = ctx.message.channel.id
-            await self.save_settings()
-
-    @checks.admin_or_permissions(manage_server=True)
-    @commands.group(pass_context=True)
-    async def picwelcome(self, ctx):
-        """Configuration options for a welcome picture."""
-        if ctx.invoked_subcommand is None:
-            await send_cmd_help(ctx)
-            return
-
-    @picwelcome.command(pass_context=True, name="channel", no_pm=True)
-    async def picwelcome_channel(self, ctx, channel: discord.Channel):
-        """Set the announcement channel."""
-        server = ctx.message.server
-        if not server.me.permissions_in(channel).send_messages:
-            await self.bot.say("No permissions to speak in that channel.")
-            return
-        await self._data_check(ctx)
-        self.settings[server.id]["CHANNEL"] = channel.id
-        await self.save_settings()
-        await self.bot.send_message(channel, "This channel will be used for welcome pictures.")
-
-    @picwelcome.command(name='reset', pass_context=True, no_pm=True)
-    async def picwelcome_reset(self, ctx):
-        """Set the welcome picture back to the default."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]['PICTURE'] = 'data/picwelcome/default.png'
-        await self.save_settings()
-        await self.bot.say('Welcome picture reset to default.')
-
-    @picwelcome.command(name="preview", pass_context=True, no_pm=True)
-    async def picwelcome_preview(self, ctx, member: discord.Member=None, number: int=None):
-        """Show a the welcome picture with the current settings."""
-        server = ctx.message.server
-        channel = ctx.message.channel
-        if member is None:
-            member = ctx.message.author
-        await self._data_check(ctx)
-        channel_object = self.bot.get_channel(channel.id)
-        await self.bot.send_typing(channel_object)
-        serverpicture = self.settings[server.id]["PICTURE"]
-        await self.bot.send_file(channel_object, serverpicture)
-
-    @picwelcome.command(pass_context=True, name="toggle", no_pm=True)
-    async def picwelcome_toggle(self, ctx):
-        """Toggle welcome pictures on the server."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        self.settings[server.id]["ANNOUNCE"] = not self.settings[server.id]["ANNOUNCE"]
-        if self.settings[server.id]["ANNOUNCE"]:
-            await self.bot.say("Now welcoming new users with a picture.")
-        else:
-            await self.bot.say("No longer welcoming new users with a picture.")
-        await self.save_settings()
-
-    @picwelcome.command(name='upload', pass_context=True, no_pm=True)
-    async def picwelcome_upload(self, ctx, default=None):
-        """Upload a picture through Discord.
-        This must be an image file and not a url."""
-        server = ctx.message.server
-        await self._data_check(ctx)
-        await self.bot.say("Please send the file to use as a welcome picture.")
-        answer = await self.bot.wait_for_message(timeout=30, author=ctx.message.author)
-
-        try:
-            bg_url = answer.attachments[0]["url"]
-            success = True
-        except Exception as e:
-            success = False
-            print(e)
-
-        serverimage = Image
-
-        if success:
-            try:
-                async with aiohttp.get(bg_url) as r:
-                    image = await r.content.read()
-                    if not os.path.exists('data/picwelcome/{}'.format(server.id)):
-                        os.makedirs('data/picwelcome/{}'.format(server.id))
-                serverbg = 'data/picwelcome/{}/serverpic.png'.format(server.id)
-                with open(serverbg, 'wb') as f:
-                    f.write(image)
-                    serverimage = Image.open(serverbg).convert('RGBA')
-                    success = True
-
-            except Exception as e:
-                success = False
-                print(e)
-            if success:
-                self.settings[server.id]['PICTURE'] = "data/picwelcome/" + ctx.message.server.id + "/serverpic.png"
-                await self.save_settings()
-                await self.bot.say('Welcome image for this server set to uploaded file.')
-            else:
-                await self.bot.say("Couldn't get the image from Discord.")
-        else:
-            await self.bot.say("Couldn't get the image.")
-
-    @picwelcome.command(name="version", pass_context=True, hidden=True)
-    async def picwelcome_version(self):
-        """Displays the picwelcome version."""
-        await self.bot.say("picwelcome version {}.".format(self.version))
-
-    async def on_member_join(self, member):
-        server = member.server
-        if server.id not in self.settings:
-            self.settings[server.id] = deepcopy(default_settings)
-            await self.save_settings()
-        if not self.settings[server.id]["ANNOUNCE"]:
-            return
-        channelid = self.settings[server.id]["CHANNEL"]
-        channel_object = self.bot.get_channel(channelid)
-        await self.bot.send_typing(channel_object)
-        serverpicture = self.settings[server.id]["PICTURE"]
-        await self.bot.send_file(channel_object, serverpicture)
-
-
-def check_folders():
-    if not os.path.exists('data/picwelcome/'):
-        os.mkdir('data/picwelcome/')
-
-
-def check_files():
-    if not dataIO.is_valid_json('data/picwelcome/settings.json'):
-        defaults = {}
-        dataIO.save_json('data/picwelcome/settings.json', defaults)
-
-
-def setup(bot):
-    check_folders()
-    check_files()
-    bot.add_cog(PicWelcome(bot))

pingtime/__init__.py

@@ -0,0 +1,7 @@
+from .pingtime import Pingtime
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Pingtime(bot))

pingtime/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["aikaterna"],
+    "description": "It's ping... with latency. Shows all shards.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Ping pong.",
+    "tags": ["ping", "pingtime", "latency"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

pingtime/pingtime.py

@@ -0,0 +1,24 @@
+from redbot.core import commands
+
+
+BaseCog = getattr(commands, "Cog", object)
+
+
+class Pingtime(BaseCog):
+    """🏓"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+
+    @commands.command()
+    async def pingtime(self, ctx):
+        """Ping pong."""
+        latencies = self.bot.latencies
+        msg = "Pong!\n"
+        for shard, pingt in latencies:
+            msg += "Shard {}/{}: {}ms\n".format(shard + 1, len(latencies), round(pingt * 1000))
+        await ctx.send(msg)

pressf/__init__.py

@@ -0,0 +1,7 @@
+from .pressf import PressF
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(PressF(bot))

pressf/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["aikaterna"],
+    "description": "Pay respects to a thing or user by pressing f.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Press f to pay respects.",
+    "tags": ["f", "pressf", "respects"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

pressf/pressf.py

@@ -0,0 +1,68 @@
+import asyncio
+import discord
+from redbot.core import commands
+from redbot.core.utils.common_filters import filter_mass_mentions
+
+
+class PressF(commands.Cog):
+    """Pay some respects."""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.channels = {}
+
+    @commands.command()
+    @commands.bot_has_permissions(add_reactions=True)
+    async def pressf(self, ctx, *, user: discord.User = None):
+        """Pay respects by pressing F"""
+        if str(ctx.channel.id) in self.channels:
+            return await ctx.send(
+                "Oops! I'm still paying respects in this channel, you'll have to wait until I'm done."
+            )
+
+        if user:
+            answer = user.display_name
+        else:
+            await ctx.send("What do you want to pay respects to?")
+
+            def check(m):
+                return m.author == ctx.author and m.channel == ctx.channel
+
+            try:
+                pressf = await ctx.bot.wait_for("message", timeout=120.0, check=check)
+            except asyncio.TimeoutError:
+                return await ctx.send("You took too long to reply.")
+
+            answer = pressf.content[:1900]
+
+        message = await ctx.send(
+            f"Everyone, let's pay respects to **{filter_mass_mentions(answer)}**! Press the f reaction on this message to pay respects."
+        )
+        await message.add_reaction("\U0001f1eb")
+        self.channels[str(ctx.channel.id)] = {"msg_id": message.id, "reacted": []}
+        await asyncio.sleep(120)
+        try:
+            await message.delete()
+        except (discord.errors.NotFound, discord.errors.Forbidden):
+            pass
+        amount = len(self.channels[str(ctx.channel.id)]["reacted"])
+        word = "person has" if amount == 1 else "people have"
+        await ctx.send(f"**{amount}** {word} paid respects to **{filter_mass_mentions(answer)}**.")
+        del self.channels[str(ctx.channel.id)]
+
+    @commands.Cog.listener()
+    async def on_reaction_add(self, reaction, user):
+        if str(reaction.message.channel.id) not in self.channels:
+            return
+        if self.channels[str(reaction.message.channel.id)]["msg_id"] != reaction.message.id:
+            return
+        if user.id == self.bot.user.id:
+            return
+        if user.id not in self.channels[str(reaction.message.channel.id)]["reacted"]:
+            if str(reaction.emoji) == "\U0001f1eb":
+                await reaction.message.channel.send(f"**{user.name}** has paid their respects.")
+                self.channels[str(reaction.message.channel.id)]["reacted"].append(user.id)

pug/info.json

@@ -1,8 +0,0 @@
-{
-    "AUTHOR" : "aikaterna",
-    "INSTALL_MSG" : "Thanks for installing Pug. Now you can check out your Warcraft pugs for raid-readiness through Discord.",
-    "NAME" : "Pug",
-    "SHORT" : "Warcraft character lookup.",
-    "DESCRIPTION" : "This tool lets you check potential group pugs for enchants, gems, and raid completion. It was made possible by PugBot: https://github.com/reznok/PugBot",
-    "TAGS" : ["warcraft", "raiding", "raid"]
-}

pug/pug.py

@@ -1,313 +0,0 @@
-import json
-import os
-import requests
-from .utils.dataIO import dataIO
-from __main__ import send_cmd_help
-from discord.ext import commands
-from .utils import checks
-
-
-class Pug:
-
-    def __init__(self, bot):
-        self.bot = bot
-        self.settings = dataIO.load_json("data/pug/config.json")
-        self.fp = "data/pug/config.json"
-        API_KEY = self.settings["blizzard_api_key"]
-        default_region = self.settings["default_region"]
-
-    LEG_WITH_SOCKET = [
-        132369, 132410, 137044, 132444, 132449, 132452, 132460, 133973, 133974, 137037, 137038, 137039, 137040, 137041,
-        137042, 137043, 132378, 137045, 137046, 137047, 137048, 137049, 137050, 137051, 137052, 137054, 137055, 137220,
-        137223, 137276, 137382, 138854
-    ]
-
-    ENCHANTABLE_SLOTS = ["neck", "back", "finger1", "finger2"]
-
-    region_locale = {
-        'us': ['us', 'en_US', 'en'],
-        'eu': ['eu', 'en_GB', 'en']
-    #    'kr': ['kr', 'ko_KR', 'ko'],
-    #    'tw': ['tw', 'zh_TW', 'zh'],
-    #    'es': ['es', 'es_MX', 'es'],	es lookup is broken until the armory site is migrated to the new format
-    }
-
-    def get_sockets(self, player_dictionary):
-        """
-        Return dict with total sockets and count of equipped gems and slots that are missing
-
-        :param player_dictionary: Retrieved player dict from API
-        :return: dict()
-        """
-        sockets = 0
-        equipped_gems = 0
-
-        for item in player_dictionary["items"]:
-            if item in "averageItemLevel" or item in "averageItemLevelEquipped":
-                continue
-
-            if int(player_dictionary["items"][item]["id"]) in self.LEG_WITH_SOCKET:
-                sockets += 1
-
-            for bonus in player_dictionary["items"][item]["bonusLists"]:
-                if bonus == 1808:  # 1808 is Legion prismatic socket bonus
-                    sockets += 1
-
-            if item in ["neck", "finger1", "finger2"]:
-                if player_dictionary["items"][item]["context"] == "trade-skill":
-                    sockets += 1
-
-            for ttip in player_dictionary["items"][item]["tooltipParams"]:
-                if item in "mainHand" or item in "offHand":  # Ignore Relic
-                    continue
-                if "gem" in ttip:  # Equipped gems are listed as gem0, gem1, etc...
-                    equipped_gems += 1
-
-        return {"total_sockets": sockets,
-                "equipped_gems": equipped_gems}
-
-    def get_enchants(self, player_dictionary):
-        """
-        Get count of enchants missing and slots that are missing
-        :param player_dictionary:
-        :return: dict()
-        """
-        self.missing_enchant_slots = []
-        for slot in self.ENCHANTABLE_SLOTS:
-            if "enchant" not in player_dictionary["items"][slot]["tooltipParams"]:
-                self.missing_enchant_slots.append(slot)
-
-        return {
-            "enchantable_slots": len(self.ENCHANTABLE_SLOTS),
-            "missing_slots": self.missing_enchant_slots,
-            "total_missing": len(self.missing_enchant_slots)
-        }
-
-    def get_raid_progression(self, player_dictionary, raid):
-        r = [x for x in player_dictionary["progression"]
-        ["raids"] if x["name"] in raid][0]
-        normal = 0
-        heroic = 0
-        mythic = 0
-
-        for boss in r["bosses"]:
-            if boss["normalKills"] > 0:
-                normal += 1
-            if boss["heroicKills"] > 0:
-                heroic += 1
-            if boss["mythicKills"] > 0:
-                mythic += 1
-
-        return {"normal": normal,
-                "heroic": heroic,
-                "mythic": mythic,
-                "total_bosses": len(r["bosses"])}
-
-    def get_mythic_progression(self, player_dictionary):
-        achievements = player_dictionary["achievements"]
-        plus_two = 0
-        plus_five = 0
-        plus_ten = 0
-
-        if 33096 in achievements["criteria"]:
-            index = achievements["criteria"].index(33096)
-            plus_two = achievements["criteriaQuantity"][index]
-
-        if 33097 in achievements["criteria"]:
-            index = achievements["criteria"].index(33097)
-            plus_five = achievements["criteriaQuantity"][index]
-
-        if 33098 in achievements["criteria"]:
-            index = achievements["criteria"].index(33098)
-            plus_ten = achievements["criteriaQuantity"][index]
-
-        return {
-            "plus_two": plus_two,
-            "plus_five": plus_five,
-            "plus_ten": plus_ten
-        }
-
-    def get_char(self, name, server, target_region):
-        self.settings = dataIO.load_json("data/pug/config.json")  # Load Configs
-        API_KEY = self.settings["blizzard_api_key"]
-        r = requests.get("https://%s.api.battle.net/wow/character/%s/%s?fields=items+progression+achievements&locale=%s&apikey=%s" % (
-                self.region_locale[target_region][0], server, name, self.region_locale[target_region][1], API_KEY))
-
-        if r.status_code != 200:
-            raise Exception("Could not find character (No 200 from API).")
-
-        player_dict = json.loads(r.text)
-
-        r = requests.get(
-            "https://%s.api.battle.net/wow/data/character/classes?locale=%s&apikey=%s" % (
-                self.region_locale[target_region][0], self.region_locale[target_region][1], API_KEY))
-        if r.status_code != 200:
-            raise Exception("Could Not Find Character Classes (No 200 From API)")
-        class_dict = json.loads(r.text)
-        class_dict = {c['id']: c['name'] for c in class_dict["classes"]}
-		
-        r = requests.get("https://%s.api.battle.net/wow/character/%s/%s?fields=stats&locale=%s&apikey=%s" % (
-                self.region_locale[target_region][0], server, name, self.region_locale[target_region][1], API_KEY))
-        if r.status_code != 200:
-            raise Exception("Could not find character stats (No 200 From API).")
-        stats_dict = json.loads(r.text)
-
-        health = stats_dict["stats"]["health"]
-        power = stats_dict["stats"]["power"]
-        powertype = stats_dict["stats"]["powerType"]
-        powertypeproper = powertype.title()
-        strength = stats_dict["stats"]["str"]
-        agi = stats_dict["stats"]["agi"]
-        int = stats_dict["stats"]["int"]
-        sta = stats_dict["stats"]["sta"]
-        crit = stats_dict["stats"]["critRating"]
-        critrating = stats_dict["stats"]["crit"]
-        haste = stats_dict["stats"]["hasteRating"]
-        hasterating = stats_dict["stats"]["haste"]
-        mastery = stats_dict["stats"]["masteryRating"]
-        masteryrating = stats_dict["stats"]["mastery"]
-        vers = stats_dict["stats"]["versatility"]
-        versrating = stats_dict["stats"]["versatilityDamageDoneBonus"]
-        equipped_ivl = player_dict["items"]["averageItemLevelEquipped"]
-        sockets = self.get_sockets(player_dict)
-        enchants = self.get_enchants(player_dict)
-        tov_progress = self.get_raid_progression(player_dict, "Trial of Valor")
-        en_progress = self.get_raid_progression(player_dict, "The Emerald Nightmare")
-        nh_progress = self.get_raid_progression(player_dict, "The Nighthold")
-        tos_progress = self.get_raid_progression(player_dict, "Tomb of Sargeras")
-        ant_progress = self.get_raid_progression(player_dict, "Antorus, the Burning Throne")
-        mythic_progress = self.get_mythic_progression(player_dict)
-
-        armory_url = 'http://{}.battle.net/wow/{}/character/{}/{}/advanced'.format(
-            self.region_locale[target_region][0], self.region_locale[target_region][2], server, name)
-
-        return_string = ''
-        return_string += "**%s** - **%s** - **%s %s**\n" % (
-            name.title(), server.title(), player_dict['level'], class_dict[player_dict['class']])
-        return_string += '<{}>\n'.format(armory_url)
-        return_string += '```ini\n'  # start Markdown
-
-        # iLvL
-        return_string += "[Equipped Item Level]: %s\n" % equipped_ivl
-
-        # Mythic Progression
-        return_string += "[Mythics]: +2: %s, +5: %s, +10: %s\n" % (mythic_progress["plus_two"],
-                                                                 mythic_progress["plus_five"],
-                                                                 mythic_progress["plus_ten"])
-
-        # Raid Progression
-        return_string += "[EN]: {1}/{0} (N), {2}/{0} (H), {3}/{0} (M)\n".format(en_progress["total_bosses"],
-                                                                              en_progress["normal"],
-                                                                              en_progress["heroic"],
-                                                                              en_progress["mythic"])
-        return_string += "[TOV]: {1}/{0} (N), {2}/{0} (H), {3}/{0} (M)\n".format(tov_progress["total_bosses"],
-                                                                               tov_progress["normal"],
-                                                                               tov_progress["heroic"],
-                                                                               tov_progress["mythic"])
-        return_string += "[NH]: {1}/{0} (N), {2}/{0} (H), {3}/{0} (M)\n".format(nh_progress["total_bosses"],
-                                                                               nh_progress["normal"],
-                                                                               nh_progress["heroic"],
-                                                                               nh_progress["mythic"])
-        return_string += "[TOS]: {1}/{0} (N), {2}/{0} (H), {3}/{0} (M)\n".format(tos_progress["total_bosses"],
-                                                                               tos_progress["normal"],
-                                                                               tos_progress["heroic"],
-                                                                               tos_progress["mythic"])
-        return_string += "[ANT]: {1}/{0} (N), {2}/{0} (H), {3}/{0} (M)\n".format(ant_progress["total_bosses"],
-                                                                               ant_progress["normal"],
-                                                                               ant_progress["heroic"],
-                                                                               ant_progress["mythic"])
-        # Gems
-        return_string += "[Gems Equipped]: %s/%s\n" % (
-            sockets["equipped_gems"], sockets["total_sockets"])
-
-        # Enchants
-        return_string += "[Enchants]: %s/%s\n" % (enchants["enchantable_slots"] - enchants["total_missing"],
-                                                enchants["enchantable_slots"])
-        if enchants["total_missing"] > 0:
-            return_string += "[Missing Enchants]: {0}".format(
-                ", ".join(enchants["missing_slots"]))
-
-        # Stats
-        return_string += "\n"
-        return_string += "[Health]: {}   [{}]: {}\n".format(health, powertypeproper, power)
-        return_string += "[Str]: {}  [Agi]: {}\n".format(strength, agi, int, sta)
-        return_string += "[Int]: {}  [Sta]: {}\n".format(int, sta)
-        return_string += "[Crit]:    {}, {}%   [Haste]: {}, {}%\n".format(crit, critrating, haste, hasterating,)
-        return_string += "[Mastery]: {}, {}%   [Vers]:  {}, {}% bonus damage\n".format(mastery, masteryrating, vers, versrating)
-
-        return_string += '```'  # end Markdown
-        return return_string
-
-    @commands.command(name="pug", pass_context=True, no_pm=True)
-    async def _pug(self, ctx, *, message):
-        """A Warcraft Armory character lookup tool.
-        Use: !pug <name> <server> <region>
-        Hyphenate two-word servers (Ex: Twisting-Nether)."""
-        self.settings = dataIO.load_json("data/pug/config.json")  # Load Configs
-        default_region = self.settings["default_region"]
-        target_region = default_region
-        channel = ctx.message.channel
-        try:
-            i = str(ctx.message.content).split(' ')
-            name = i[1]
-            server = i[2]
-            if len(i) == 4 and i[3].lower() in self.region_locale.keys():
-                target_region = i[3].lower()
-            character_info = self.get_char(name, server, target_region)
-            await self.bot.send_message(ctx.message.channel, character_info)
-        except Exception as e:
-            print(e)
-            await self.bot.send_message(ctx.message.channel, "Error with character name or server.")
-
-    @commands.command(pass_context=True, name='pugtoken')
-    @checks.is_owner()
-    async def _pugtoken(self, context, key: str):
-        """Sets the token for the Blizzard API.
-        You can use this command in a private message to the bot.
-
-        Get an API token at: https://dev.battle.net/member/register"""
-        settings = dataIO.load_json(self.fp)
-        settings['blizzard_api_key'] = key
-        dataIO.save_json(self.fp, settings)
-        await self.bot.say("API key set.")
-
-    @commands.command(pass_context=True, name='pugregion')
-    @checks.is_owner()
-    async def _pugregion(self, context, key: str):
-        """Sets the default region."""
-        settings = dataIO.load_json(self.fp)
-        settings['default_region'] = key
-        dataIO.save_json(self.fp, settings)
-        await self.bot.say("Default region set.")
-
-    @commands.command()
-    async def pugcredits(self):
-        """Code credits."""
-        message = await self._credit()
-        await self.bot.say(message)
-
-    async def _credit(self):
-        message = "```This cog is made possible by Pugbot.\n"
-        message+= "Please visit https://github.com/reznok/PugBot for more information.\n"
-        message+= "```"
-        return message
-
-
-def check_folders():
-    if not os.path.exists("data/pug"):
-        print("Creating data/pug folder...")
-        os.mkdir("data/pug")
-
-
-def check_files():
-    fp = "data/pug/config.json"
-    if not dataIO.is_valid_json(fp):
-        print("Creating config.json...")
-        dataIO.save_json(fp, {"blizzard_api_key": "", "default_region": "us"})
-
-
-def setup(bot):
-    check_folders()
-    check_files()
-    n = Pug(bot)
-    bot.add_cog(n)

quiz/__init__.py

@@ -0,0 +1,7 @@
+from .quiz import Quiz
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(Quiz(bot))

quiz/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["Keane", "aikaterna"],
+    "description": "Play a kahoot-like trivia game.",
+    "install_msg": "Thanks for installing.",
+    "short": "Play a kahoot-like trivia game.",
+    "tags": ["trivia", "quiz"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

quiz/quiz.py

@@ -0,0 +1,533 @@
+import aiohttp
+import asyncio
+import datetime
+import discord
+import html
+import logging
+import math
+import random
+import time
+
+from redbot.core import bank, checks, commands, Config
+from redbot.core.errors import BalanceTooHigh
+from redbot.core.utils.chat_formatting import box
+
+
+log = logging.getLogger("red.aikaterna.quiz")
+
+
+def check_global_setting_admin():
+    """
+    Command decorator. If the bank is not global, it checks if the author is
+    either a bot admin or has the manage_guild permission.
+    """
+
+    async def pred(ctx: commands.Context):
+        author = ctx.author
+        if not await bank.is_global():
+            if not isinstance(ctx.channel, discord.abc.GuildChannel):
+                return False
+            if await ctx.bot.is_owner(author):
+                return True
+            if author == ctx.guild.owner:
+                return True
+            if ctx.channel.permissions_for(author).manage_guild:
+                return True
+            admin_role_ids = await ctx.bot.get_admin_role_ids(ctx.guild.id)
+            for role in author.roles:
+                if role.id in admin_role_ids:
+                    return True
+        else:
+            return await ctx.bot.is_owner(author)
+
+    return commands.check(pred)
+
+
+class Quiz(commands.Cog):
+    """
+    Play a kahoot-like trivia game with questions from Open Trivia Database.
+    Originally by Keane for Red v2
+    """
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+
+        self.game_tasks = []
+        self.playing_channels = {}
+        self.session = aiohttp.ClientSession()
+        self.starter_task = self.bot.loop.create_task(self.start_loop())
+
+        self.config = Config.get_conf(self, 2782511001, force_registration=True)
+        default_guild = {
+            "afk": 3,
+            "multiplier": 100,
+            "questions": 20,
+            "show_answer": True,
+            "token": None,
+        }
+        self.config.register_guild(**default_guild)
+
+    @commands.guild_only()
+    @commands.group()
+    async def quiz(self, ctx):
+        """Play a kahoot-like trivia game.
+        Questions from the Open Trivia Database.
+
+        In this game, you will compete with other players to correctly answer each
+        question as quickly as you can. You have 10 seconds to type the answer
+        choice before time runs out. The longer you take to say the right answer,
+        the fewer points you get. If you get it wrong, you get no points. Only the
+        first valid answer (A, B, C, or D) will be recorded - be sure of the
+        answer before replying!
+
+        To end the game, stop responding to the questions and the game will time out.
+        """
+        pass
+
+    @quiz.command(name="play")
+    async def quiz_play(self, ctx, *, category_name_or_id=None):
+        """
+        Create or join a quiz game.
+        Specify a category name or ID number, otherwise it will be random.
+        Use [p]quiz categories to list category names or id numbers.
+        """
+        channel = ctx.message.channel
+        player = ctx.message.author
+
+        if not category_name_or_id:
+            # random
+            category_id = await self.category_selector()
+            category_name = await self.category_name_from_id(category_id)
+
+        elif category_name_or_id.isdigit():
+            # cat id specified
+            if 9 <= int(category_name_or_id) >= 32:
+                return await ctx.send(f"Invalid category number. Use `{ctx.prefix}quiz categories` to see a list.")
+            category_id = category_name_or_id
+            try:
+                category_name = await self.category_name_from_id(int(category_name_or_id))
+            except RuntimeError:
+                return await ctx.send(f"Invalid category ID. Use `{ctx.prefix}quiz categories` to see a list.")
+        else:
+            # cat name specified
+            try:
+                category_name = await self.category_name_match(category_name_or_id)
+            except RuntimeError:
+                return await ctx.send(f"Invalid category name. Use `{ctx.prefix}quiz categories` to see a list.")
+            category_id = await self.category_id_from_name(category_name)
+
+        if channel.id not in self.playing_channels:
+            self.playing_channels[channel.id] = {
+                "Start": datetime.datetime.utcnow(),
+                "Started": False,
+                "Players": {player.id: 0},
+                "Answers": {},
+                "Category": str(category_name),
+                "CategoryID": int(category_id),
+            }
+            return await ctx.send(
+                f"{player.display_name} is starting a quiz game!\n"
+                f"Category: `{category_name}`\n"
+                f"It will start in 30 seconds. Use `{ctx.prefix}quiz play` to join."
+            )
+
+        channelinfo = self.playing_channels[channel.id]
+        if player.id in channelinfo["Players"]:
+            await ctx.send("You are already in the game.")
+        elif channelinfo["Started"]:
+            await ctx.send("A quiz game is already underway.")
+        else:
+            channelinfo["Players"][player.id] = 0
+            await ctx.send(f"{player.display_name} joined the game.")
+
+    @quiz.command(name="categories")
+    async def quiz_cat(self, ctx):
+        """List quiz categories."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            msg = f"[Category Name]{' ' * 24}[ID]\n"
+            for cat_dict in response_json["trivia_categories"]:
+                padding = 40 - len(cat_dict["name"])
+                msg += f"{cat_dict['name']}{' ' * padding}{cat_dict['id']}\n"
+        embed = discord.Embed(description=box(msg, lang="ini"))
+        await ctx.send(embed=embed)
+
+    @commands.guild_only()
+    @commands.group()
+    @checks.mod_or_permissions(manage_guild=True)
+    async def quizset(self, ctx):
+        """Quiz settings."""
+        if ctx.invoked_subcommand is None:
+            guild_data = await self.config.guild(ctx.guild).all()
+            msg = (
+                f"[Quiz Settings for {ctx.guild.name}]\n"
+                f"AFK questions before end: {guild_data['afk']}\n"
+                f"Credit multiplier:        {guild_data['multiplier']}x\n"
+                f"Number of questions:      {guild_data['questions']}\n"
+                f"Reveal correct answer:    {guild_data['show_answer']}\n"
+            )
+            await ctx.send(box(msg, lang="ini"))
+
+    @quizset.command(name="afk")
+    async def quizset_afk(self, ctx, questions: int):
+        """Set number of questions before the game ends due to non-answers."""
+        if 1 <= questions <= 10:
+            await self.config.guild(ctx.guild).afk.set(questions)
+            plural = "" if int(questions) == 1 else "s"
+            return await ctx.send(
+                f"{questions} question{plural} will be asked before the game times out. "
+                "A question will be counted in this afk count if 0 or 1 person answers. "
+                "2 or more answers on a question will not trigger this counter."
+            )
+        await ctx.send("Please use a number between 1 and 10. The default is 3.")
+
+    @quizset.command(name="show")
+    async def quizset_show(self, ctx):
+        """Toggle revealing the answers."""
+        show = await self.config.guild(ctx.guild).show_answer()
+        await self.config.guild(ctx.guild).show_answer.set(not show)
+        await ctx.send(f"Question answers will be revealed during the game: {not show}")
+
+    @quizset.command(name="questions")
+    async def quizset_questions(self, ctx, questions: int):
+        """Set number of questions per game."""
+        if 5 <= questions <= 50:
+            await self.config.guild(ctx.guild).questions.set(questions)
+            return await ctx.send(f"Number of questions per game: {questions}")
+        await ctx.send("Please use a number between 5 and 50. The default is 20.")
+
+    @check_global_setting_admin()
+    @quizset.command(name="multiplier")
+    async def quizset_multiplier(self, ctx, multiplier: int):
+        """
+        Set the credit multiplier.
+        The accepted range is 0 - 10000.
+        0 will turn credit gain off.
+        Credit gain will be based on the number of questions set and user speed.
+        1x = A small amount of credits like 1-10.
+        100x = A handful of credits: 100-500.
+        10000x = Quite a lot of credits, around 10k to 50k.
+		"""
+        if 0 <= multiplier <= 10000:
+            await self.config.guild(ctx.guild).multiplier.set(multiplier)
+            credits_name = await bank.get_currency_name(ctx.guild)
+            return await ctx.send(f"Credit multipilier: `{multiplier}x`")
+        await ctx.send("Please use a number between 0 and 10000. The default is 100.")
+
+    async def start_loop(self):
+        """Starts quiz games when the timeout period ends."""
+        try:
+            while True:
+                for channelid in list(self.playing_channels):
+                    channelinfo = self.playing_channels[channelid]
+                    since_start = (datetime.datetime.utcnow() - channelinfo["Start"]).total_seconds()
+
+                    if since_start > 30 and not channelinfo["Started"]:
+                        channel = self.bot.get_channel(channelid)
+                        if len(channelinfo["Players"]) > 1:
+                            channelinfo["Started"] = True
+                            task = self.bot.loop.create_task(self.game(channel))
+                            self.game_tasks.append(task)
+                        else:
+                            await channel.send("Nobody else joined the quiz game.")
+                            self.playing_channels.pop(channelid)
+                await asyncio.sleep(2)
+        except Exception:
+            log.error("Error in Quiz start loop.", exc_info=True)
+
+    async def game(self, channel):
+        """Runs a quiz game on a channel."""
+        channelinfo = self.playing_channels[channel.id]
+        category = channelinfo["CategoryID"]
+        category_name = channelinfo["Category"]
+
+        try:
+            response = await self.get_questions(channel.guild, category=channelinfo["CategoryID"])
+        except RuntimeError:
+            await channel.send("An error occurred in retrieving questions. Please try again.")
+            self.playing_channels.pop(channel.id)
+            raise
+
+        # Introduction
+        intro = (
+            f"Welcome to the quiz game! Your category is `{category_name}`.\n"
+            "Remember to answer correctly as quickly as you can for more points.\n"
+            "You have 10 seconds per question: the timer is shown in reactions on each question.\n"
+            "The game will begin shortly."
+        )
+        await channel.send(intro)
+        await asyncio.sleep(4)
+
+        # Question and Answer
+        afk_questions = 0
+        for index, dictionary in enumerate(response["results"]):
+            answers = [dictionary["correct_answer"]] + dictionary["incorrect_answers"]
+
+            # Display question and countdown
+            if len(answers) == 2:  # true/false question
+                answers = ["True", "False", "", ""]
+            else:
+                answers = [html.unescape(answer) for answer in answers]
+                random.shuffle(answers)
+
+            message = ""
+            message += html.unescape(dictionary["question"]) + "\n"
+            message += f"A. {answers[0]}\n"
+            message += f"B. {answers[1]}\n"
+            message += f"C. {answers[2]}\n"
+            message += f"D. {answers[3]}\n"
+
+            message_obj = await channel.send(box(message))
+            await message_obj.add_reaction("0⃣")
+            channelinfo["Answers"].clear()  # clear the previous question's answers
+            start_time = time.perf_counter()
+
+            numbers = ["1⃣", "2⃣", "3⃣", "4⃣", "5⃣", "6⃣", "7⃣", "8⃣", "9⃣", "🔟"]
+            for i in range(10):
+                if len(channelinfo["Answers"]) == len(channelinfo["Players"]):
+                    break
+                await asyncio.sleep(1)
+                await message_obj.add_reaction(numbers[i])
+
+            # Organize answers
+            user_answers = channelinfo["Answers"]
+            # snapshot channelinfo["Answers"] at this point in time
+            # to ignore new answers that are added to it
+            answerdict = {["a", "b", "c", "d"][num]: answers[num] for num in range(4)}
+
+            # Check for AFK
+            if len(user_answers) < 2:
+                afk_questions += 1
+                afk_count = await self.config.guild(channel.guild).afk()
+                if afk_questions == int(afk_count):
+                    await channel.send("The game has been cancelled due to lack of participation.")
+                    self.playing_channels.pop(channel.id)
+                    return
+            else:
+                afk_questions = 0
+
+            # Find and display correct answer
+            correct_letter = ""
+            for letter, answer in answerdict.items():
+                if answer == html.unescape(dictionary["correct_answer"]):
+                    correct_letter = letter
+                    break
+            assert answerdict[correct_letter] == html.unescape(dictionary["correct_answer"])
+
+            if await self.config.guild(channel.guild).show_answer():
+                message = f"Correct answer:```{correct_letter.upper()}. {answerdict[correct_letter]}```"
+                await channel.send(message)
+
+            # Assign scores
+            for playerid in user_answers:
+                if user_answers[playerid]["Choice"] == correct_letter:
+                    time_taken = user_answers[playerid]["Time"] - start_time
+                    assert time_taken > 0
+                    if time_taken < 1:
+                        channelinfo["Players"][playerid] += 1000
+                    else:
+                        # the 20 in the formula below is 2 * 10s (max answer time)
+                        channelinfo["Players"][playerid] += round(1000 * (1 - (time_taken / 20)))
+
+            # Display top 5 players and their points
+            message = self.scoreboard(channel)
+            await channel.send("Scoreboard:\n" + message)
+            await asyncio.sleep(4)
+
+            questions = await self.config.guild(channel.guild).questions()
+            if index < (int(questions) - 1):
+                await channel.send("Next question...")
+                await asyncio.sleep(1)
+
+        await self.end_game(channel)
+
+    async def end_game(self, channel):
+        """Ends a quiz game."""
+        # non-linear credit earning .0002x^{2.9} where x is score/100
+        channelinfo = self.playing_channels[channel.id]
+        idlist = sorted(list(channelinfo["Players"]), key=(lambda idnum: channelinfo["Players"][idnum]), reverse=True,)
+
+        winner = channel.guild.get_member(idlist[0])
+        await channel.send(f"Game over! {winner.mention} won!")
+
+        multiplier = await self.config.guild(channel.guild).multiplier()
+        if multiplier == 0:
+            self.playing_channels.pop(channel.id)
+            return
+
+        leaderboard = "\n"
+        max_credits = self.calculate_credits(channelinfo["Players"][idlist[0]])
+        end_len = len(str(max_credits)) + 1
+        rank_len = len(str(len(channelinfo["Players"])))
+        rank = 1
+
+        for playerid in idlist:
+            player = channel.guild.get_member(playerid)
+
+            if len(player.display_name) > 25 - rank_len - end_len:
+                name = player.display_name[: 22 - rank_len - end_len] + "..."
+            else:
+                name = player.display_name
+
+            leaderboard += str(rank)
+            leaderboard += " " * (1 + rank_len - len(str(rank)))
+            leaderboard += name
+            creds = self.calculate_credits(channelinfo["Players"][playerid]) * int(multiplier)
+            creds_str = str(creds)
+            leaderboard += " " * (26 - rank_len - 1 - len(name) - len(creds_str))
+            leaderboard += creds_str + "\n"
+
+            try:
+                await bank.deposit_credits(player, creds)
+            except BalanceTooHigh as e:
+                await bank.set_balance(player, e.max_balance)
+
+            rank += 1
+
+        await channel.send("Credits earned:\n" + box(leaderboard, lang="py"))
+        self.playing_channels.pop(channel.id)
+
+    def scoreboard(self, channel):
+        """Returns a scoreboard string to be sent to the text channel."""
+        channelinfo = self.playing_channels[channel.id]
+        scoreboard = "\n"
+        idlist = sorted(list(channelinfo["Players"]), key=(lambda idnum: channelinfo["Players"][idnum]), reverse=True,)
+        max_score = channelinfo["Players"][idlist[0]]
+        end_len = len(str(max_score)) + 1
+        rank = 1
+        for playerid in idlist[:5]:
+            player = channel.guild.get_member(playerid)
+            if len(player.display_name) > 24 - end_len:
+                name = player.display_name[: 21 - end_len] + "..."
+            else:
+                name = player.display_name
+            scoreboard += str(rank) + " " + name
+            score_str = str(channelinfo["Players"][playerid])
+            scoreboard += " " * (24 - len(name) - len(score_str))
+            scoreboard += score_str + "\n"
+            rank += 1
+        return box(scoreboard, lang="py")
+
+    def calculate_credits(self, score):
+        """Calculates credits earned from a score."""
+        adjusted = score / 100
+        if adjusted < 156.591:
+            result = 0.0002 * (adjusted ** 2.9)
+        else:
+            result = (0.6625 * math.exp(0.0411 * adjusted)) + 50
+        return round(result)
+
+    @commands.Cog.listener()
+    async def on_message_without_command(self, message):
+        if not message.guild:
+            return
+        authorid = message.author.id
+        channelid = message.channel.id
+        choice = message.content.lower()
+        if channelid in self.playing_channels:
+            channelinfo = self.playing_channels[channelid]
+            if (
+                authorid in channelinfo["Players"]
+                and authorid not in channelinfo["Answers"]
+                and choice in {"a", "b", "c", "d"}
+            ):
+                channelinfo["Answers"][authorid] = {"Choice": choice, "Time": time.perf_counter()}
+
+    # OpenTriviaDB API functions
+    async def get_questions(self, server, category=None, difficulty=None):
+        """Gets questions, resetting a token or getting a new one if necessary."""
+        questions = await self.config.guild(server).questions()
+        parameters = {"amount": questions}
+        if category:
+            parameters["category"] = category
+        if difficulty:
+            parameters["difficulty"] = difficulty
+        for _ in range(3):
+            parameters["token"] = await self.get_token(server)
+            async with self.session.get("https://opentdb.com/api.php", params=parameters) as response:
+                response_json = await response.json()
+                response_code = response_json["response_code"]
+                if response_code == 0:
+                    return response_json
+                elif response_code == 1:
+                    raise RuntimeError("Question retrieval unsuccessful. Response code from OTDB: 1")
+                elif response_code == 2:
+                    raise RuntimeError("Question retrieval unsuccessful. Response code from OTDB: 2")
+                elif response_code == 3:
+                    # Token expired. Obtain new one.
+                    log.debug("Quiz: Response code from OTDB: 3")
+                    await self.config.guild(server).token.set(None)
+                elif response_code == 4:
+                    # Token empty. Reset it.
+                    log.debug("Quiz: Response code from OTDB: 4")
+                    await self.reset_token(server)
+        raise RuntimeError("Failed to retrieve questions.")
+
+    async def get_token(self, server):
+        """Gets the provided server's token, or generates
+        and saves one if one doesn't exist."""
+        token = await self.config.guild(server).token()
+        if not token:
+            async with self.session.get("https://opentdb.com/api_token.php", params={"command": "request"}) as response:
+                response_json = await response.json()
+                token = response_json["token"]
+                await self.config.guild(server).token.set(token)
+        return token
+
+    async def reset_token(self, server):
+        """Resets the provided server's token."""
+        token = await self.config.guild(server).token()
+        async with self.session.get(
+            "https://opentdb.com/api_token.php", params={"command": "reset", "token": token}
+        ) as response:
+            response_code = (await response.json())["response_code"]
+            if response_code != 0:
+                raise RuntimeError(f"Token reset was unsuccessful. Response code from OTDB: {response_code}")
+
+    async def category_selector(self):
+        """Chooses a random category that has enough questions."""
+        for _ in range(10):
+            category = random.randint(9, 32)
+            async with self.session.get("https://opentdb.com/api_count.php", params={"category": category}) as response:
+                response_json = await response.json()
+                assert response_json["category_id"] == category
+                if response_json["category_question_count"]["total_question_count"] > 39:
+                    return category
+        raise RuntimeError("Failed to select a category.")
+
+    async def category_name_from_id(self, idnum):
+        """Finds a category's name from its number."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            for cat_dict in response_json["trivia_categories"]:
+                if cat_dict["id"] == idnum:
+                    return cat_dict["name"]
+        raise RuntimeError("Failed to find category's name.")
+
+    async def category_name_match(self, name):
+        """Check if a category name exists."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            for cat_dict in response_json["trivia_categories"]:
+                if cat_dict["name"].lower() == name.lower():
+                    return cat_dict["name"]
+        raise RuntimeError("Failed to find category's name.")
+
+    async def category_id_from_name(self, name):
+        """Finds a category's name from its number."""
+        async with self.session.get("https://opentdb.com/api_category.php") as response:
+            response_json = await response.json()
+            for cat_dict in response_json["trivia_categories"]:
+                if cat_dict["name"] == name:
+                    return cat_dict["id"]
+        raise RuntimeError("Failed to find category's id.")
+
+    def cog_unload(self):
+        self.bot.loop.create_task(self.session.close())
+        self.starter_task.cancel()
+        for task in self.game_tasks:
+            task.cancel()

radio/info.json

@@ -1,7 +0,0 @@
-{
-    "AUTHOR" : "Paddo, with edits by aikaterna",
-    "NAME" : "radio",
-    "SHORT" : "Plays http streams like icecast or mp3 streams.",
-    "DESCRIPTION" : "This cog can only be used with audio unloaded. To play m3u or pls files, extract the http stream url they contain and use that - this cog can remember urls for later playback.",
-    "TAGS": ["radio", "stream", "icecast"]
-}

radio/radio.py

@@ -1,161 +0,0 @@
-import os
-import discord
-import asyncio
-from discord.ext import commands
-from __main__ import send_cmd_help
-from cogs.utils.dataIO import dataIO
-
-
-class Radio:
-    def __init__(self, bot):
-        self.bot = bot
-        self.players = {}
-        self.memory_path = 'data/radio/memory.json'
-        self.memory = dataIO.load_json(self.memory_path)
-
-    @commands.group(pass_context=True, no_pm=True, name='radio')
-    async def _radio(self, ctx):
-        """Streaming audio commands."""
-        audio_cog = self.bot.get_cog('Audio')
-        if audio_cog:
-            return await self.bot.say("Please unload the audio cog before using this cog.")
-        if ctx.invoked_subcommand is None:
-            await send_cmd_help(ctx)
-
-    @_radio.command(pass_context=True, no_pm=True, name='stop')
-    async def _leave(self, ctx):
-        """Stops playback."""
-        server = ctx.message.server
-        voice_client = await self.voice_client(server)
-        await self.stop_playing(server)
-        if voice_client:
-            await voice_client.disconnect()
-
-    @_radio.command(no_pm=True, pass_context=True, name='play')
-    async def _play(self, ctx, url: str):
-        """Play a http stream."""
-        server = ctx.message.server
-        if server.id in self.players:
-            await self.stop_playing(server)
-        await self.play_stream(ctx, url)
-        await self.bot.say("Now playing: <{}>".format(url))
-
-    @_radio.command(no_pm=True, pass_context=True, name='list')
-    async def _list(self, ctx):
-        """List saved stream URLs."""
-        server = ctx.message.server
-        message = '```\n'
-        message += '{:<30}{}\n\n'.format('NAME', 'URL')
-        if server.id in self.memory:
-            for stream in self.memory[server.id]:
-                message += '{:<30}{}\n'.format(stream, self.memory[server.id][stream])
-        message += '```'
-        await self.bot.say(message)
-
-    @_radio.command(no_pm=True, pass_context=True, name='add')
-    async def _add(self, ctx, name: str, url: str):
-        """Add a url to save for radio playback."""
-        server = ctx.message.server
-        await self.add_to_memory(server, name, url)
-        await self.bot.say('Added to memory')
-
-    @_radio.command(no_pm=True, pass_context=True, name='load')
-    async def _load(self, ctx, name: str):
-        """Load a saved url for radio playback."""
-        server = ctx.message.server
-        if server.id in self.memory:
-            if name.lower() in self.memory[server.id]:
-                url = self.memory[server.id][name.lower()]
-                if server.id in self.players:
-                    await self.stop_playing(server)
-                await self.play_stream(ctx, url)
-                await self.bot.say("Now playing: <{}>".format(url))
-            else:
-                await self.bot.say('"{}" is not in memory.'.format(name.lower()))
-        else:
-            await self.bot.say('Nothing in memory yet')
-
-    async def save_memory(self):
-        dataIO.save_json(self.memory_path, self.memory)
-
-    async def add_to_memory(self, server, name, url):
-        if server.id not in self.memory:
-            self.memory[server.id] = {}
-        self.memory[server.id][name.lower()] = url
-        await self.save_memory()
-
-    async def join_voice_channel(self, channel):
-        try:
-            await self.bot.join_voice_channel(channel)
-            return True
-        except discord.InvalidArgument:
-            await self.bot.say('You need to be in a voice channel yourself.')
-        except discord.Forbidden:
-            await self.bot.say('I don\'t have permissions to join this channel.')
-        return False
-
-    async def leave_voice_channel(self, server):
-        voice_client = await self.voice_client(server)
-        if server.id in self.players:
-            self.players[server.id].stop()
-            del self.players[server.id]
-            await self.stop_playing(server)
-        await voice_client.disconnect()
-
-    async def voice_connected(self, server):
-        return self.bot.is_voice_connected(server)
-
-    async def voice_client(self, server):
-        return self.bot.voice_client_in(server)
-
-    async def stop_playing(self, server):
-        if server.id in self.players:
-            self.players[server.id].stop()
-            del self.players[server.id]
-
-    async def start_playing(self, server, url):
-        if server.id not in self.players:
-            voice_client = await self.voice_client(server)
-            audio_player = voice_client.create_ffmpeg_player(url)
-            self.players[server.id] = audio_player
-            self.players[server.id].start()
-
-    async def play_stream(self, ctx, url):
-        server = ctx.message.server
-        channel = ctx.message.author.voice_channel
-        if not ctx.message.channel.is_private:
-            check = True
-            if not await self.voice_connected(server):
-                check = await self.join_voice_channel(channel)
-            if check:
-                await self.start_playing(server, url)
-
-    async def _playing_check(self):
-        while self == self.bot.get_cog('Radio'):
-            for player in self.players:
-                if not self.players[player].is_playing():
-                    server = self.bot.get_server(player)
-                    await self.leave_voice_channel(server)
-                    break
-            await asyncio.sleep(30)
-
-
-def check_folder():
-    if not os.path.exists('data/radio'):
-        print('Creating data/radio folder...')
-        os.makedirs('data/radio')
-
-
-def check_file():
-    if not dataIO.is_valid_json('data/radio/memory.json'):
-        print('Creating memory.json...')
-        dataIO.save_json('data/radio/memory.json', {})
-
-
-def setup(bot):
-    check_folder()
-    check_file()
-    cog = Radio(bot)
-    loop = asyncio.get_event_loop()
-    loop.create_task(cog._playing_check())
-    bot.add_cog(cog)

reminder/LICENSE

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

reminder/__init__.py

@@ -0,0 +1,12 @@
+from .reminder import Reminder
+
+__red_end_user_data_statement__ = (
+    "This cog stores data provided by users for the express purpose of redisplaying. "
+    "It does not store user data which was not provided through a command. "
+    "Users may remove their own content without making a data removal request. "
+    "This cog does not support data requests, but will respect deletion requests."
+)
+
+
+async def setup(bot):
+    bot.add_cog(Reminder(bot))

reminder/info.json

@@ -0,0 +1,10 @@
+{
+    "author" : ["ZeLarpMaster#0818", "aikaterna"],
+    "description" : "Lets users tell the bot to remind them about anything they want. Originally by ZeLarpMaster.",
+    "install_msg" : "Enjoy reminding yourself of whatever you wanna remind yourself of! Use `[p]help Reminder` to get started.\nIf you have had ZeLarpMaster's version of Reminder installed in the past, this version of it uses the same data location for ease of switching to a supported version of the cog, as his repo has been archived.",
+    "short" : "Allows users to remind themselves about anything they want.",
+    "hidden": false,
+    "disabled": false,
+    "permissions" : ["embed_links"],
+    "tags" : ["remind", "reminder", "remindme"]
+}

reminder/reminder.py

@@ -0,0 +1,264 @@
+# Reminder was originally written by ZeLarpMaster#0818
+# https://github.com/ZeLarpMaster/ZeCogsV3/blob/master/reminder/reminder.py
+
+import asyncio
+import collections
+import datetime
+import discord
+import hashlib
+from itertools import islice
+from math import ceil
+import re
+from typing import List, Literal, Optional
+
+from redbot.core import commands, Config
+from redbot.core.bot import Red
+from redbot.core.commands import Context
+from redbot.core.utils.menus import menu, DEFAULT_CONTROLS
+
+
+class Reminder(commands.Cog):
+    """Utilities to remind yourself of whatever you want"""
+
+    __author__ = ["ZeLarpMaster#0818", "aikaterna#1393"]
+
+    TIME_AMNT_REGEX = re.compile("([1-9][0-9]*)([a-z]+)", re.IGNORECASE)
+    TIME_QUANTITIES = collections.OrderedDict(
+        [
+            ("seconds", 1),
+            ("minutes", 60),
+            ("hours", 3600),
+            ("days", 86400),
+            ("weeks", 604800),
+            ("months", 2628000),
+            ("years", 31540000),
+        ]
+    )
+    MAX_SECONDS = TIME_QUANTITIES["years"] * 2
+
+    async def red_delete_data_for_user(
+        self,
+        *,
+        requester: Literal["discord", "owner", "user", "user_strict"],
+        user_id: int,
+    ):
+        await self.config.user_from_id(user_id).clear()
+
+    def __init__(self, bot: Red):
+        super().__init__()
+        self.bot = bot
+        unique_id = int(hashlib.sha512((self.__author__[0] + "@" + self.__class__.__name__).encode()).hexdigest(), 16)
+        self.config = Config.get_conf(self, identifier=unique_id, force_registration=True)
+        self.config.register_user(reminders=[], offset=0)
+        self.futures = {}
+        asyncio.ensure_future(self.start_saved_reminders())
+
+    def cog_unload(self):
+        for user_futures in self.futures.values():
+            for future in user_futures:
+                future.cancel()
+
+    @commands.group(invoke_without_command=True, aliases=["remindme"], name="remind")
+    async def command_remind(self, ctx: Context, time: str, *, reminder_text: str):
+        """
+        Remind yourself of something in a specific amount of time
+
+        Examples for time: `5d`, `10m`, `10m30s`, `1h`, `1y1mo2w5d10h30m15s`
+        Abbreviations: `s` for seconds, `m` for minutes, `h` for hours, `d` for days, `w` for weeks, `mo` for months, `y` for years
+        Any longer abbreviation is accepted. `m` assumes minutes instead of months.
+        One month is counted as exact 365/12 days.
+        Ignores all invalid abbreviations.
+        """
+        seconds = self.get_seconds(time)
+        if seconds is None:
+            response = ":x: Invalid time format."
+        elif seconds >= self.MAX_SECONDS:
+            response = f":x: Too long amount of time. Maximum: 2 years"
+        else:
+            user = ctx.message.author
+            time_now = datetime.datetime.utcnow()
+            days, secs = divmod(seconds, 3600 * 24)
+            end_time = time_now + datetime.timedelta(days=days, seconds=secs)
+            reminder = {"content": reminder_text, "start_time": time_now.timestamp(), "end_time": end_time.timestamp()}
+            async with self.config.user(user).reminders() as user_reminders:
+                user_reminders.append(reminder)
+            self.futures.setdefault(user.id, []).append(
+                asyncio.ensure_future(self.remind_later(user, seconds, reminder_text, reminder))
+            )
+            user_offset = await self.config.user(ctx.author).offset()
+            offset = user_offset * 3600
+            formatted_time = round(end_time.timestamp()) + offset
+            if seconds > 86400:
+                response = f":white_check_mark: I will remind you of that on <t:{int(formatted_time)}:F>."
+            else:
+                response = f":white_check_mark: I will remind you of that in {self.time_from_seconds(seconds)}."
+        await ctx.send(response)
+
+    @command_remind.group(name="forget")
+    async def command_remind_forget(self, ctx: Context):
+        """Forget your reminders"""
+        pass
+
+    @command_remind_forget.command(name="all")
+    async def command_remind_forget_all(self, ctx: Context):
+        """Forget **all** of your reminders"""
+        for future in self.futures.get(ctx.message.author.id, []):
+            future.cancel()
+        async with self.config.user(ctx.message.author).reminders() as user_reminders:
+            user_reminders.clear()
+        await ctx.send(":put_litter_in_its_place: Forgot **all** of your reminders!")
+
+    @command_remind_forget.command(name="one")
+    async def command_remind_forget_one(self, ctx: Context, index_number_of_reminder: int):
+        """
+        Forget one of your reminders
+
+        Use `[p]remind list` to find the index number of the reminder you wish to forget.
+        """
+        async with self.config.user(ctx.message.author).all() as user_data:
+            if not user_data["reminders"]:
+                await ctx.send("You don't have any reminders saved.")
+                return
+            time_sorted_reminders = sorted(user_data["reminders"], key=lambda x: (x["end_time"]))
+            try:
+                removed = time_sorted_reminders.pop(index_number_of_reminder - 1)
+            except IndexError:
+                await ctx.send(f"There is no reminder at index {index_number_of_reminder}.")
+                return
+            user_data["reminders"] = time_sorted_reminders
+            offset = user_data["offset"] * 3600
+            end_time = round((removed["end_time"]) + offset)
+            msg = f":put_litter_in_its_place: Forgot reminder **#{index_number_of_reminder}**\n"
+            msg += f"Date: <t:{end_time}:f>\nContent: `{removed['content']}`"
+            await ctx.send(msg)
+
+    @command_remind.command(name="list")
+    async def command_remind_list(self, ctx: Context):
+        """List your reminders"""
+        user_data = await self.config.user(ctx.message.author).all()
+        if not user_data["reminders"]:
+            await ctx.send("There are no reminders to show.")
+            return
+
+        if not ctx.channel.permissions_for(ctx.me).embed_links:
+            return await ctx.send("I need the `Embed Messages` permission here to be able to display this information.")
+
+        embed_pages = await self.create_remind_list_embeds(ctx, user_data)
+        await ctx.send(embed=embed_pages[0]) if len(embed_pages) == 1 else await menu(
+            ctx, embed_pages, DEFAULT_CONTROLS
+        )
+
+    @command_remind.command(name="offset")
+    async def command_remind_offset(self, ctx: Context, offset_time_in_hours: str):
+        """
+        Set a basic timezone offset
+        from the default of UTC for use in [p]remindme list.
+
+        This command accepts number values from `-23.75` to `+23.75`.
+        You can look up your timezone offset on https://en.wikipedia.org/wiki/List_of_UTC_offsets
+        """
+        offset = self.remind_offset_check(offset_time_in_hours)
+        if offset is not None:
+            await self.config.user(ctx.author).offset.set(offset)
+            await ctx.send(f"Your timezone offset was set to {str(offset).replace('.0', '')} hours from UTC.")
+        else:
+            await ctx.send(f"That doesn't seem like a valid hour offset. Check `{ctx.prefix}help remind offset`.")
+
+    @staticmethod
+    async def chunker(input: List[dict], chunk_size: int) -> List[List[str]]:
+        chunk_list = []
+        iterator = iter(input)
+        while chunk := list(islice(iterator, chunk_size)):
+            chunk_list.append(chunk)
+        return chunk_list
+
+    async def create_remind_list_embeds(self, ctx: Context, user_data: dict) -> List[discord.Embed]:
+        """Embed creator for command_remind_list."""
+        offset = user_data["offset"] * 3600
+        reminder_list = []
+        time_sorted_reminders = sorted(user_data["reminders"], key=lambda x: (x["end_time"]))
+        entry_size = len(str(len(time_sorted_reminders)))
+
+        for i, reminder_dict in enumerate(time_sorted_reminders, 1):
+            entry_number = f"{str(i).zfill(entry_size)}"
+            end_time = round((reminder_dict["end_time"]) + offset)
+            exact_time_timestamp = f"<t:{end_time}:f>"
+            relative_timestamp = f"<t:{end_time}:R>"
+            content = reminder_dict["content"]
+            display_content = content if len(content) < 200 else f"{content[:200]} [...]"
+            reminder = f"`{entry_number}`. {exact_time_timestamp}, {relative_timestamp}:\n{display_content}\n\n"
+            reminder_list.append(reminder)
+
+        reminder_text_chunks = await self.chunker(reminder_list, 7)
+        max_pages = ceil(len(reminder_list) / 7)
+        offset_hours = str(user_data["offset"]).replace(".0", "")
+        offset_text = f" • UTC offset of {offset_hours}h applied" if offset != 0 else ""
+        menu_pages = []
+        for chunk in reminder_text_chunks:
+            embed = discord.Embed(title="", description="".join(chunk))
+            embed.set_author(name=f"Reminders for {ctx.author}", icon_url=ctx.author.avatar_url)
+            embed.set_footer(text=f"Page {len(menu_pages) + 1} of {max_pages}{offset_text}")
+            menu_pages.append(embed)
+        return menu_pages
+
+    def get_seconds(self, time: str):
+        """Returns the amount of converted time or None if invalid"""
+        seconds = 0
+        for time_match in self.TIME_AMNT_REGEX.finditer(time):
+            time_amnt = int(time_match.group(1))
+            time_abbrev = time_match.group(2)
+            time_quantity = discord.utils.find(lambda t: t[0].startswith(time_abbrev), self.TIME_QUANTITIES.items())
+            if time_quantity is not None:
+                seconds += time_amnt * time_quantity[1]
+        return None if seconds == 0 else seconds
+
+    async def remind_later(self, user: discord.User, time: float, content: str, reminder):
+        """Reminds the `user` in `time` seconds with a message containing `content`"""
+        await asyncio.sleep(time)
+        embed = discord.Embed(title="Reminder", description=content, color=discord.Colour.blue())
+        await user.send(embed=embed)
+        async with self.config.user(user).reminders() as user_reminders:
+            user_reminders.remove(reminder)
+
+    @staticmethod
+    def remind_offset_check(offset: str) -> Optional[float]:
+        """Float validator for command_remind_offset."""
+        try:
+            offset = float(offset.replace("+", ""))
+        except ValueError:
+            return None
+        offset = round(offset * 4) / 4.0
+        if not -23.75 < offset < 23.75 or 23.75 < offset < -23.75:
+            return None
+        return offset
+
+    async def start_saved_reminders(self):
+        await self.bot.wait_until_red_ready()
+        user_configs = await self.config.all_users()
+        for user_id, user_config in list(user_configs.items()):  # Making a copy
+            for reminder in user_config["reminders"]:
+                user = self.bot.get_user(user_id)
+                if user is None:
+                    # Delete the reminder if the user doesn't have a mutual server anymore
+                    await self.config.user_from_id(user_id).clear()
+                else:
+                    time_diff = datetime.datetime.fromtimestamp(reminder["end_time"]) - datetime.datetime.utcnow()
+                    time = max(0.0, time_diff.total_seconds())
+                    fut = asyncio.ensure_future(self.remind_later(user, time, reminder["content"], reminder))
+                    self.futures.setdefault(user.id, []).append(fut)
+
+    @staticmethod
+    def time_from_seconds(seconds: int) -> str:
+        hours, remainder = divmod(seconds, 3600)
+        minutes, seconds = divmod(remainder, 60)
+        if hours:
+            msg = f"{hours} hour" if hours == 1 else f"{hours} hours"
+            if minutes != 0:
+                msg += f" and {minutes} minute" if minutes == 1 else f" and {minutes} minutes"
+        elif minutes:
+            msg = f"{minutes} minute" if minutes == 1 else f"{minutes} minutes"
+            if seconds != 0:
+                msg += f" and {seconds} second" if seconds == 1 else f" and {seconds} seconds"
+        else:
+            msg = f"{seconds} seconds" if seconds == 1 else f"and {seconds} seconds"
+        return msg

riot/info.json

@@ -1,8 +0,0 @@
-{
-    "AUTHOR" : "aikaterna",
-    "INSTALL_MSG" : "Thanks for installing riot.",
-    "NAME" : "Riot",
-    "SHORT" : "RIOT!",
-    "DESCRIPTION" : "Riot was a feature on the now-extinct Fredboat, requested by Mewleficent.",
-    "TAGS" : ["riot"]
-}

riot/riot.py

@@ -1,17 +0,0 @@
-import discord
-from discord.ext import commands
-
-
-class Riot:
-
-    def __init__(self, bot):
-        self.bot = bot
-
-    @commands.command(pass_context=True, no_pm=True)
-    async def riot(self, ctx, *, text: str):
-        """RIOT!"""
-        await self.bot.say('ヽ༼ຈل͜ຈ༽ﾉ **' + str(text) + '** ヽ༼ຈل͜ຈ༽ﾉ')
-
-
-def setup(bot):
-    bot.add_cog(Riot(bot))

rndstatus/__init__.py

@@ -0,0 +1,7 @@
+from .rndstatus import RndStatus
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+def setup(bot):
+    bot.add_cog(RndStatus(bot))

rndstatus/info.json

@@ -0,0 +1,9 @@
+{
+    "author": ["aikaterna", "Twentysix"],
+    "description": "Random statuses with an optional bot stats mode. Ported from Twentysix's v2 cog.",
+    "install_msg": "Thanks for installing, have fun.",
+    "short": "Random bot statuses",
+    "tags": ["status"],
+    "type": "COG",
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

rndstatus/rndstatus.py

@@ -0,0 +1,210 @@
+import re
+import discord
+from redbot.core import Config, commands, checks
+from redbot.core.utils import AsyncIter
+from random import choice as rndchoice
+from collections import defaultdict
+import contextlib
+import asyncio
+import logging
+
+
+log = logging.getLogger("red.aikaterna.rndstatus")
+
+
+class RndStatus(commands.Cog):
+    """Cycles random statuses or displays bot stats.
+    If a custom status is already set, it won't change it until
+    it's back to none. [p]set game"""
+
+    async def red_delete_data_for_user(self, **kwargs):
+        """ Nothing to delete """
+        return
+
+    def __init__(self, bot):
+        self.bot = bot
+        self.last_change = None
+        self.config = Config.get_conf(self, 2752521001, force_registration=True)
+
+        self.presence_task = asyncio.create_task(self.maybe_update_presence())
+
+        default_global = {
+            "botstats": False,
+            "delay": 300,
+            "statuses": ["her Turn()", "Tomb Raider II", "Transistor", "NEO Scavenger", "Python", "with your heart.",],
+            "streamer": "rndstatusstreamer",
+            "type": 0,
+            "status": 0,
+        }
+        self.config.register_global(**default_global)
+
+    def cog_unload(self):
+        self.presence_task.cancel()
+
+    @commands.group(autohelp=True)
+    @commands.guild_only()
+    @checks.is_owner()
+    async def rndstatus(self, ctx):
+        """Rndstatus group commands."""
+        pass
+
+    @rndstatus.command(name="set")
+    async def _set(self, ctx, *statuses: str):
+        """Sets Red's random statuses.
+        Accepts multiple statuses.
+        Must be enclosed in double quotes in case of multiple words.
+        Example:
+        [p]rndstatus set \"Tomb Raider II\" \"Transistor\" \"with your heart.\"
+        Shows current list if empty."""
+        saved_status = await self.config.statuses()
+        if statuses == () or "" in statuses:
+            msg = (
+                f"Current statuses: {(' | ').join(saved_status)}\n"
+                f"To set new statuses, use the instructions in `{ctx.prefix}help rndstatus set`."
+            )
+            return await ctx.send(msg)
+        await self.config.statuses.set(list(statuses))
+        await self.presence_updater()
+        await ctx.send("Done. Redo this command with no parameters to see the current list of statuses.")
+
+    @rndstatus.command(name="streamer")
+    async def _streamer(self, ctx: commands.Context, *, streamer=None):
+        """Set the streamer name needed for streaming statuses."""
+        saved_streamer = await self.config.streamer()
+        if streamer is None:
+            return await ctx.send(f"Current Streamer: {saved_streamer}")
+        await self.config.streamer.set(streamer)
+        await ctx.send("Done. Redo this command with no parameters to see the current streamer.")
+
+    @rndstatus.command()
+    async def botstats(self, ctx, *statuses: str):
+        """Toggle for a bot stats status instead of random messages."""
+        botstats = await self.config.botstats()
+        await self.config.botstats.set(not botstats)
+        await ctx.send(f"Botstats toggle: {not botstats}.")
+        await self.presence_updater()
+
+    @rndstatus.command()
+    async def delay(self, ctx, seconds: int):
+        """Sets interval of random status switch.
+        Must be 20 or superior."""
+        if seconds < 20:
+            seconds = 20
+        await self.config.delay.set(seconds)
+        await ctx.send(f"Interval set to {seconds} seconds.")
+
+    @rndstatus.command(name="type")
+    async def _rndstatus_type(self, ctx, status_type: int):
+        """Define the rndstatus game type.
+
+        Type list:
+        0 = Playing
+        1 = Streaming
+        2 = Listening
+        3 = Watching
+        5 = Competing"""
+        if 0 <= status_type <= 3 or 0 != 5:
+            rnd_type = {0: "playing", 1: "streaming", 2: "listening", 3: "watching", 5: "competing"}
+            await self.config.type.set(status_type)
+            await self.presence_updater()
+            await ctx.send(f"Rndstatus activity type set to {rnd_type[status_type]}.")
+        else:
+            await ctx.send(
+                f"Status activity type must be between 0 and 3 or 5. "
+                f"See `{ctx.prefix}help rndstatus type` for more information."
+            )
+
+    @rndstatus.command()
+    async def status(self, ctx, status: int):
+        """Define the rndstatus presence status.
+
+        Status list:
+        0 = Online
+        1 = Idle
+        2 = DND
+        3 = Invisible"""
+        if 0 <= status <= 3:
+            rnd_status = {0: "online", 1: "idle", 2: "DND", 3: "invisible"}
+            await self.config.status.set(status)
+            await self.presence_updater()
+            await ctx.send(f"Rndstatus presence status set to {rnd_status[status]}.")
+        else:
+            await ctx.send(
+                f"Status presence type must be between 0 and 3. "
+                f"See `{ctx.prefix}help rndstatus status` for more information."
+            )
+
+    async def maybe_update_presence(self):
+        await self.bot.wait_until_red_ready()
+        delay = await self.config.delay()
+        while True:
+            try:
+                await self.presence_updater()
+            except Exception:
+                log.exception("Something went wrong in maybe_update_presence task:")
+
+            await asyncio.sleep(int(delay))
+
+    async def presence_updater(self):
+        pattern = re.compile(rf"<@!?{self.bot.user.id}>")
+        cog_settings = await self.config.all()
+        guilds = self.bot.guilds
+        try:
+            guild = next(g for g in guilds if not g.unavailable)
+        except StopIteration:
+            return
+        try:
+            current_game = str(guild.me.activity.name)
+        except AttributeError:
+            current_game = None
+        statuses = cog_settings["statuses"]
+        botstats = cog_settings["botstats"]
+        streamer = cog_settings["streamer"]
+        _type = cog_settings["type"]
+        _status = cog_settings["status"]
+
+        url = f"https://www.twitch.tv/{streamer}"
+        prefix = await self.bot.get_valid_prefixes()
+
+        if _status == 0:
+            status = discord.Status.online
+        elif _status == 1:
+            status = discord.Status.idle
+        elif _status == 2:
+            status = discord.Status.dnd
+        elif _status == 3:
+            status = discord.Status.offline
+
+        if botstats:
+            me = self.bot.user
+            clean_prefix = pattern.sub(f"@{me.name}", prefix[0])
+            total_users = len(self.bot.users)
+            servers = str(len(self.bot.guilds))
+            botstatus = f"{clean_prefix}help | {total_users} users | {servers} servers"
+            if (current_game != str(botstatus)) or current_game is None:
+                if _type == 1:
+                    await self.bot.change_presence(activity=discord.Streaming(name=botstatus, url=url))
+                else:
+                    await self.bot.change_presence(activity=discord.Activity(name=botstatus, type=_type), status=status)
+        else:
+            if len(statuses) > 0:
+                new_status = self.random_status(guild, statuses)
+                if (current_game != new_status) or (current_game is None) or (len(statuses) == 1):
+                    if _type == 1:
+                        await self.bot.change_presence(activity=discord.Streaming(name=new_status, url=url))
+                    else:
+                        await self.bot.change_presence(
+                            activity=discord.Activity(name=new_status, type=_type), status=status
+                        )
+
+    def random_status(self, guild, statuses):
+        try:
+            current = str(guild.me.activity.name)
+        except AttributeError:
+            current = None
+        new_statuses = [s for s in statuses if s != current]
+        if len(new_statuses) > 1:
+            return rndchoice(new_statuses)
+        elif len(new_statuses) == 1:
+            return new_statuses[0]
+        return current

rss/__init__.py

@@ -0,0 +1,11 @@
+from redbot.core import commands
+
+from .rss import RSS
+
+__red_end_user_data_statement__ = "This cog does not persistently store data or metadata about users."
+
+
+async def setup(bot: commands.Bot):
+    n = RSS(bot)
+    bot.add_cog(n)
+    n.initialize()

rss/color.py

@@ -0,0 +1,131 @@
+from math import sqrt
+import discord
+import re
+import webcolors
+
+
+_DISCORD_COLOURS = {
+    discord.Color.teal().to_rgb(): 'teal',
+    discord.Color.dark_teal().to_rgb(): 'dark_teal',
+    discord.Color.green().to_rgb(): 'green',
+    discord.Color.dark_green().to_rgb(): 'dark_green',
+    discord.Color.blue().to_rgb(): 'blue',
+    discord.Color.dark_blue().to_rgb(): 'dark_blue',
+    discord.Color.purple().to_rgb(): 'purple',
+    discord.Color.dark_purple().to_rgb(): 'dark_purple',
+    discord.Color.magenta().to_rgb(): 'magenta',
+    discord.Color.dark_magenta().to_rgb(): 'dark_magenta',
+    discord.Color.gold().to_rgb(): 'gold',
+    discord.Color.dark_gold().to_rgb(): 'dark_gold',
+    discord.Color.orange().to_rgb(): 'orange',
+    discord.Color.dark_orange().to_rgb(): 'dark_orange',
+    discord.Color.red().to_rgb(): 'red',
+    discord.Color.dark_red().to_rgb(): 'dark_red',
+    discord.Color.lighter_grey().to_rgb(): 'lighter_grey',
+    discord.Color.light_grey().to_rgb(): 'light_grey',
+    discord.Color.dark_grey().to_rgb(): 'dark_grey',
+    discord.Color.darker_grey().to_rgb(): 'darker_grey',
+    discord.Color.blurple().to_rgb(): 'old_blurple',
+    discord.Color(0x4a90e2).to_rgb(): 'new_blurple',
+    discord.Color.greyple().to_rgb(): 'greyple',
+    discord.Color.dark_theme().to_rgb(): 'discord_dark_theme'
+}
+
+_RGB_NAME_MAP = {webcolors.hex_to_rgb(hexcode): name for hexcode, name in webcolors.css3_hex_to_names.items()}
+_RGB_NAME_MAP.update(_DISCORD_COLOURS)
+
+
+def _distance(point_a: tuple, point_b: tuple):
+    """
+    Euclidean distance between two points using rgb values as the metric space.
+    """
+    # rgb values
+    x1, y1, z1 = point_a
+    x2, y2, z2 = point_b
+
+    # distances
+    dx = x1 - x2
+    dy = y1 - y2
+    dz = z1 - z2
+
+    # final distance
+    return sqrt(dx**2 + dy**2 + dz**2)
+
+def _linear_nearest_neighbour(all_points: list, pivot: tuple):
+    """
+    Check distance against all points from the pivot and return the distance and nearest point.
+    """
+    best_dist = None
+    nearest = None
+    for point in all_points:
+        dist = _distance(point, pivot)
+        if best_dist is None or dist < best_dist:
+            best_dist = dist
+            nearest = point
+    return best_dist, nearest
+
+
+class Color:
+    """Helper for color handling."""
+
+    async def _color_converter(self, hex_code_or_color_word: str):
+        """
+        Used for user input on rss embed color
+        Input:    discord.Color name, CSS3 color name, 0xFFFFFF, #FFFFFF, FFFFFF
+        Output:   0xFFFFFF
+        """
+        # #FFFFFF and FFFFFF to 0xFFFFFF
+        hex_match = re.match(r"#?[a-f0-9]{6}", hex_code_or_color_word.lower())
+        if hex_match:
+            hex_code = f"0x{hex_code_or_color_word.lstrip('#')}"
+            return hex_code
+
+        # discord.Color checking
+        if hasattr(discord.Color, hex_code_or_color_word):
+            hex_code = str(getattr(discord.Color, hex_code_or_color_word)())
+            hex_code = hex_code.replace("#", "0x")
+            return hex_code
+
+        # CSS3 color name checking
+        try:
+            hex_code = webcolors.name_to_hex(hex_code_or_color_word, spec="css3")
+            hex_code = hex_code.replace("#", "0x")
+            return hex_code
+        except ValueError:
+            pass
+
+        return None
+
+    async def _hex_to_css3_name(self, hex_code: str):
+        """
+        Input:  0xFFFFFF
+        Output: CSS3 color name string closest match
+        """
+        hex_code = await self._hex_validator(hex_code)
+        rgb_tuple = await self._hex_to_rgb(hex_code)
+
+        positions = list(_RGB_NAME_MAP.keys())
+        dist, nearest = _linear_nearest_neighbour(positions, rgb_tuple)
+
+        return _RGB_NAME_MAP[nearest]
+
+    async def _hex_to_rgb(self, hex_code: str):
+        """
+        Input:  0xFFFFFF
+        Output: (255, 255, 255)
+        """
+        return webcolors.hex_to_rgb(hex_code)
+
+    async def _hex_validator(self, hex_code: str):
+        """
+        Input:  0xFFFFFF
+        Output: #FFFFFF or None
+        """
+        if hex_code[:2] == "0x":
+            hex_code = hex_code.replace("0x", "#")
+        try:
+            # just a check to make sure it's a real color hex code
+            hex_code = webcolors.normalize_hex(hex_code)
+        except ValueError:
+            hex_code = None
+        return hex_code

rss/info.json

@@ -0,0 +1,10 @@
+{
+    "author": ["aikaterna"],
+    "install_msg": "Thanks for installing.",
+    "short": "Read RSS feeds.",
+    "description": "Read RSS feeds.",
+    "tags": ["rss"],
+    "permissions": ["embed_links"],
+    "requirements": ["bs4", "feedparser>=6.0.0", "webcolors==1.3"],
+    "end_user_data_statement": "This cog does not persistently store data or metadata about users."
+}

rss/quiet_template.py

@@ -0,0 +1,31 @@
+from collections import ChainMap
+from string import Template
+
+
+class QuietTemplate(Template):
+    """
+    A subclass of string.Template that is less verbose on a missing key
+    https://github.com/python/cpython/blob/919f0bc8c904d3aa13eedb2dd1fe9c6b0555a591/Lib/string.py#L123
+    """
+
+    def quiet_safe_substitute(self, mapping={}, /, **kws):
+        if mapping is {}:
+            mapping = kws
+        elif kws:
+            mapping = ChainMap(kws, mapping)
+        # Helper function for .sub()
+        def convert(mo):
+            named = mo.group('named') or mo.group('braced')
+            if named is not None:
+                try:
+                    return str(mapping[named])
+                except KeyError:
+                    # return None instead of the tag name so that
+                    # invalid tags are not present in the feed output
+                    return None
+            if mo.group('escaped') is not None:
+                return self.delimiter
+            if mo.group('invalid') is not None:
+                return mo.group()
+            raise ValueError('Unrecognized named group in pattern', self.pattern)
+        return self.pattern.sub(convert, self.template)

rss/rss_feed.py

@@ -0,0 +1,50 @@
+class RssFeed():
+    """RSS feed object"""
+
+    def __init__(self, **kwargs):
+        super().__init__()
+        self.name: str = kwargs.get("name", None)
+        self.last_title: str = kwargs.get("last_title", None)
+        self.last_link: str = kwargs.get("last_link", None)
+        self.last_time: str = kwargs.get("last_time", None)
+        self.template: str = kwargs.get("template", None)
+        self.url: str = kwargs.get("url", None)
+        self.template_tags: List[str] = kwargs.get("template_tags", [])
+        self.is_special: List[str] = kwargs.get("is_special", [])
+        self.embed: bool = kwargs.get("embed", True)
+        self.embed_color: str = kwargs.get("embed_color", None)
+        self.embed_image: str = kwargs.get("embed_image", None)
+        self.embed_thumbnail: str = kwargs.get("embed_thumbnail", None)
+
+    def to_json(self) -> dict:
+        return {
+            "name": self.name,
+            "last_title": self.last_title,
+            "last_link": self.last_link,
+            "last_time": self.last_time,
+            "template": self.template,
+            "url": self.url,
+            "template_tags": self.template_tags,
+            "is_special": self.is_special,
+            "embed": self.embed,
+            "embed_color": self.embed_color,
+            "embed_image": self.embed_image,
+            "embed_thumbnail": self.embed_thumbnail,
+        }
+
+    @classmethod
+    def from_json(cls, data: dict):
+        return cls(
+            name=data["name"] if data["name"] else None,
+            last_title=data["last_title"] if data["last_title"] else None,
+            last_link=data["last_link"] if data["last_link"] else None,
+            last_time=data["last_time"] if data["last_time"] else None,
+            template=data["template"] if data["template"] else None,
+            url=data["url"] if data["url"] else None,
+            template_tags=data["template_tags"] if data["template_tags"] else [],
+            is_special=data["is_special"] if data["is_special"] else [],
+            embed=data["embed"] if data["embed"] else True,
+            embed_color=data["embed_color"] if data["embed_color"] else None,
+            embed_image=data["embed_image"] if data["embed_image"] else None,
+            embed_thumbnail=data["embed_thumbnail"] if data["embed_thumbnail"] else None,
+        )

rss/tag_type.py

@@ -0,0 +1,13 @@
+from enum import Enum
+
+
+INTERNAL_TAGS = ["is_special", "template_tags", "embed", "embed_color", "embed_image", "embed_thumbnail"]
+
+VALID_IMAGES = ["png", "webp", "gif", "jpeg", "jpg"]
+
+
+class TagType(Enum):
+    PLAINTEXT = 1
+    HTML = 2
+    DICT = 3
+    LIST = 4

seen/__init__.py

@@ -0,0 +1,12 @@
+from .seen import Seen
+
+__red_end_user_data_statement__ = (
+    "This cog does not persistently store end user data. "
+    "This cog does store discord IDs and last seen timestamp as needed for operation. "
+)
+
+
+async def setup(bot):
+    cog = Seen(bot)
+    await cog.initialize()
+    bot.add_cog(cog)