new moderator commands update 1.2.0

pydvpl_bot.py

@@ -1,6 +1,7 @@
 import os
 import time
 import json 
+import asyncio
 import psutil
 import discord
 from dotenv import load_dotenv
@@ -21,7 +22,7 @@ load_dotenv()
 # DEFINES ------------------------------------------------------ START
 
 
-BOT_VERSION = '1.1.1'
+BOT_VERSION = '1.2.0'
 
 AUTHORIZED_USER_ID = os.getenv('AUTHORIZED_ID')
 
@@ -299,6 +300,7 @@ async def help(ctx):
     embed.add_field(name="PyDVPL Prefix:", value="`/` - Discord's slash command prefix.\n`>>` - PyDVPL default prefix.")
     embed.add_field(name="Dvpl Commands:", value="`compress` - Compresses files.\n`decompress` - Decompresses files.", inline=False)
     embed.add_field(name="User Utility Commands:", value="`ping` - Checks the bot's latency.\n`invite` - Get the bot's invite link.\n`uptime` - Displays the bot's uptime.", inline=False)
+    embed.add_field(name="Moderator Commands:", value="`kick` - Kick a member from the server.\n`ban` - Ban a member from the server.\n`timeout` - Timeout a member for a specified duration.", inline=False)
     embed.add_field(name="Admin Utility Commands:", value="`stats` - Displays bot statistics.\n`list` - Lists server members.\n`say` - Make the bot say something.\n`announce` - Announces a message to a channel.\n`activity` - Sets bot activity status.\n`online` - Sets bot status to online.\n`dnd` - Sets bot status to Do Not Disturb.\n`offline` - Sets bot status to offline.\n`clean` - Cleans up bot's messages.", inline=False)
     embed.add_field(name="Feedback Commands:", value="`feedback` - Sends feedback to bot developers. (usage: >>feedback issues/requests <message>)", inline=False)
     
@@ -399,12 +401,17 @@ async def invite(ctx):
     permissions = discord.Permissions(
         read_messages=True,
         send_messages=True,
-        embed_links=True,  # Permission for embedded activities
+        embed_links=True,
         attach_files=True,
         read_message_history=True,
         mention_everyone=True,
         add_reactions=True,
         manage_guild=True,
+        ban_members=True,
+        kick_members=True,
+        moderate_members=True,
+        use_application_commands=True,
+        manage_roles=True
     )
 
     client_id = bot.user.id
@@ -504,6 +511,7 @@ async def version(ctx):
 
 @bot.hybrid_command(help="Cleans files in specific directories")
 async def clean(ctx, clean_mode):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -526,6 +534,7 @@ async def clean(ctx, clean_mode):
 
 @bot.hybrid_command(help="Set bot's presence to online")
 async def online(ctx):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -540,6 +549,7 @@ async def online(ctx):
 
 @bot.hybrid_command(help="Set bot's presence to Do Not Disturb")
 async def dnd(ctx):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -554,6 +564,7 @@ async def dnd(ctx):
 
 @bot.hybrid_command(help="Set bot's presence to offline")
 async def offline(ctx):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -568,6 +579,7 @@ async def offline(ctx):
 
 @bot.hybrid_command(help="Set bot's activity")
 async def activity(ctx, activity_type, *, activity_text=None):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -599,7 +611,7 @@ async def activity(ctx, activity_type, *, activity_text=None):
 
 @bot.hybrid_command(help="Send messages to specific channels or users")
 async def say(ctx, destination_type, *, id, message):
-    
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         return
@@ -675,12 +687,13 @@ async def say(ctx, destination_type, *, id, message):
 
 @bot.hybrid_command(help="Send announcements to all servers")
 async def announce(ctx, *, message):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
         return
 
-    embed = discord.Embed(title="Announcement", description=message, color=discord.Color.yellow())
+    embed = discord.Embed(title="Announcement!", description=message, color=discord.Color.yellow())
 
     for server in bot.guilds:
         # First, check for an "important-announcements" channel
@@ -717,7 +730,7 @@ async def announce(ctx, *, message):
 
 @bot.hybrid_command(help="Show statistics about bot's health and connection.")
 async def stats(ctx):
-
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -752,9 +765,12 @@ async def stats(ctx):
     await ctx.send(stats_message)
     
 
+# FUNCTION ------------------------------------------------------ SPLIT
+
 
 @bot.hybrid_command(help="List issues, requests, or servers")
 async def list(ctx, list_type):
+    # Check if the author is authorized to use this command
     if str(ctx.author.id) != AUTHORIZED_USER_ID:
         await ctx.send("You are not authorized to use this command.")
         
@@ -772,6 +788,143 @@ async def list(ctx, list_type):
         await ctx.send("Invalid list type. Please choose 'servers', 'issues', or 'requests'.")
 
 
