import discord from discord.ext import commands import datetime import io class Utility(commands.Cog): def __init__(self, bot): self.bot = bot @commands.command() async def serverinfo(self, ctx): guild = ctx.guild embed = discord.Embed( title=f"📊 {guild.name}", color=discord.Color.blue(), timestamp=datetime.datetime.utcnow() ) if guild.icon: embed.set_thumbnail(url=guild.icon.url) embed.add_field(name="👑 Owner", value=guild.owner.mention, inline=True) embed.add_field(name="🆔 Server ID", value=guild.id, inline=True) embed.add_field(name="📅 Created", value=guild.created_at.strftime("%d/%m/%Y"), inline=True) embed.add_field(name="👥 Members", value=guild.member_count, inline=True) embed.add_field(name="💬 Channels", value=len(guild.channels), inline=True) embed.add_field(name="📁 Categories", value=len(guild.categories), inline=True) embed.add_field(name="😀 Emojis", value=len(guild.emojis), inline=True) embed.add_field(name="🎭 Roles", value=len(guild.roles), inline=True) embed.add_field(name="🚀 Boost Level", value=guild.premium_tier, inline=True) embed.set_footer(text=f"Requested by {ctx.author}", icon_url=ctx.author.display_avatar.url) await ctx.send(embed=embed) @commands.command() async def userinfo(self, ctx, member: discord.Member = None): member = member or ctx.author embed = discord.Embed( title=f"👤 {member}", color=member.color, timestamp=datetime.datetime.utcnow() ) embed.set_thumbnail(url=member.display_avatar.url) embed.add_field(name="🆔 User ID", value=member.id, inline=True) embed.add_field(name="📛 Nickname", value=member.nick or "None", inline=True) embed.add_field(name="🤖 Bot", value="Yes" if member.bot else "No", inline=True) embed.add_field(name="📅 Account Created", value=member.created_at.strftime("%d/%m/%Y"), inline=True) embed.add_field(name="📥 Joined Server", value=member.joined_at.strftime("%d/%m/%Y"), inline=True) embed.add_field(name="🎭 Roles", value=len(member.roles) - 1, inline=True) roles = [role.mention for role in member.roles if role.name != "@everyone"] if roles: embed.add_field(name="🎨 Roles", value=" ".join(roles[:10]), inline=False) embed.set_footer(text=f"Requested by {ctx.author}", icon_url=ctx.author.display_avatar.url) await ctx.send(embed=embed) @commands.command() async def avatar(self, ctx, member: discord.Member = None): member = member or ctx.author embed = discord.Embed( title=f"🖼️ {member}'s Avatar", color=member.color ) embed.set_image(url=member.display_avatar.url) embed.add_field(name="🔗 Links", value=f"[PNG]({member.display_avatar.replace(format='png').url}) | [JPG]({member.display_avatar.replace(format='jpg').url}) | [WEBP]({member.display_avatar.url})", inline=False) await ctx.send(embed=embed) @commands.command() async def roles(self, ctx): roles = [role for role in ctx.guild.roles if role.name != "@everyone"] roles.reverse() embed = discord.Embed( title=f"🎭 Roles in {ctx.guild.name}", description=f"Total: {len(roles)} roles", color=discord.Color.blue() ) role_list = "\n".join([f"{role.mention} - {len(role.members)} members" for role in roles[:25]]) embed.add_field(name="Roles", value=role_list or "No roles", inline=False) await ctx.send(embed=embed) @commands.command() async def emojis(self, ctx): emojis = ctx.guild.emojis embed = discord.Embed( title=f"😀 Emojis in {ctx.guild.name}", description=f"Total: {len(emojis)} emojis", color=discord.Color.blue() ) if emojis: emoji_list = " ".join([str(emoji) for emoji in emojis[:50]]) embed.add_field(name="Emojis", value=emoji_list, inline=False) else: embed.add_field(name="Emojis", value="No custom emojis", inline=False) await ctx.send(embed=embed) @commands.command() @commands.has_permissions(manage_messages=True) async def poll(self, ctx, question: str, *options): if len(options) < 2: return await ctx.send("❌ Please provide at least 2 options!") if len(options) > 10: return await ctx.send("❌ Maximum 10 options allowed!") embed = discord.Embed( title="📊 Poll", description=question, color=discord.Color.blue() ) reactions = ['1️⃣', '2️⃣', '3️⃣', '4️⃣', '5️⃣', '6️⃣', '7️⃣', '8️⃣', '9️⃣', '🔟'] for i, option in enumerate(options): embed.add_field(name=f"{reactions[i]} Option {i+1}", value=option, inline=False) embed.set_footer(text=f"Poll by {ctx.author}", icon_url=ctx.author.display_avatar.url) poll_msg = await ctx.send(embed=embed) for i in range(len(options)): await poll_msg.add_reaction(reactions[i]) @commands.command() @commands.has_permissions(manage_messages=True) async def announce(self, ctx, channel: discord.TextChannel, *, message: str): embed = discord.Embed( title="📢 Announcement", description=message, color=discord.Color.gold() ) embed.set_footer(text=f"Announced by {ctx.author}", icon_url=ctx.author.display_avatar.url) embed.timestamp = datetime.datetime.utcnow() await channel.send(embed=embed) await ctx.send(f"✅ Announcement sent to {channel.mention}") @commands.command() async def ping(self, ctx): latency = round(self.bot.latency * 1000) embed = discord.Embed( title="🏓 Pong!", description=f"Latency: `{latency}ms`", color=discord.Color.green() ) await ctx.send(embed=embed) @commands.command() async def createfile(self, ctx, filename: str, *, content: str): if not filename.endswith('.txt'): filename += '.txt' file_data = io.BytesIO(content.encode('utf-8')) discord_file = discord.File(fp=file_data, filename=filename) embed = discord.Embed( title="📄 File Created", description=f"File: `{filename}`\nSize: {len(content)} characters", color=discord.Color.green() ) embed.set_footer(text=f"Created by {ctx.author}", icon_url=ctx.author.display_avatar.url) await ctx.send(embed=embed, file=discord_file) @commands.command() async def downloadtext(self, ctx, *, text: str): file_data = io.BytesIO(text.encode('utf-8')) discord_file = discord.File(fp=file_data, filename='message.txt') await ctx.send("📥 Here's your downloadable file:", file=discord_file) @commands.command(name='guide') async def guide(self, ctx): guide_text = """╔══════════════════════════════════════════════════════════════════════════╗ ║ 🛡️ SERVERGUARDIAN BOT - COMPLETE COMMAND GUIDE ║ ║ How To Use Every Command ║ ╚══════════════════════════════════════════════════════════════════════════╝ 📝 PREFIX: ! (Use ! before every command) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔨 MODERATION COMMANDS - Manage Your Server ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !kick [reason] 📌 What it does: Removes a member from the server (not banned) ⚙️ Permission Required: Kick Members 💡 Example: !kick @User was spamming ℹ️ Note: Member can rejoin with invite link 2️⃣ !ban [reason] 📌 What it does: Permanently bans a member from the server ⚙️ Permission Required: Ban Members 💡 Example: !ban @BadUser violated rules ℹ️ Note: Member cannot rejoin unless unbanned 3️⃣ !unban [reason] 📌 What it does: Unbans a previously banned user ⚙️ Permission Required: Ban Members 💡 Example: !unban 1234567890 appealed successfully ℹ️ Note: You need the user's Discord ID 4️⃣ !mute [duration] [reason] 📌 What it does: Times out a member (can't send messages) ⚙️ Permission Required: Moderate Members 💡 Example: !mute @User 10 spamming messages ℹ️ Note: Duration is in minutes (10 = 10 minutes) 5️⃣ !unmute 📌 What it does: Removes timeout from a muted member ⚙️ Permission Required: Moderate Members 💡 Example: !unmute @User ℹ️ Note: Member can send messages again 6️⃣ !warn [reason] 📌 What it does: Issues a warning to a member (saved in records) ⚙️ Permission Required: Kick Members 💡 Example: !warn @User inappropriate language ℹ️ Note: Warnings are permanently stored 7️⃣ !warnings [member] 📌 What it does: Shows all warnings for a member ⚙️ Permission Required: Kick Members 💡 Example: !warnings @User ℹ️ Note: Leave member blank to see your own warnings 8️⃣ !clear [amount] 📌 What it does: Deletes messages from the channel ⚙️ Permission Required: Manage Messages 💡 Example: !clear 50 (deletes 50 messages) ℹ️ Note: Maximum 100 messages at once 9️⃣ !lock [channel] 📌 What it does: Locks a channel (members can't send messages) ⚙️ Permission Required: Manage Channels 💡 Example: !lock #general ℹ️ Note: Leave channel blank to lock current channel 🔟 !unlock [channel] 📌 What it does: Unlocks a previously locked channel ⚙️ Permission Required: Manage Channels 💡 Example: !unlock #general ℹ️ Note: Members can send messages again 1️⃣1️⃣ !slowmode 📌 What it does: Sets slowmode delay in a channel ⚙️ Permission Required: Manage Channels 💡 Example: !slowmode 10 (10 second delay) ℹ️ Note: Use 0 to disable slowmode 1️⃣2️⃣ !nuke 📌 What it does: Deletes and recreates the channel (clears all messages) ⚙️ Permission Required: Manage Channels 💡 Example: !nuke ⚠️ WARNING: All messages in the channel will be permanently deleted! ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎫 TICKET COMMANDS - Support Ticket System ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !ticketsetup 📌 What it does: Sets up the ticket system ⚙️ Permission Required: Administrator 💡 Example: !ticketsetup Support ℹ️ Note: Category must already exist in your server 2️⃣ !ticketpanel 📌 What it does: Creates a ticket panel with a button ⚙️ Permission Required: Administrator 💡 Example: !ticketpanel ℹ️ Note: Users click the button to create tickets 3️⃣ !close 📌 What it does: Closes the current ticket channel ⚙️ Permission Required: Manage Channels 💡 Example: !close ℹ️ Note: Only works in ticket channels 4️⃣ !add 📌 What it does: Adds a member to the ticket ⚙️ Permission Required: Manage Channels 💡 Example: !add @Admin ℹ️ Note: Member can view and send messages in ticket 5️⃣ !remove 📌 What it does: Removes a member from the ticket ⚙️ Permission Required: Manage Channels 💡 Example: !remove @User ℹ️ Note: Member can no longer access the ticket ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 👋 WELCOME COMMANDS - Greet New Members ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !setwelcome 📌 What it does: Sets the welcome message channel ⚙️ Permission Required: Administrator 💡 Example: !setwelcome #welcome ℹ️ Note: New members will be greeted here 2️⃣ !setgoodbye 📌 What it does: Sets the goodbye message channel ⚙️ Permission Required: Administrator 💡 Example: !setgoodbye #goodbye ℹ️ Note: Leaving members will be mentioned here 3️⃣ !welcomemsg 📌 What it does: Sets a custom welcome message ⚙️ Permission Required: Administrator 💡 Example: !welcomemsg Welcome {user} to {server}! ℹ️ Note: Available variables: {user} = member mention {server} = server name {count} = total member count 4️⃣ !goodbyemsg 📌 What it does: Sets a custom goodbye message ⚙️ Permission Required: Administrator 💡 Example: !goodbyemsg {user} left the server ℹ️ Note: Same variables as welcome message 5️⃣ !autorole 📌 What it does: Automatically assigns a role to new members ⚙️ Permission Required: Administrator 💡 Example: !autorole @Member ℹ️ Note: Role is given when member joins 6️⃣ !testwelcome 📌 What it does: Sends a test welcome message ⚙️ Permission Required: Administrator 💡 Example: !testwelcome ℹ️ Note: Preview how your welcome message looks ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🔒 SECURITY COMMANDS - Protect Your Server ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !verifysetup 📌 What it does: Sets up verification system ⚙️ Permission Required: Administrator 💡 Example: !verifysetup @Verified ℹ️ Note: Members click button to get verified 2️⃣ !antispam 📌 What it does: Toggles anti-spam protection ⚙️ Permission Required: Administrator 💡 Example: !antispam on ℹ️ Note: Automatically warns/mutes spammers 3️⃣ !antiraid 📌 What it does: Toggles raid protection ⚙️ Permission Required: Administrator 💡 Example: !antiraid on ℹ️ Note: Blocks mass join attempts 4️⃣ !lockdown 📌 What it does: Locks all server channels ⚙️ Permission Required: Administrator 💡 Example: !lockdown ⚠️ WARNING: No member can send messages in any channel! 5️⃣ !unlockdown 📌 What it does: Unlocks all server channels ⚙️ Permission Required: Administrator 💡 Example: !unlockdown ℹ️ Note: Everything returns to normal ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🛠️ UTILITY COMMANDS - Useful Features ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !serverinfo 📌 What it does: Shows detailed server information ⚙️ Permission Required: None (anyone can use) 💡 Example: !serverinfo ℹ️ Note: Shows members, channels, roles, owner, etc. 2️⃣ !userinfo [member] 📌 What it does: Shows information about a user ⚙️ Permission Required: None (anyone can use) 💡 Example: !userinfo @User ℹ️ Note: Leave blank to see your own info 3️⃣ !avatar [member] 📌 What it does: Shows user's profile picture in large size ⚙️ Permission Required: None (anyone can use) 💡 Example: !avatar @User ℹ️ Note: Includes download links (PNG, JPG, WEBP) 4️⃣ !roles 📌 What it does: Lists all server roles ⚙️ Permission Required: None (anyone can use) 💡 Example: !roles ℹ️ Note: Shows member count per role 5️⃣ !emojis 📌 What it does: Shows all custom server emojis ⚙️ Permission Required: None (anyone can use) 💡 Example: !emojis ℹ️ Note: Maximum 50 emojis displayed at once 6️⃣ !poll ... 📌 What it does: Creates a poll with reactions ⚙️ Permission Required: Manage Messages 💡 Example: !poll "Favorite color?" Red Blue Green ℹ️ Note: Minimum 2 options, maximum 10 7️⃣ !announce 📌 What it does: Sends an announcement to a channel ⚙️ Permission Required: Manage Messages 💡 Example: !announce #announcements New update released! ℹ️ Note: Message appears in a beautiful embed 8️⃣ !ping 📌 What it does: Checks bot's latency/speed ⚙️ Permission Required: None (anyone can use) 💡 Example: !ping ℹ️ Note: Shows response time in milliseconds (lower = faster) 9️⃣ !createfile 📌 What it does: Creates a downloadable text file ⚙️ Permission Required: None (anyone can use) 💡 Example: !createfile notes.txt This is important ℹ️ Note: File can be downloaded by clicking 🔟 !downloadtext 📌 What it does: Converts text to a downloadable file ⚙️ Permission Required: None (anyone can use) 💡 Example: !downloadtext This will be in a file ℹ️ Note: Useful for long messages 1️⃣1️⃣ !guide 📌 What it does: Generates this complete command guide ⚙️ Permission Required: None (anyone can use) 💡 Example: !guide ℹ️ Note: Download as file for offline reference ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📊 LOGGING COMMANDS - Track Server Events ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !setlog 📌 What it does: Sets the logging channel ⚙️ Permission Required: Administrator 💡 Example: !setlog #logs ℹ️ Note: Logs member joins/leaves, bans, message deletes, etc. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚙️ CONFIGURATION COMMANDS - Bot Settings ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1️⃣ !prefix 📌 What it does: Changes the bot's command prefix ⚙️ Permission Required: Administrator 💡 Example: !prefix ? ℹ️ Note: Commands will become ?help, ?ping, etc. 2️⃣ !help 📌 What it does: Shows the help menu (quick overview) ⚙️ Permission Required: None (anyone can use) 💡 Example: !help ℹ️ Note: Basic command list in embed format ╔══════════════════════════════════════════════════════════════════════════╗ ║ 📌 IMPORTANT NOTES ║ ╚══════════════════════════════════════════════════════════════════════════╝ • <> brackets = REQUIRED parameters Example: !kick — you MUST mention a member • [] brackets = OPTIONAL parameters Example: !clear [amount] — without amount, defaults to 10 • Admin commands require proper Discord permissions If you lack permission, the command won't work • Bot needs these permissions (set in server settings): ✓ Kick Members, Ban Members, Manage Messages ✓ Manage Channels, Manage Roles, Moderate Members ✓ Send Messages, Embed Links, Attach Files • Some commands are for server owner/administrator only: ticketsetup, verifysetup, prefix, setwelcome, etc. • Bot's role must be ABOVE member roles in hierarchy Otherwise it cannot manage them (role order matters!) ╔══════════════════════════════════════════════════════════════════════════╗ ║ 🎯 QUICK START GUIDE ║ ╚══════════════════════════════════════════════════════════════════════════╝ Follow these steps to set up your server: STEP 1: Give Bot Permissions Server Settings > Roles > ServerGuardian Enable Administrator (or specific permissions) STEP 2: Set Up Welcome System !setwelcome #welcome-channel !welcomemsg Welcome {user} to {server}! We now have {count} members! !autorole @Member (optional) STEP 3: Set Up Logging !setlog #logs All events will be recorded here STEP 4: Set Up Ticket System (Optional) First create a category: "Support" Then: !ticketsetup Support Then: !ticketpanel STEP 5: Enable Security !antispam on !antiraid on STEP 6: Test Everything !testwelcome (check welcome messages) !ping (verify bot is responding) Your server is now ready! 🎉 ╔══════════════════════════════════════════════════════════════════════════╗ ║ ❓ COMMON PROBLEMS & SOLUTIONS ║ ╚══════════════════════════════════════════════════════════════════════════╝ Q: Bot not responding to commands? A: ✓ Check bot is online (green status) ✓ Verify prefix is correct (!help to test) ✓ Check bot has permission to send messages in channel Q: Bot can't kick/ban members? A: ✓ Move bot's role ABOVE target member's highest role ✓ Verify bot has Kick/Ban Members permission ✓ Bot cannot moderate server owner or equal/higher roles Q: Welcome messages not appearing? A: ✓ Verify channel was set: !setwelcome #channel ✓ Check bot has permission to send messages there ✓ Test with !testwelcome Q: Ticket system not working? A: ✓ Category must exist before running !ticketsetup ✓ Bot needs Manage Channels permission ✓ Check category isn't full (50 channels max) Q: Commands show "Missing Permissions" error? A: ✓ You need the required permission for that command ✓ Check command requirements in this guide ✓ Ask server admin to grant you permissions """ file_data = io.BytesIO(guide_text.encode('utf-8')) discord_file = discord.File(fp=file_data, filename='ServerGuardian_Commands_Guide.txt') embed = discord.Embed( title="📚 Complete Command Guide", description="Here's the complete guide with all commands, how to use them, and what they do!", color=discord.Color.blue() ) embed.add_field(name="📄 File", value="ServerGuardian_Commands_Guide.txt", inline=False) embed.add_field(name="📊 Content", value="50+ Commands | Setup Guides | Troubleshooting", inline=False) embed.set_footer(text=f"Requested by {ctx.author}", icon_url=ctx.author.display_avatar.url) await ctx.send(embed=embed, file=discord_file) async def setup(bot): await bot.add_cog(Utility(bot))