디스코드 봇 만들기#32서버 로그·감사(Audit Log) 채널 만들기! 메시지 삭제·수정·입퇴장·추방까지 자동 기록 (파이썬 예제) 🕵️

pip install -U discord.py python-dotenv

token=여기에_봇_토큰

# discord.py 2.7.1 / Python 3.9+ / python-dotenv 1.x
import os
import json
import asyncio

import discord
from discord import app_commands
from discord.ext import commands
from dotenv import load_dotenv

load_dotenv()
token = os.getenv("token")

CONFIG_FILE = "log_config.json"   # {서버ID(str): 로그채널ID(int)}
MAX_CONTENT = 1000                # 임베드 필드 최대 1024자 → 여유 있게 자르기

intents = discord.Intents.default()
intents.message_content = True   # 지워진 메시지 '내용'을 보려면 필수 (특권 인텐트)
intents.members = True           # 입퇴장·닉네임·역할 변경 감지 (특권 인텐트)
intents.moderation = True        # 추방·차단 + 감사 로그 이벤트

bot = commands.Bot(command_prefix="!", intents=intents, max_messages=5000)

log_channels: dict[str, int] = {}
lock = asyncio.Lock()

def save():
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump(log_channels, f, ensure_ascii=False, indent=2)


def load():
    global log_channels
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, encoding="utf-8") as f:
            log_channels = json.load(f)


def get_log_channel(guild: discord.Guild):
    cid = log_channels.get(str(guild.id))
    return guild.get_channel(cid) if cid else None


def make_embed(title: str, color: discord.Color, user=None) -> discord.Embed:
    embed = discord.Embed(title=title, color=color, timestamp=discord.utils.utcnow())
    if user is not None:
        embed.set_author(name=f"{user} ({user.id})", icon_url=user.display_avatar.url)
    return embed


async def send_log(guild: discord.Guild, embed: discord.Embed):
    channel = get_log_channel(guild)
    if channel is None:
        return
    try:
        await channel.send(embed=embed)
    except discord.Forbidden:
        print(f"⚠️ {guild.name}: 로그 채널에 메시지를 보낼 권한이 없어요.")


def cut(text: str) -> str:
    text = text or "(내용 없음 — 임베드/첨부만 있거나 캐시에 없음)"
    return text if len(text) <= MAX_CONTENT else text[:MAX_CONTENT] + " …(생략)"

async def find_deleter(guild: discord.Guild, author_id: int, channel_id: int):
    """감사 로그에서 '방금 이 사람 메시지를 이 채널에서 지운 관리자'를 찾아요."""
    try:
        async for entry in guild.audit_logs(limit=5, action=discord.AuditLogAction.message_delete):
            same_target = entry.target is not None and entry.target.id == author_id
            same_channel = entry.extra.channel.id == channel_id
            recent = (discord.utils.utcnow() - entry.created_at).total_seconds() < 15
            if same_target and same_channel and recent:
                return entry.user
    except discord.Forbidden:
        return None
    return None


@bot.event
async def on_raw_message_delete(payload: discord.RawMessageDeleteEvent):
    if payload.guild_id is None:      # DM은 무시
        return
    guild = bot.get_guild(payload.guild_id)
    msg = payload.cached_message

    embed = make_embed("🗑️ 메시지 삭제", discord.Color.red(), msg.author if msg else None)
    embed.add_field(name="채널", value=f"<#{payload.channel_id}>", inline=True)

    if msg is None:
        embed.add_field(name="내용", value="캐시에 없는 메시지예요 (봇 시작 전 메시지)", inline=False)
        embed.set_footer(text=f"메시지 ID: {payload.message_id}")
    else:
        if msg.author.bot:
            return
        deleter = await find_deleter(guild, msg.author.id, payload.channel_id)
        who = deleter.mention if deleter else "본인 (또는 확인 불가)"
        embed.add_field(name="삭제한 사람", value=who, inline=True)
        embed.add_field(name="내용", value=cut(msg.content), inline=False)
        if msg.attachments:
            files = "\n".join(a.filename for a in msg.attachments)
            embed.add_field(name="첨부파일", value=files, inline=False)
        embed.set_footer(text=f"메시지 ID: {msg.id}")

    await send_log(guild, embed)


@bot.event
async def on_raw_message_edit(payload: discord.RawMessageUpdateEvent):
    if payload.guild_id is None:
        return
    before = payload.cached_message
    after = payload.message
    if before is None or after.author.bot:
        return
    if before.content == after.content:      # 임베드 미리보기 생성 등 '가짜 수정' 걸러내기
        return

    guild = bot.get_guild(payload.guild_id)
    embed = make_embed("✏️ 메시지 수정", discord.Color.orange(), after.author)
    embed.add_field(name="채널", value=after.channel.mention, inline=True)
    embed.add_field(name="바로가기", value=f"[메시지로 이동]({after.jump_url})", inline=True)
    embed.add_field(name="수정 전", value=cut(before.content), inline=False)
    embed.add_field(name="수정 후", value=cut(after.content), inline=False)
    await send_log(guild, embed)


@bot.event
async def on_raw_bulk_message_delete(payload: discord.RawBulkMessageDeleteEvent):
    if payload.guild_id is None:
        return
    guild = bot.get_guild(payload.guild_id)
    embed = make_embed("🧹 메시지 대량 삭제", discord.Color.dark_red())
    embed.add_field(name="채널", value=f"<#{payload.channel_id}>", inline=True)
    embed.add_field(name="개수", value=f"{len(payload.message_ids)}개", inline=True)
    await send_log(guild, embed)

