Template v2.7

* Added a check for `commands.MissingRequiredArgument` in the error handler
* Added a disclaimer section in the [README](README.md) file
* Added the latency of the bot in the `ping` command
* Created the [TODO list](TODO.md) file
* Fixed some error embeds having success (green) colors
* Removed an unnecessary `self.bot.logout()` statement
* Removed the `dick` command, as I want to keep this template safe for work
* Renamed the names of the arguments in some commands
* The bot now **tries** to send an embed in the private message of the command author for the `invite` and `server` commands, if this was not successful it will be sent in the channel

Author: kkrypt0nn

README.md

@@ -38,6 +38,14 @@ If you need some help for something, do not hesitate to join my discord server [
 
 All the updates of the template are available [here](UPDATES.md).
 
+## Disclaimer
+
+**Nothing** is being saved during runtime in the configuration file, please take a look at the [TODO file](TODO.md) to
+know if this has been implemented.
+
+Please do not open issues or pull requests about things that are written in the [TODO file](TODO.md), they are **
+already** under work for the version 3.0 of the template.
+
 ## How to download it
 
 This repository is now a template, on the top left you can simply click on "**Use this template**" to create a GitHub
@@ -101,10 +109,6 @@ If you have just installed python today, then you just need to use the following
 python bot.py
 ```
 
-## Built With
-
-* [Python 3.8](https://www.python.org/)
-
 ## Issues or Questions
 
 If you have any issues or questions of how to code a specific command, you can:
@@ -119,9 +123,9 @@ Me or other people will take their time to answer and help you.
 We use [SemVer](http://semver.org) for versioning. For the versions available, see
 the [tags on this repository](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/tags).
 
-## Bots who used this template
+## Built With
 
-*DM Krypton#7331 to get yourself in this list*
+* [Python 3.8](https://www.python.org/)
 
 ## License
 

TODO.md

@@ -0,0 +1,10 @@
+# TODO List
+
+* [ ] Add a *"hackban"* command (ban a user by ID from a guild without him being in it)
+* [ ] Add a basic slur word filter
+* [ ] Add a code of conduct for the repository
+* [ ] Add a lock command that will let administrators temporary lock a channel, useful in case of a raid
+* [ ] Add an archive command that lets administrators archive a text channel in a text file
+* [ ] Add an issue and pull request template for the repository
+* [ ] Be able to save data to JSON (blacklist, owners, etc.)
+* [ ] Move config to JSON

UPDATES.md

@@ -2,6 +2,19 @@
 
 Here is the list of all the updates that I made on this template.
 
+### Version 2.7
+
+* Added a check for `commands.MissingRequiredArgument` in the error handler
+* Added a disclaimer section in the [README](README.md) file
+* Added the latency of the bot in the `ping` command
+* Created the [TODO list](TODO.md) file
+* Fixed some error embeds having success (green) colors
+* Removed an unnecessary `self.bot.logout()` statement
+* Removed the `dick` command, as I want to keep this template safe for work
+* Renamed the names of the arguments in some commands
+* The bot now **tries** to send an embed in the private message of the command author for the `invite` and `server` commands, if this was not successful it will be sent in the channel
+
+
 ### Version 2.6
 
 * Added new `dailyfact` command that gives a random fact every day, using cool down

bot.py

@@ -3,7 +3,7 @@
 Description:
 This is a template to create your own discord bot in python.
 
-Version: 2.6
+Version: 2.7
 """
 
 import os
@@ -134,6 +134,14 @@ async def on_command_error(context, error):
             color=config["error"]
         )
         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=config["error"]
+        )
+        await context.send(embed=embed)
     raise error
 
 

cogs/fun.py

@@ -1,3 +1,11 @@
+""""
+Copyright © Krypton 2021 - https://github.com/kkrypt0nn
+Description:
+This is a template to create your own discord bot in python.
+
+Version: 2.7
+"""
+
 import asyncio
 import os
 import random
@@ -55,18 +63,6 @@ async def dailyfact(self, context):
                     # We need to reset the cool down since the user didn't got his daily fact.
                     self.dailyfact.reset_cooldown(context)
 
-    @commands.command(name="dick")
-    async def dick(self, context, member: discord.Member = None):
-        """
-        Get the dick's length of a user or yourself.
-        """
-        if not member:
-            member = context.author
-        length = random.randrange(15)
-        embed = discord.Embed(description=f"8{'=' * length}D", color=config["main_color"])
-        embed.set_author(name=f"{member.display_name}'s Dick", icon_url=member.avatar_url)
-        await context.send(embed=embed)
-
     @commands.command(name="rps")
     async def rock_paper_scissors(self, context):
         choices = {

cogs/general.py

@@ -1,3 +1,11 @@
+""""
+Copyright © Krypton 2021 - https://github.com/kkrypt0nn
+Description:
+This is a template to create your own discord bot in python.
+
+Version: 2.7
+"""
+
 import json
 import os
 import platform
@@ -108,44 +116,51 @@ async def ping(self, context):
         Check if the bot is alive.
         """
         embed = discord.Embed(
+            title="🏓 Pong!",
+            description=f"The bot latency is {round(self.bot.latency * 1000)}ms.",
             color=config["success"]
         )
-        embed.add_field(
-            name="Pong!",
-            value=":ping_pong:",
-            inline=True
-        )
-        embed.set_footer(
-            text=f"Pong request by {context.message.author}"
-        )
         await context.send(embed=embed)
 
     @commands.command(name="invite")
     async def invite(self, context):
         """
         Get the invite link of the bot to be able to invite it.
         """
-        await context.send("I sent you a private message!")
-        await context.author.send(
-            f"Invite me by clicking here: https://discordapp.com/oauth2/authorize?&client_id={config.APPLICATION_ID}&scope=bot&permissions=8")
+        embed = discord.Embed(
+            description=f"Invite me by clicking [here](https://discordapp.com/oauth2/authorize?&client_id={config['application_id']}&scope=bot&permissions=470150263).",
+            color=config['main_color']
+        )
+        try:
+            # To know what permissions to give to your bot, please see here: https://discordapi.com/permissions.html and remember to not give Administrator permissions.
+            await context.author.send(embed=embed)
+            await context.send("I sent you a private message!")
+        except discord.Forbidden:
+            await context.send(embed=embed)
 
-    @commands.command(name="server")
+    @commands.command(name="server", aliases=["support", "supportserver"])
     async def server(self, context):
         """
         Get the invite link of the discord server of the bot for some support.
         """
-        await context.send("I sent you a private message!")
-        await context.author.send("Join my discord server by clicking here: https://discord.gg/HzJ3Gfr")
+        embed = discord.Embed(
+            description=f"Join the support server for the bot by clicking [here](https://discord.gg/HzJ3Gfr).",
+            color=config['main_color']
+        )
+        try:
+            await context.author.send(embed=embed)
+            await context.send("I sent you a private message!")
+        except discord.Forbidden:
+            await context.send(embed=embed)
 
     @commands.command(name="poll")
-    async def poll(self, context, *args):
+    async def poll(self, context, *, title):
         """
         Create a poll where members can vote.
         """
-        poll_title = " ".join(args)
         embed = discord.Embed(
             title="A new poll has been created!",
-            description=f"{poll_title}",
+            description=f"{title}",
             color=config["success"]
         )
         embed.set_footer(
@@ -157,7 +172,7 @@ async def poll(self, context, *args):
         await embed_message.add_reaction("🤷")
 
     @commands.command(name="8ball")
-    async def eight_ball(self, context, *args):
+    async def eight_ball(self, context, *, question):
         """
         Ask any question to the bot.
         """
@@ -172,7 +187,7 @@ async def eight_ball(self, context, *args):
             color=config["success"]
         )
         embed.set_footer(
-            text=f"Question asked by: {context.message.author}"
+            text=f"The question was: {question}"
         )
         await context.send(embed=embed)
 

cogs/help.py

@@ -1,3 +1,11 @@
+""""
+Copyright © Krypton 2021 - https://github.com/kkrypt0nn
+Description:
+This is a template to create your own discord bot in python.
+
+Version: 2.7
+"""
+
 import os
 import sys
 

cogs/moderation.py

@@ -1,3 +1,11 @@
+""""
+Copyright © Krypton 2021 - https://github.com/kkrypt0nn
+Description:
+This is a template to create your own discord bot in python.
+
+Version: 2.7
+"""
+
 import os
 import sys
 
@@ -18,7 +26,7 @@ def __init__(self, bot):
 
     @commands.command(name='kick', pass_context=True)
     @commands.has_permissions(kick_members=True)
-    async def kick(self, context, member: discord.Member, *args):
+    async def kick(self, context, member: discord.Member, *, reason="Not specified"):
         """
         Kick a user out of the server.
         """
@@ -31,7 +39,6 @@ async def kick(self, context, member: discord.Member, *args):
             await context.send(embed=embed)
         else:
             try:
-                reason = " ".join(args)
                 await member.kick(reason=reason)
                 embed = discord.Embed(
                     title="User Kicked!",
@@ -52,38 +59,36 @@ async def kick(self, context, member: discord.Member, *args):
             except:
                 embed = discord.Embed(
                     title="Error!",
-                    description="An error occurred while trying to kick the user.",
-                    color=config["success"]
+                    description="An error occurred while trying to kick the user. Make sure my role is above the role of the user you want to kick.",
+                    color=config["error"]
                 )
                 await context.message.channel.send(embed=embed)
 
     @commands.command(name="nick")
     @commands.has_permissions(manage_nicknames=True)
-    async def nick(self, context, member: discord.Member, *, name: str):
+    async def nick(self, context, member: discord.Member, *, nickname=None):
         """
         Change the nickname of a user on a server.
         """
         try:
-            if name.lower() == "!reset":
-                name = None
-            await member.change_nickname(name)
+            await member.edit(nick=nickname)
             embed = discord.Embed(
                 title="Changed Nickname!",
-                description=f"**{member}'s** new nickname is **{name}**!",
+                description=f"**{member}'s** new nickname is **{nickname}**!",
                 color=config["success"]
             )
             await context.send(embed=embed)
         except:
             embed = discord.Embed(
                 title="Error!",
-                description="An error occurred while trying to change the nickname of the user.",
-                color=config["success"]
+                description="An error occurred while trying to change the nickname of the user. Make sure my role is above the role of the user you want to change the nickname.",
+                color=config["error"]
             )
             await context.message.channel.send(embed=embed)
 
     @commands.command(name="ban")
     @commands.has_permissions(ban_members=True)
-    async def ban(self, context, member: discord.Member, *args):
+    async def ban(self, context, member: discord.Member, *, reason="Not specified"):
         """
         Bans a user from the server.
         """
@@ -92,11 +97,10 @@ async def ban(self, context, member: discord.Member, *args):
                 embed = discord.Embed(
                     title="Error!",
                     description="User has Admin permissions.",
-                    color=config["success"]
+                    color=config["error"]
                 )
                 await context.send(embed=embed)
             else:
-                reason = " ".join(args)
                 await member.ban(reason=reason)
                 embed = discord.Embed(
                     title="User Banned!",
@@ -112,18 +116,17 @@ async def ban(self, context, member: discord.Member, *args):
         except:
             embed = discord.Embed(
                 title="Error!",
-                description="An error occurred while trying to ban the user.",
-                color=config["success"]
+                description="An error occurred while trying to ban the user. Make sure my role is above the role of the user you want to ban.",
+                color=config["error"]
             )
             await context.send(embed=embed)
 
     @commands.command(name="warn")
     @commands.has_permissions(manage_messages=True)
-    async def warn(self, context, member: discord.Member, *args):
+    async def warn(self, context, member: discord.Member, *, reason="Not specified"):
         """
         Warns a user in his private messages.
         """
-        reason = " ".join(args)
         embed = discord.Embed(
             title="User Warned!",
             description=f"**{member}** was warned by **{context.message.author}**!",
@@ -141,29 +144,29 @@ async def warn(self, context, member: discord.Member, *args):
 
     @commands.command(name="purge")
     @commands.has_permissions(manage_messages=True, manage_channels=True)
-    async def purge(self, context, number):
+    async def purge(self, context, amount):
         """
         Delete a number of messages.
         """
         try:
-            number = int(number)
+            amount = int(amount)
         except:
             embed = discord.Embed(
                 title="Error!",
-                description=f"`{number}` is not a valid number.",
+                description=f"`{amount}` is not a valid number.",
                 color=config["error"]
             )
             await context.send(embed=embed)
             return
-        if number < 1:
+        if amount < 1:
             embed = discord.Embed(
                 title="Error!",
-                description=f"`{number}` is not a valid number.",
+                description=f"`{amount}` is not a valid number.",
                 color=config["error"]
             )
             await context.send(embed=embed)
             return
-        purged_messages = await context.message.channel.purge(limit=number)
+        purged_messages = await context.message.channel.purge(limit=amount)
         embed = discord.Embed(
             title="Chat Cleared!",
             description=f"**{context.message.author}** cleared **{len(purged_messages)}** messages!",