Template v3.0

**Now using slash commands**

Author: kkrypt0nn

README.md

@@ -39,6 +39,17 @@ All the updates of the template are available [here](UPDATES.md).
 
 ## Disclaimer
 
+Slash commands can take **some hours** to get registered on guilds, so if you want to test a command you should use
+the `guild_ids` parameter in the command decorator so that it gets registered instantly. Example:
+
+```py
+@cog_ext.cog_slash(
+    name="command",
+    description="Command description",
+    guild_ids=[GUILD_ID1, GUILD_ID2] # These should be testing guild(s) ID, as always: an integer.
+)
+```
+
 When using the template you confirm that you have read the [license](LICENSE.md) and comprehend that I can take down
 your repository if you do not meet these requirements.
 

UPDATES.md

@@ -2,6 +2,10 @@
 
 Here is the list of all the updates that I made on this template.
 
+### Version 3.0
+
+**Now using slash commands**
+
 ### Version 2.8
 
 * Blacklisted users are now **saved** in the file

bot.py

@@ -3,7 +3,7 @@
 Description:
 This is a template to create your own discord bot in python.
 
-Version: 2.8
+Version: 3.0
 """
 
 import json
@@ -13,8 +13,9 @@
 import sys
 
 import discord
-from discord.ext import commands, tasks
+from discord.ext import tasks
 from discord.ext.commands import Bot
+from discord_slash import SlashCommand, SlashContext
 
 if not os.path.isfile("config.json"):
     sys.exit("'config.json' not found! Please add it and try again.")
@@ -55,6 +56,7 @@
 intents = discord.Intents.default()
 
 bot = Bot(command_prefix=config["bot_prefix"], intents=intents)
+slash = SlashCommand(bot, sync_commands=True)
 
 
 # The code in this even is executed when the bot is ready
@@ -96,53 +98,22 @@ async def on_message(message):
     # Ignores if a command is being executed by a bot or by the bot itself
     if message.author == bot.user or message.author.bot:
         return
-    # Ignores if a command is being executed by a blacklisted user
-    with open("blacklist.json") as file:
-        blacklist = json.load(file)
-    if message.author.id in blacklist["ids"]:
-        return
     await bot.process_commands(message)
 
 
 # The code in this event is executed every time a command has been *successfully* executed
 @bot.event
-async def on_command_completion(ctx):
-    fullCommandName = ctx.command.qualified_name
+async def on_slash_command(ctx: SlashContext):
+    fullCommandName = ctx.name
     split = fullCommandName.split(" ")
     executedCommand = str(split[0])
     print(
-        f"Executed {executedCommand} command in {ctx.guild.name} (ID: {ctx.message.guild.id}) by {ctx.message.author} (ID: {ctx.message.author.id})")
+        f"Executed {executedCommand} command in {ctx.guild.name} (ID: {ctx.guild.id}) by {ctx.author} (ID: {ctx.author.id})")
 
 
 # The code in this event is executed every time a valid commands catches an error
 @bot.event
 async def on_command_error(context, error):
-    if isinstance(error, commands.CommandOnCooldown):
-        minutes, seconds = divmod(error.retry_after, 60)
-        hours, minutes = divmod(minutes, 60)
-        hours = hours % 24
-        embed = discord.Embed(
-            title="Hey, please slow down!",
-            description=f"You can use this command again in {f'{round(hours)} hours' if round(hours) > 0 else ''} {f'{round(minutes)} minutes' if round(minutes) > 0 else ''} {f'{round(seconds)} seconds' if round(seconds) > 0 else ''}.",
-            color=0xE02B2B
-        )
-        await context.send(embed=embed)
-    elif isinstance(error, commands.MissingPermissions):
-        embed = discord.Embed(
-            title="Error!",
-            description="You are missing the permission `" + ", ".join(
-                error.missing_perms) + "` to execute this command!",
-            color=0xE02B2B
-        )
-        await context.send(embed=embed)
-    elif isinstance(error, commands.MissingRequiredArgument):
-        embed = discord.Embed(
-            title="Error!",
-            description=str(error).capitalize(),
-            # We need to capitalize because the command arguments have no capital letter in the code.
-            color=0xE02B2B
-        )
-        await context.send(embed=embed)
     raise error
 
 

cogs/fun.py

@@ -3,19 +3,17 @@
 Description:
 This is a template to create your own discord bot in python.
 
-Version: 2.7
+Version: 3.0
 """
 
-import asyncio
 import json
 import os
-import random
 import sys
 
 import aiohttp
 import discord
 from discord.ext import commands
