import time from collections import deque from datetime import datetime, timedelta, timezone import discord from discord import app_commands from discord.ext import commands, tasks import config import guildconf VERIFY_TIMEOUT = 24 * 3600 REVIEW_TIMEOUT = 7 * 24 * 3600 NEW_ACCOUNT = timedelta(days=7) YOUNG_ACCOUNT = timedelta(days=30) SPIKE_JOINS = 5 SPIKE_WINDOW = 60 PANEL_TEXT = ( "**Welcome!**\n" "Press the button below to get access to the rest of the server." ) REVIEW_ACTIONS = { "approve": ("Approve", discord.ButtonStyle.success), "kick": ("Kick", discord.ButtonStyle.secondary), "ban": ("Ban", discord.ButtonStyle.danger), } async def dm(member, text): try: await member.send(text) except discord.HTTPException: pass def flags_for(member, spike): age = datetime.now(timezone.utc) - member.created_at flags = [] if age < NEW_ACCOUNT: flags.append(f"Account is less than {NEW_ACCOUNT.days} days old") if spike: flags.append("Joined during a spike of new members") if member.avatar is None and age < YOUNG_ACCOUNT: flags.append("Default avatar on an account under 30 days old") return flags class VerifyView(discord.ui.View): def __init__(self): super().__init__(timeout=None) @discord.ui.button(label="Verify", style=discord.ButtonStyle.success, custom_id="verify:start") async def verify(self, interaction: discord.Interaction, button): await interaction.client.get_cog("Verification").handle_verify(interaction) class ReviewButton( discord.ui.DynamicItem[discord.ui.Button], template=r"vreview:(?Papprove|kick|ban):(?P[0-9]+)", ): def __init__(self, action, user_id): label, style = REVIEW_ACTIONS[action] super().__init__(discord.ui.Button( label=label, style=style, custom_id=f"vreview:{action}:{user_id}")) self.action = action self.user_id = user_id @classmethod async def from_custom_id(cls, interaction, item, match): return cls(match["action"], int(match["uid"])) async def callback(self, interaction: discord.Interaction): await interaction.client.get_cog("Verification").handle_review( interaction, self.action, self.user_id) def review_view(user_id): view = discord.ui.View(timeout=None) for action in REVIEW_ACTIONS: view.add_item(ReviewButton(action, user_id)) return view class Verification(commands.Cog): def __init__(self, bot): self.bot = bot self.joins = deque() async def cog_load(self): self.bot.add_view(VerifyView()) self.bot.add_dynamic_items(ReviewButton) self.sweep.start() async def cog_unload(self): self.sweep.cancel() group = app_commands.Group( name="verify", description="Configure member verification", guild_ids=[config.GUILD.id], guild_only=True, default_permissions=discord.Permissions(manage_guild=True), ) async def enabled(self): return await self.bot.db.get_setting(guildconf.VERIFY_ENABLED) == "1" async def verified_role(self, guild): role_id = await guildconf.get_id(self.bot, guildconf.VERIFIED_ROLE) return guild.get_role(role_id) if role_id else None async def review_channel(self, guild): channel_id = await guildconf.get_id(self.bot, guildconf.VERIFY_REVIEW) channel = guild.get_channel(channel_id) if channel_id else None return channel or await guildconf.mod_log_channel(self.bot, guild) async def track(self, member, spike=False): now = int(time.time()) await self.bot.db.execute( "INSERT OR IGNORE INTO pending_verifications " "(user_id, joined_at, deadline, flags) VALUES (?, ?, ?, ?)", member.id, now, now + VERIFY_TIMEOUT, ";".join(flags_for(member, spike))) async def forget(self, user_id): await self.bot.db.execute( "DELETE FROM pending_verifications WHERE user_id = ?", user_id) async def reconcile(self): guild = self.bot.get_guild(config.GUILD.id) role = await self.verified_role(guild) if guild else None if role is None: return for member in guild.members: if not member.bot and role not in member.roles: await self.track(member) async def send_review(self, member, flags, joined_at): channel = await self.review_channel(member.guild) if channel is None: return False embed = discord.Embed( title="Verification review", description=f"{member.mention} ({member})", colour=discord.Colour.orange()) embed.set_thumbnail(url=member.display_avatar.url) embed.add_field( name="Account created", value=f"") embed.add_field(name="Joined", value=f"") embed.add_field( name="Flags", value="\n".join(f"- {f}" for f in flags), inline=False) embed.set_footer(text=f"User ID: {member.id}") try: await channel.send(embed=embed, view=review_view(member.id)) except discord.HTTPException: return False return True async def handle_verify(self, interaction): await interaction.response.defer(ephemeral=True) member, guild = interaction.user, interaction.guild role = await self.verified_role(guild) async def reply(text): await interaction.followup.send(text, ephemeral=True) if role is None or not await self.enabled(): await reply("Verification isn't active right now.") return if role in member.roles: await reply("You're already verified.") return await self.track(member) row = await self.bot.db.fetchone( "SELECT * FROM pending_verifications WHERE user_id = ?", member.id) if row["in_review"]: await reply("A moderator is already reviewing your account. " "You'll get access once it's approved.") return if row["flags"]: sent = await self.send_review( member, row["flags"].split(";"), row["joined_at"]) if not sent: await reply("Verification is temporarily unavailable. " "Please try again later.") return await self.bot.db.execute( "UPDATE pending_verifications SET in_review = 1, deadline = ? " "WHERE user_id = ?", int(time.time()) + REVIEW_TIMEOUT, member.id) await reply("Thanks! A moderator needs to look at your account " "before you get access. This can take a while.") return try: await member.add_roles(role, reason="Passed verification") except discord.HTTPException as e: print(f"verify: could not add role: {e}", flush=True) await reply("Something went wrong. Please contact a moderator.") return await self.forget(member.id) await reply("You're verified. Welcome!") async def handle_review(self, interaction, action, user_id): check = guildconf.is_admin if action == "ban" else guildconf.is_mod if not await check(self.bot, interaction.user): await interaction.response.send_message( "You don't have permission to do that.", ephemeral=True) return await interaction.response.defer() guild = interaction.guild member = guild.get_member(user_id) role = await self.verified_role(guild) by = interaction.user reason = f"Verification review by {by}" if member is None: await self.forget(user_id) outcome, colour = "User already left the server", discord.Colour.greyple() else: try: if action == "approve": await member.add_roles(role, reason=reason) outcome, colour = "Approved", discord.Colour.green() elif action == "kick": await dm(member, f"You were removed from {guild.name} after a " "verification review. You're welcome to rejoin.") await member.kick(reason=reason) await self.bot.db.add_case( user_id, by.id, "kick", "Failed verification review") outcome, colour = "Kicked", discord.Colour.red() else: await dm(member, f"You were banned from {guild.name} after a " "verification review.") await guild.ban(member, reason=reason) await self.bot.db.add_case( user_id, by.id, "ban", "Failed verification review") outcome, colour = "Banned", discord.Colour.red() except (discord.Forbidden, AttributeError): await interaction.followup.send( "I couldn't do that. Check the Verified role exists and that " "my role is above the member's.", ephemeral=True) return await self.forget(user_id) embed = interaction.message.embeds[0].copy() embed.colour = colour embed.add_field( name="Decision", value=f"{outcome} by {by.mention}", inline=False) await interaction.edit_original_response(embed=embed, view=None) @commands.Cog.listener() async def on_member_join(self, member): if member.guild.id != config.GUILD.id or not await self.enabled(): return role = await self.verified_role(member.guild) if role is None: return if member.bot: await member.add_roles(role, reason="Bot account") return now = time.time() self.joins.append(now) while self.joins and now - self.joins[0] > SPIKE_WINDOW: self.joins.popleft() await self.track(member, spike=len(self.joins) >= SPIKE_JOINS) @commands.Cog.listener() async def on_member_remove(self, member): if member.guild.id == config.GUILD.id: await self.forget(member.id) @tasks.loop(minutes=1) async def sweep(self): """Kicks members who missed their verification deadline.""" try: if not await self.enabled(): return guild = self.bot.get_guild(config.GUILD.id) role = await self.verified_role(guild) if guild else None if role is None: return rows = await self.bot.db.fetchall( "SELECT user_id FROM pending_verifications WHERE deadline < ?", int(time.time())) for row in rows: member = guild.get_member(row["user_id"]) await self.forget(row["user_id"]) if (member is None or role in member.roles or await guildconf.is_mod(self.bot, member)): continue await dm(member, f"You were removed from {guild.name} because you " "didn't verify in time. You're welcome to rejoin.") try: await member.kick(reason="Did not verify in time") except discord.HTTPException as e: print(f"verify sweep: could not kick {member.id}: {e}", flush=True) except Exception as e: print(f"verify sweep: unexpected error: {e!r}", flush=True) @sweep.before_loop async def before_sweep(self): await self.bot.wait_until_ready() if await self.enabled(): await self.reconcile() @group.command(name="setup", description="Create the Verified role and prepare the verify channel") @app_commands.describe( channel="The channel unverified members will see", review_channel="Where flagged members are sent for review (default: mod log)") @guildconf.admin_only() async def setup_cmd(self, interaction: discord.Interaction, channel: discord.TextChannel, review_channel: discord.TextChannel | None = None): await interaction.response.defer(ephemeral=True) guild = interaction.guild role = (await self.verified_role(guild) or discord.utils.get(guild.roles, name="Verified")) reason = "Verification setup" try: if role is None: role = await guild.create_role( name="Verified", permissions=discord.Permissions(view_channel=True), reason=reason) elif not role.permissions.view_channel: perms = role.permissions perms.view_channel = True await role.edit(permissions=perms, reason=reason) await channel.set_permissions( guild.default_role, reason=reason, overwrite=discord.PermissionOverwrite( view_channel=True, read_message_history=True, send_messages=False, add_reactions=False)) await channel.set_permissions( role, reason=reason, overwrite=discord.PermissionOverwrite(view_channel=False)) await channel.set_permissions( guild.me, reason=reason, overwrite=discord.PermissionOverwrite( view_channel=True, send_messages=True, embed_links=True)) except discord.Forbidden: await interaction.followup.send( "I need Manage Roles and Manage Channels, and my role must be " "above the Verified role.", ephemeral=True) return db = self.bot.db await db.set_setting(guildconf.VERIFIED_ROLE, role.id) await db.set_setting(guildconf.VERIFY_CHANNEL, channel.id) if review_channel is not None: await db.set_setting(guildconf.VERIFY_REVIEW, review_channel.id) await interaction.followup.send( f"Verified role: {role.mention}\nVerify channel: {channel.mention}\n" "Next: `/verify panel`, `/verify grandfather`, then `/verify enable`.", ephemeral=True) @group.command(name="panel", description="Post the verification button in the verify channel") @guildconf.admin_only() async def panel(self, interaction: discord.Interaction): await interaction.response.defer(ephemeral=True) channel_id = await guildconf.get_id(self.bot, guildconf.VERIFY_CHANNEL) channel = interaction.guild.get_channel(channel_id) if channel_id else None if channel is None: await interaction.followup.send("Run `/verify setup` first.", ephemeral=True) return await channel.send(content=PANEL_TEXT, view=VerifyView()) await interaction.followup.send(f"Posted in {channel.mention}.", ephemeral=True) @group.command(name="grandfather", description="Give Verified to everyone already in the server") @guildconf.admin_only() async def grandfather(self, interaction: discord.Interaction): await interaction.response.defer(ephemeral=True) guild = interaction.guild role = await self.verified_role(guild) if role is None: await interaction.followup.send("Run `/verify setup` first.", ephemeral=True) return done = failed = 0 for member in [m for m in guild.members if role not in m.roles]: try: await member.add_roles(role, reason="Existing member") done += 1 except discord.HTTPException: failed += 1 msg = f"Gave Verified to {done} members." if failed: msg += f" Failed for {failed}. Check my role position." await interaction.followup.send(msg, ephemeral=True) @group.command(name="enable", description="Turn the verification gate on") @guildconf.admin_only() async def enable(self, interaction: discord.Interaction): await interaction.response.defer(ephemeral=True) guild = interaction.guild role = await self.verified_role(guild) channel_id = await guildconf.get_id(self.bot, guildconf.VERIFY_CHANNEL) problem = None if role is None or not channel_id or guild.get_channel(channel_id) is None: problem = "Run `/verify setup` first." elif await self.review_channel(guild) is None: problem = "Set a mod log (`/config modlog`) or a review channel first." elif not guild.me.guild_permissions.view_channel: problem = "My role needs the View Channels permission." else: missing = [m for m in guild.members if role not in m.roles] if missing: problem = (f"{len(missing)} members don't have Verified yet. " "Run `/verify grandfather` first.") if problem: await interaction.followup.send(problem, ephemeral=True) return try: perms = guild.default_role.permissions perms.view_channel = False await guild.default_role.edit(permissions=perms, reason="Verification enabled") except discord.Forbidden: await interaction.followup.send( "I couldn't edit @everyone. I need Manage Roles.", ephemeral=True) return await self.bot.db.set_setting(guildconf.VERIFY_ENABLED, 1) await interaction.followup.send( "Verification is on. New members must verify to see the server.", ephemeral=True) @group.command(name="disable", description="Turn the verification gate off") @guildconf.admin_only() async def disable(self, interaction: discord.Interaction): await interaction.response.defer(ephemeral=True) guild = interaction.guild try: perms = guild.default_role.permissions perms.view_channel = True await guild.default_role.edit(permissions=perms, reason="Verification disabled") except discord.Forbidden: await interaction.followup.send( "I couldn't edit @everyone. I need Manage Roles.", ephemeral=True) return await self.bot.db.set_setting(guildconf.VERIFY_ENABLED, 0) await self.bot.db.execute("DELETE FROM pending_verifications") await interaction.followup.send( "Verification is off and everyone can see the server again.", ephemeral=True) async def setup(bot): await bot.add_cog(Verification(bot))