@bot.event
async def on_member_join(member: discord.Member):
    embed = make_embed("📥 멤버 입장", discord.Color.green(), member)
    embed.add_field(name="멤버", value=member.mention, inline=True)
    embed.add_field(name="계정 생성일", value=discord.utils.format_dt(member.created_at, "R"), inline=True)
    embed.add_field(name="현재 인원", value=f"{member.guild.member_count}명", inline=True)
    await send_log(member.guild, embed)


@bot.event
async def on_member_remove(member: discord.Member):
    embed = make_embed("📤 멤버 퇴장", discord.Color.light_grey(), member)
    embed.add_field(name="멤버", value=f"{member} ({member.mention})", inline=True)
    if member.joined_at:
        embed.add_field(name="입장일", value=discord.utils.format_dt(member.joined_at, "R"), inline=True)
    roles = [r.mention for r in member.roles if r != member.guild.default_role]
    if roles:
        embed.add_field(name="가지고 있던 역할", value=" ".join(roles), inline=False)
    await send_log(member.guild, embed)


@bot.event
async def on_member_update(before: discord.Member, after: discord.Member):
    if before.nick != after.nick:
        embed = make_embed("🏷️ 닉네임 변경", discord.Color.blue(), after)
        embed.add_field(name="변경 전", value=before.nick or "(없음)", inline=True)
        embed.add_field(name="변경 후", value=after.nick or "(없음)", inline=True)
        await send_log(after.guild, embed)

    added = [r for r in after.roles if r not in before.roles]
    removed = [r for r in before.roles if r not in after.roles]
    if added or removed:
        embed = make_embed("🎭 역할 변경", discord.Color.blurple(), after)
        if added:
            embed.add_field(name="➕ 추가", value=" ".join(r.mention for r in added), inline=False)
        if removed:
            embed.add_field(name="➖ 제거", value=" ".join(r.mention for r in removed), inline=False)
        await send_log(after.guild, embed)

MOD_ACTIONS = {
    discord.AuditLogAction.kick: ("👢 추방(Kick)", discord.Color.dark_orange()),
    discord.AuditLogAction.ban: ("🔨 차단(Ban)", discord.Color.dark_red()),
    discord.AuditLogAction.unban: ("🕊️ 차단 해제(Unban)", discord.Color.teal()),
}


@bot.event
async def on_audit_log_entry_create(entry: discord.AuditLogEntry):
    if entry.action not in MOD_ACTIONS:
        return
    title, color = MOD_ACTIONS[entry.action]
    embed = make_embed(title, color, entry.user)
    target = entry.target
    embed.add_field(name="대상", value=f"{target} (<@{target.id}>)" if target else "(알 수 없음)", inline=True)
    embed.add_field(name="실행자", value=entry.user.mention if entry.user else "(알 수 없음)", inline=True)
    embed.add_field(name="사유", value=entry.reason or "(사유 없음)", inline=False)
    await send_log(entry.guild, embed)

@bot.event
async def on_guild_channel_create(channel: discord.abc.GuildChannel):
    embed = make_embed("📁 채널 생성", discord.Color.green())
    embed.add_field(name="채널", value=f"{channel.mention} (`{channel.name}`)", inline=True)
    embed.add_field(name="종류", value=str(channel.type), inline=True)
    await send_log(channel.guild, embed)


@bot.event
async def on_guild_channel_delete(channel: discord.abc.GuildChannel):
    embed = make_embed("🗂️ 채널 삭제", discord.Color.red())
    embed.add_field(name="채널", value=f"`{channel.name}`", inline=True)
    embed.add_field(name="종류", value=str(channel.type), inline=True)
    await send_log(channel.guild, embed)


@bot.tree.command(name="로그설정", description="[관리자] 서버 로그를 보낼 채널을 정해요")
@app_commands.describe(채널="로그가 쌓일 텍스트 채널")
@app_commands.checks.has_permissions(administrator=True)
async def set_log(interaction: discord.Interaction, 채널: discord.TextChannel):
    me = interaction.guild.me
    perms = 채널.permissions_for(me)
    if not (perms.send_messages and perms.embed_links):
        return await interaction.response.send_message(
            f"❌ {채널.mention}에 **메시지 보내기·링크 첨부** 권한이 없어요.", ephemeral=True)
    async with lock:
        log_channels[str(interaction.guild.id)] = 채널.id
        save()
    await interaction.response.send_message(f"✅ 이제 서버 로그를 {채널.mention}에 기록할게요!", ephemeral=True)
    await 채널.send(embed=make_embed("🟢 로그 채널로 설정됐어요", discord.Color.green(), interaction.user))


@bot.tree.command(name="로그해제", description="[관리자] 서버 로그 기록을 멈춰요")
@app_commands.checks.has_permissions(administrator=True)
async def unset_log(interaction: discord.Interaction):
    async with lock:
        log_channels.pop(str(interaction.guild.id), None)
        save()
    await interaction.response.send_message("⏹️ 로그 기록을 껐어요.", ephemeral=True)


@bot.tree.error
async def on_app_command_error(interaction: discord.Interaction, error: app_commands.AppCommandError):
    if isinstance(error, app_commands.MissingPermissions):
        await interaction.response.send_message("❌ 관리자만 쓸 수 있는 명령어예요.", ephemeral=True)
    else:
        raise error


@bot.event
async def on_ready():
    load()
    await bot.tree.sync()
    print(f"✅ 로그인: {bot.user} / 로그 설정된 서버 {len(log_channels)}개")


bot.run(token)

discord.AuditLogAction.member_update: ("⏳ 타임아웃/닉네임 변경", discord.Color.gold()),
discord.AuditLogAction.role_create: ("🎨 역할 생성", discord.Color.green()),
discord.AuditLogAction.role_delete: ("🎨 역할 삭제", discord.Color.red()),
discord.AuditLogAction.message_bulk_delete: ("🧹 대량 삭제 (관리자)", discord.Color.dark_red()),