-from discord.ext.commands import BucketType
+from discord_slash import cog_ext, SlashContext
 
 if not os.path.isfile("config.json"):
     sys.exit("'config.json' not found! Please add it and try again.")
@@ -28,24 +26,21 @@ class Fun(commands.Cog, name="fun"):
     def __init__(self, bot):
         self.bot = bot
 
-    """
-    Why 1 and 86400?
-    -> Because the user should be able to use the command *once* every *86400* seconds
-    
-    Why BucketType.user?
-    -> Because the cool down only affects the current user, if you want other types of cool downs, here are they:
-    - BucketType.default for a global basis.
-    - BucketType.user for a per-user basis.
-    - BucketType.server for a per-server basis.
-    - BucketType.channel for a per-channel basis.
-    """
-
-    @commands.command(name="dailyfact")
-    @commands.cooldown(1, 86400, BucketType.user)
-    async def dailyfact(self, context):
+    @cog_ext.cog_slash(
+        name="randomfact",
+        description="Get a random fact."
+    )
+    async def randomfact(self, context: SlashContext):
         """
-        Get a daily fact, command can only be ran once every day per user.
+        Get a random fact.
         """
+
+        # This is, for now, only temporary
+        with open("blacklist.json") as file:
+            blacklist = json.load(file)
+        if context.author.id in blacklist["ids"]:
+            return
+
         # This will prevent your bot from stopping everything when doing a web request - see: https://discordpy.readthedocs.io/en/stable/faq.html#how-do-i-make-a-web-request
         async with aiohttp.ClientSession() as session:
             async with session.get("https://uselessfacts.jsph.pl/random.json?language=en") as request:
@@ -60,65 +55,6 @@ async def dailyfact(self, context):
                         color=0xE02B2B
                     )
                     await context.send(embed=embed)
-                    # We need to reset the cool down since the user didn't got his daily fact.
-                    self.dailyfact.reset_cooldown(context)
-
-    @commands.command(name="rps")
-    async def rock_paper_scissors(self, context):
-        choices = {
-            0: "rock",
-            1: "paper",
-            2: "scissors"
-        }
-        reactions = {
-            "🪨": 0,
-            "🧻": 1,
-            "✂": 2
-        }
-        embed = discord.Embed(title="Please choose", color=0xF59E42)
-        embed.set_author(name=context.author.display_name, icon_url=context.author.avatar_url)
-        choose_message = await context.send(embed=embed)
-        for emoji in reactions:
-            await choose_message.add_reaction(emoji)
-
-        def check(reaction, user):
-            return user == context.message.author and str(reaction) in reactions
-
-        try:
-            reaction, user = await self.bot.wait_for("reaction_add", timeout=10, check=check)
-
-            user_choice_emote = reaction.emoji
-            user_choice_index = reactions[user_choice_emote]
-
-            bot_choice_emote = random.choice(list(reactions.keys()))
-            bot_choice_index = reactions[bot_choice_emote]
-
-            result_embed = discord.Embed(color=0x42F56C)
-            result_embed.set_author(name=context.author.display_name, icon_url=context.author.avatar_url)
-            await choose_message.clear_reactions()
-
-            if user_choice_index == bot_choice_index:
-                result_embed.description = f"**That's a draw!**\nYou've chosen {user_choice_emote} and I've chosen {bot_choice_emote}."
-                result_embed.colour = 0xF59E42
-            elif user_choice_index == 0 and bot_choice_index == 2:
-                result_embed.description = f"**You won!**\nYou've chosen {user_choice_emote} and I've chosen {bot_choice_emote}."
-                result_embed.colour = 0x42F56C
-            elif user_choice_index == 1 and bot_choice_index == 0:
-                result_embed.description = f"**You won!**\nYou've chosen {user_choice_emote} and I've chosen {bot_choice_emote}."
-                result_embed.colour = 0x42F56C
-            elif user_choice_index == 2 and bot_choice_index == 1:
-                result_embed.description = f"**You won!**\nYou've chosen {user_choice_emote} and I've chosen {bot_choice_emote}."
-                result_embed.colour = 0x42F56C
-            else:
-                result_embed.description = f"**I won!**\nYou've chosen {user_choice_emote} and I've chosen {bot_choice_emote}."
-                result_embed.colour = 0xE02B2B
-                await choose_message.add_reaction("🇱")
-            await choose_message.edit(embed=result_embed)
-        except asyncio.exceptions.TimeoutError:
-            await choose_message.clear_reactions()
-            timeout_embed = discord.Embed(title="Too late", color=0xE02B2B)
-            timeout_embed.set_author(name=context.author.display_name, icon_url=context.author.avatar_url)
-            await choose_message.edit(embed=timeout_embed)
 
 
 def setup(bot):