import discord from discord.ext import commands import os import json import logging from dotenv import load_dotenv load_dotenv() logging.basicConfig( level=logging.INFO, format="%(asctime)s [%(levelname)s] %(name)s: %(message)s", handlers=[ logging.FileHandler("bot.log"), logging.StreamHandler() ] ) log = logging.getLogger("ServerHelperBot") CONFIG_FILE = "config.json" def load_config(): if not os.path.exists(CONFIG_FILE): with open(CONFIG_FILE, "w") as f: json.dump({}, f) with open(CONFIG_FILE, "r") as f: return json.load(f) def save_config(data): with open(CONFIG_FILE, "w") as f: json.dump(data, f, indent=2) intents = discord.Intents.all() bot = commands.Bot(command_prefix="!", intents=intents, help_command=None) bot.config = load_config() bot.save_config = save_config # ── Events ──────────────────────────────────────────────────────────────────── @bot.event async def on_ready(): log.info(f"Logged in as {bot.user} (ID: {bot.user.id})") await bot.change_presence(activity=discord.Activity( type=discord.ActivityType.watching, name=f"{len(bot.guilds)} server(s) | !help" )) @bot.event async def on_member_join(member: discord.Member): guild_cfg = bot.config.get(str(member.guild.id), {}) channel_id = guild_cfg.get("welcome_channel") if not channel_id: return channel = member.guild.get_channel(channel_id) if not channel: return embed = discord.Embed( title="👋 Welcome!", description=f"Welcome to **{member.guild.name}**, {member.mention}!\nYou are member **#{member.guild.member_count}**.", color=0x5865F2 ) embed.set_thumbnail(url=member.display_avatar.url) await channel.send(embed=embed) @bot.event async def on_member_remove(member: discord.Member): guild_cfg = bot.config.get(str(member.guild.id), {}) channel_id = guild_cfg.get("welcome_channel") if not channel_id: return channel = member.guild.get_channel(channel_id) if not channel: return embed = discord.Embed( description=f"**{member}** has left the server.", color=0xED4245 ) await channel.send(embed=embed) @bot.event async def on_command_error(ctx: commands.Context, error): if isinstance(error, commands.MissingPermissions): await ctx.send(embed=error_embed("You don't have permission to use that command.")) elif isinstance(error, commands.BotMissingPermissions): await ctx.send(embed=error_embed("I don't have the required permissions to do that.")) elif isinstance(error, commands.MemberNotFound): await ctx.send(embed=error_embed("Member not found.")) elif isinstance(error, commands.MissingRequiredArgument): await ctx.send(embed=error_embed(f"Missing argument: `{error.param.name}`. Use `!help {ctx.command}` for usage.")) elif isinstance(error, commands.CommandNotFound): pass else: log.error(f"Unhandled error in {ctx.command}: {error}", exc_info=error) await ctx.send(embed=error_embed("An unexpected error occurred.")) # ── Helpers ─────────────────────────────────────────────────────────────────── def error_embed(msg: str) -> discord.Embed: return discord.Embed(description=f"❌ {msg}", color=0xED4245) def success_embed(msg: str) -> discord.Embed: return discord.Embed(description=f"✅ {msg}", color=0x57F287) async def send_mod_log(guild: discord.Guild, embed: discord.Embed): guild_cfg = bot.config.get(str(guild.id), {}) channel_id = guild_cfg.get("mod_log_channel") if not channel_id: return channel = guild.get_channel(channel_id) if channel: await channel.send(embed=embed) # ── Help ────────────────────────────────────────────────────────────────────── @bot.command(name="help") async def help_command(ctx: commands.Context, *, command_name: str = None): if command_name: cmd = bot.get_command(command_name) if not cmd: await ctx.send(embed=error_embed(f"Command `{command_name}` not found.")) return embed = discord.Embed( title=f"!{cmd.name}", description=cmd.help or "No description.", color=0x5865F2 ) await ctx.send(embed=embed) return embed = discord.Embed(title="📖 Server Helper Bot — Commands", color=0x5865F2) embed.add_field(name="🛡️ Moderation", value=( "`!kick` `!ban` `!unban` `!mute` `!unmute` `!warn` `!warnings` `!clearwarns`\n`!purge`" ), inline=False) embed.add_field(name="⚙️ Configuration", value=( "`!setwelcome` `!setmodlog`" ), inline=False) embed.add_field(name="ℹ️ Utility", value=( "`!userinfo` `!serverinfo` `!avatar` `!ping` `!poll`" ), inline=False) embed.set_footer(text="Use !help for details.") await ctx.send(embed=embed) # ── Moderation ──────────────────────────────────────────────────────────────── @bot.command(name="kick", help="Kick a member.\nUsage: !kick [reason]") @commands.has_permissions(kick_members=True) @commands.bot_has_permissions(kick_members=True) async def kick(ctx: commands.Context, member: discord.Member, *, reason: str = "No reason provided"): if member == ctx.author: await ctx.send(embed=error_embed("You cannot kick yourself.")) return if member.top_role >= ctx.author.top_role: await ctx.send(embed=error_embed("You cannot kick someone with an equal or higher role.")) return await member.kick(reason=f"{ctx.author}: {reason}") await ctx.send(embed=success_embed(f"Kicked **{member}** — {reason}")) embed = discord.Embed(title="👢 Member Kicked", color=0xFEE75C) embed.add_field(name="Member", value=str(member)) embed.add_field(name="Moderator", value=str(ctx.author)) embed.add_field(name="Reason", value=reason, inline=False) await send_mod_log(ctx.guild, embed) @bot.command(name="ban", help="Ban a member.\nUsage: !ban [reason]") @commands.has_permissions(ban_members=True) @commands.bot_has_permissions(ban_members=True) async def ban(ctx: commands.Context, member: discord.Member, *, reason: str = "No reason provided"): if member == ctx.author: await ctx.send(embed=error_embed("You cannot ban yourself.")) return if member.top_role >= ctx.author.top_role: await ctx.send(embed=error_embed("You cannot ban someone with an equal or higher role.")) return await member.ban(reason=f"{ctx.author}: {reason}", delete_message_days=0) await ctx.send(embed=success_embed(f"Banned **{member}** — {reason}")) embed = discord.Embed(title="🔨 Member Banned", color=0xED4245) embed.add_field(name="Member", value=str(member)) embed.add_field(name="Moderator", value=str(ctx.author)) embed.add_field(name="Reason", value=reason, inline=False) await send_mod_log(ctx.guild, embed) @bot.command(name="unban", help="Unban a user by ID or name#tag.\nUsage: !unban ") @commands.has_permissions(ban_members=True) @commands.bot_has_permissions(ban_members=True) async def unban(ctx: commands.Context, *, target: str): bans = [entry async for entry in ctx.guild.bans()] user = None if target.isdigit(): user = next((e.user for e in bans if e.user.id == int(target)), None) else: user = next((e.user for e in bans if str(e.user) == target), None) if not user: await ctx.send(embed=error_embed("No banned user found matching that ID or name.")) return await ctx.guild.unban(user) await ctx.send(embed=success_embed(f"Unbanned **{user}**.")) embed = discord.Embed(title="✅ Member Unbanned", color=0x57F287) embed.add_field(name="Member", value=str(user)) embed.add_field(name="Moderator", value=str(ctx.author)) await send_mod_log(ctx.guild, embed) @bot.command(name="mute", help="Timeout (mute) a member for a duration in minutes.\nUsage: !mute [reason]") @commands.has_permissions(moderate_members=True) @commands.bot_has_permissions(moderate_members=True) async def mute(ctx: commands.Context, member: discord.Member, minutes: int, *, reason: str = "No reason provided"): import datetime if member.top_role >= ctx.author.top_role: await ctx.send(embed=error_embed("You cannot mute someone with an equal or higher role.")) return if minutes < 1 or minutes > 40320: await ctx.send(embed=error_embed("Duration must be between 1 and 40320 minutes (28 days).")) return until = discord.utils.utcnow() + datetime.timedelta(minutes=minutes) await member.timeout(until, reason=f"{ctx.author}: {reason}") await ctx.send(embed=success_embed(f"Muted **{member}** for **{minutes}m** — {reason}")) embed = discord.Embed(title="🔇 Member Muted", color=0xFEE75C) embed.add_field(name="Member", value=str(member)) embed.add_field(name="Duration", value=f"{minutes} minutes") embed.add_field(name="Moderator", value=str(ctx.author)) embed.add_field(name="Reason", value=reason, inline=False) await send_mod_log(ctx.guild, embed) @bot.command(name="unmute", help="Remove a timeout from a member.\nUsage: !unmute ") @commands.has_permissions(moderate_members=True) @commands.bot_has_permissions(moderate_members=True) async def unmute(ctx: commands.Context, member: discord.Member): await member.timeout(None) await ctx.send(embed=success_embed(f"Unmuted **{member}**.")) embed = discord.Embed(title="🔊 Member Unmuted", color=0x57F287) embed.add_field(name="Member", value=str(member)) embed.add_field(name="Moderator", value=str(ctx.author)) await send_mod_log(ctx.guild, embed) @bot.command(name="warn", help="Warn a member.\nUsage: !warn [reason]") @commands.has_permissions(kick_members=True) async def warn(ctx: commands.Context, member: discord.Member, *, reason: str = "No reason provided"): if member.bot: await ctx.send(embed=error_embed("You cannot warn bots.")) return guild_id = str(ctx.guild.id) user_id = str(member.id) if guild_id not in bot.config: bot.config[guild_id] = {} if "warnings" not in bot.config[guild_id]: bot.config[guild_id]["warnings"] = {} if user_id not in bot.config[guild_id]["warnings"]: bot.config[guild_id]["warnings"][user_id] = [] bot.config[guild_id]["warnings"][user_id].append({ "reason": reason, "moderator": str(ctx.author), "moderator_id": ctx.author.id }) bot.save_config(bot.config) count = len(bot.config[guild_id]["warnings"][user_id]) await ctx.send(embed=success_embed(f"Warned **{member}** (warning #{count}) — {reason}")) embed = discord.Embed(title="⚠️ Member Warned", color=0xFEE75C) embed.add_field(name="Member", value=str(member)) embed.add_field(name="Warning #", value=str(count)) embed.add_field(name="Moderator", value=str(ctx.author)) embed.add_field(name="Reason", value=reason, inline=False) await send_mod_log(ctx.guild, embed) @bot.command(name="warnings", help="View warnings for a member.\nUsage: !warnings ") @commands.has_permissions(kick_members=True) async def warnings(ctx: commands.Context, member: discord.Member): guild_id = str(ctx.guild.id) user_id = str(member.id) warns = bot.config.get(guild_id, {}).get("warnings", {}).get(user_id, []) if not warns: await ctx.send(embed=discord.Embed(description=f"**{member}** has no warnings.", color=0x5865F2)) return embed = discord.Embed(title=f"⚠️ Warnings for {member}", color=0xFEE75C) for i, w in enumerate(warns, 1): embed.add_field(name=f"#{i} — {w['moderator']}", value=w["reason"], inline=False) await ctx.send(embed=embed) @bot.command(name="clearwarns", help="Clear all warnings for a member.\nUsage: !clearwarns ") @commands.has_permissions(kick_members=True) async def clearwarns(ctx: commands.Context, member: discord.Member): guild_id = str(ctx.guild.id) user_id = str(member.id) if guild_id in bot.config and "warnings" in bot.config[guild_id]: bot.config[guild_id]["warnings"].pop(user_id, None) bot.save_config(bot.config) await ctx.send(embed=success_embed(f"Cleared all warnings for **{member}**.")) @bot.command(name="purge", help="Delete a number of messages from the channel.\nUsage: !purge ") @commands.has_permissions(manage_messages=True) @commands.bot_has_permissions(manage_messages=True) async def purge(ctx: commands.Context, amount: int): if amount < 1 or amount > 500: await ctx.send(embed=error_embed("Amount must be between 1 and 500.")) return await ctx.message.delete() deleted = await ctx.channel.purge(limit=amount) msg = await ctx.send(embed=success_embed(f"Deleted **{len(deleted)}** messages.")) import asyncio await asyncio.sleep(4) await msg.delete() # ── Configuration ───────────────────────────────────────────────────────────── @bot.command(name="setwelcome", help="Set the welcome/leave message channel.\nUsage: !setwelcome <#channel>") @commands.has_permissions(manage_guild=True) async def setwelcome(ctx: commands.Context, channel: discord.TextChannel): guild_id = str(ctx.guild.id) if guild_id not in bot.config: bot.config[guild_id] = {} bot.config[guild_id]["welcome_channel"] = channel.id bot.save_config(bot.config) await ctx.send(embed=success_embed(f"Welcome channel set to {channel.mention}.")) @bot.command(name="setmodlog", help="Set the mod-log channel for moderation actions.\nUsage: !setmodlog <#channel>") @commands.has_permissions(manage_guild=True) async def setmodlog(ctx: commands.Context, channel: discord.TextChannel): guild_id = str(ctx.guild.id) if guild_id not in bot.config: bot.config[guild_id] = {} bot.config[guild_id]["mod_log_channel"] = channel.id bot.save_config(bot.config) await ctx.send(embed=success_embed(f"Mod-log channel set to {channel.mention}.")) # ── Utility ─────────────────────────────────────────────────────────────────── @bot.command(name="userinfo", help="Show info about a member.\nUsage: !userinfo [member]") async def userinfo(ctx: commands.Context, member: discord.Member = None): member = member or ctx.author roles = [r.mention for r in reversed(member.roles) if r != ctx.guild.default_role] embed = discord.Embed(title=str(member), color=member.color) embed.set_thumbnail(url=member.display_avatar.url) embed.add_field(name="ID", value=member.id) embed.add_field(name="Nickname", value=member.nick or "None") embed.add_field(name="Bot", value="Yes" if member.bot else "No") embed.add_field(name="Account Created", value=discord.utils.format_dt(member.created_at, "R"), inline=False) embed.add_field(name="Joined Server", value=discord.utils.format_dt(member.joined_at, "R"), inline=False) embed.add_field(name=f"Roles ({len(roles)})", value=" ".join(roles) if roles else "None", inline=False) await ctx.send(embed=embed) @bot.command(name="serverinfo", help="Show info about the server.\nUsage: !serverinfo") async def serverinfo(ctx: commands.Context): g = ctx.guild embed = discord.Embed(title=g.name, color=0x5865F2) if g.icon: embed.set_thumbnail(url=g.icon.url) embed.add_field(name="ID", value=g.id) embed.add_field(name="Owner", value=str(g.owner)) embed.add_field(name="Members", value=g.member_count) embed.add_field(name="Channels", value=len(g.channels)) embed.add_field(name="Roles", value=len(g.roles)) embed.add_field(name="Boosts", value=g.premium_subscription_count) embed.add_field(name="Created", value=discord.utils.format_dt(g.created_at, "R"), inline=False) await ctx.send(embed=embed) @bot.command(name="avatar", help="Show a member's avatar.\nUsage: !avatar [member]") async def avatar(ctx: commands.Context, member: discord.Member = None): member = member or ctx.author embed = discord.Embed(title=f"{member}'s Avatar", color=0x5865F2) embed.set_image(url=member.display_avatar.url) await ctx.send(embed=embed) @bot.command(name="ping", help="Check the bot's latency.\nUsage: !ping") async def ping(ctx: commands.Context): latency = round(bot.latency * 1000) color = 0x57F287 if latency < 100 else (0xFEE75C if latency < 200 else 0xED4245) embed = discord.Embed(description=f"🏓 Pong! **{latency}ms**", color=color) await ctx.send(embed=embed) @bot.command(name="poll", help="Create a poll with up to 9 options.\nUsage: !poll | | ...") async def poll(ctx: commands.Context, *, content: str): parts = [p.strip() for p in content.split("|")] if len(parts) < 3: await ctx.send(embed=error_embed("Provide a question and at least 2 options, separated by `|`.\nExample: `!poll Favourite color? | Red | Blue | Green`")) return if len(parts) > 10: await ctx.send(embed=error_embed("Maximum 9 options allowed.")) return question = parts[0] options = parts[1:] number_emojis = ["1️⃣","2️⃣","3️⃣","4️⃣","5️⃣","6️⃣","7️⃣","8️⃣","9️⃣"] description = "\n\n".join(f"{number_emojis[i]} {opt}" for i, opt in enumerate(options)) embed = discord.Embed(title=f"📊 {question}", description=description, color=0x5865F2) embed.set_footer(text=f"Poll by {ctx.author}", icon_url=ctx.author.display_avatar.url) await ctx.message.delete() poll_msg = await ctx.send(embed=embed) for i in range(len(options)): await poll_msg.add_reaction(number_emojis[i]) # ── Run ──────────────────────────────────────────────────────────────────────── token = os.getenv("DISCORD_TOKEN") if not token: log.critical("DISCORD_TOKEN not found in environment. Set it in your .env file.") exit(1) bot.run(token, log_handler=None)