+# FUNCTION ------------------------------------------------------ SPLIT
+        
+
+@bot.hybrid_command(help="Kick a member from the server.")
+async def kick(ctx, member: discord.Member, *, reason=None):
+    # Check if the author is owner of the guild to use this command
+    if ctx.author.guild_permissions.kick_members or ctx.author == ctx.guild.owner:
+    
+        if ctx.author.top_role > member.top_role:
+
+            # Send a DM to the kicked member
+            dm_message = f"You have been kicked from the server `{ctx.guild.name}`"
+            if reason:
+                dm_message += f" for the following reason: `{reason}`"
+            try:
+                await member.send(dm_message)
+            except discord.Forbidden:
+                await ctx.send(f"Failed to send DM to `{member}` for kick.")
+            
+            # Kick the member from the server
+            try:
+                await member.kick(reason=reason)
+                await ctx.send(f"`{member}` has been kicked from the server. Reason: `{reason}`")
+            except discord.Forbidden:
+                await ctx.send("I don't have permission to kick this member.")
+            
+        else:
+            await ctx.send("You do not have permission to kick this member.")
+    
+    else:
+        await ctx.send("You do not have permission to use this command.")
+
+
+# FUNCTION ------------------------------------------------------ SPLIT
+
+
+@bot.hybrid_command(help="Ban a member from the server.")
+async def ban(ctx, member: discord.Member, *, reason=None):
+    # Check if the author is owner of the guild to use this command
+    if ctx.author.guild_permissions.ban_members or ctx.author == ctx.guild.owner:
+    
+        if ctx.author.top_role > member.top_role:
+
+            # Send a DM to the banned member
+            dm_message = f"You have been banned from the server `{ctx.guild.name}`"
+            if reason:
+                dm_message += f" for the following reason: `{reason}`"
+            try:
+                await member.send(dm_message)
+            except discord.Forbidden:
+                await ctx.send(f"Failed to send DM to `{member}` for ban.")
+
+            # Ban the member from the server
+            try:
+                await member.ban(reason=reason)
+                await ctx.send(f"`{member}` has been banned from the server. Reason: `{reason}`")
+            except discord.Forbidden:
+                await ctx.send("I don't have permission to ban this member.")
+            
+        else:
+            await ctx.send("You do not have permission to ban this member.")
+    
+    else:
+        await ctx.send("You do not have permission to use this command.")
+
+
+# FUNCTION ------------------------------------------------------ SPLIT
+
+
+
+@bot.hybrid_command(help="Timeout a member for a specified duration.")
+async def timeout(ctx, member: discord.Member, duration: int, *, reason=None):
+
+    # Check if the author is owner of the guild to use this command
+    if ctx.author.guild_permissions.manage_roles or ctx.author == ctx.guild.owner:
+    
+        # Check if the bot has permission to manage roles
+        if not ctx.guild.me.guild_permissions.manage_roles:
+            await ctx.send("I don't have permission to manage roles.")
+            return
+        
+        # Check if the author has a higher role than the member being timed out
+        if ctx.author.top_role <= member.top_role:
+            await ctx.send("You do not have permission to timeout this member.")
+            return
+        
+        try:
+            # Duration in seconds
+            timeout_duration = duration
+            
+            # Timeout the member by removing all roles
+            await member.edit(roles=[], reason=reason)
+
+            await ctx.send(f"`{member}` has been timed out for `{duration} seconds`. Reason: `{reason}`")
+            
+            # Construct the message to be sent as a DM
+            dm_message_init = f"You have been timed out in the server `{ctx.guild.name}` for `{duration} seconds`"
+            if reason:
+                dm_message_init += f" for the following reason: `{reason}`"
+            
+            # Send a DM to the timed-out member
+            try:
+                await member.send(dm_message_init)
+            except discord.Forbidden:
+                # If unable to send DM, log the error and continue
+               await ctx.send(f"Failed to send DM to `{member}` for timeout.")
+            
+        except Exception as e:
+            await ctx.send(f"An error occurred: {e}")
+            return  # Stop execution if there's an error
+            
+        # Wait for the duration of the timeout
+        await asyncio.sleep(timeout_duration)
+        
+        # Restore the member's roles after the timeout
+        try:
+            await member.edit(roles=member.roles, reason=reason)
+        except Exception as e:
+            print(f"An error occurred while restoring roles to `{member}`: {e}")
+            return  # Stop execution if there's an error
+            
+        dm_message_exit = f"Your previous timeout in the server `{ctx.guild.name}` for `{duration} seconds`"
+        if reason:
+            dm_message_exit += f" for the following reason: `{reason}` has been expired!"
+        
+        try:
+            await member.send(dm_message_exit)
+        except discord.Forbidden:
+            # If unable to send DM, log the error and continue
+            await ctx.send(f"Failed to send DM to `{member}` to notify timeout expiration.")
+    
+    else:
+        await ctx.send("You do not have permission to use this command.")
+
+
+
+
 # UTILITY ADMIN_CMD ------------------------------------------------------ END