디스코드 봇 만들기#21키워드 자동응답·금지어 필터 만들기! 경고 누적으로 자동 제재까지 (파이썬 예제)

pip install -U discord.py python-dotenv

python -c "import discord; print(discord.__version__)"

DISCORD_TOKEN=여기에_봇_토큰_붙여넣기
AUTOMOD_LOG_CHANNEL_ID=제재_기록을_남길_채널_ID
AUTOMOD_WARN_LIMIT=3
AUTOMOD_MUTE_MINUTES=10

intents.message_content = True    # ← 오늘 주인공!

@commands.Cog.listener()
async def on_message(self, message: discord.Message):
    if self.is_exempt(message):
        return
    ...

def is_exempt(self, message: discord.Message) -> bool:
    if message.author.bot or message.webhook_id:
        return True
    if not isinstance(message.author, discord.Member):
        return True
    return message.author.guild_permissions.manage_messages

import re

AUTO_REPLIES = {
    r"공지|공지사항": "📢 공지는 <#000000000000000000> 채널을 확인해주세요!",
    r"봇\s*명령어|명령어\s*목록": "🤖 `/도움말` 을 입력하면 명령어 목록이 나와요!",
    r"안녕|하이|ㅎㅇ": "👋 안녕하세요! 반가워요~",
}

COMPILED_REPLIES = [
    (re.compile(pattern, re.IGNORECASE), reply)
    for pattern, reply in AUTO_REPLIES.items()
]

바 보
바.보
바_보
바ㅡ보

import unicodedata

NOISE = re.compile(r"[\s._\-*~`|^]+")

def normalize(text: str) -> str:
    text = unicodedata.normalize("NFKC", text)
    return NOISE.sub("", text).lower()

async def punish(self, message: discord.Message, matched: str) -> None:
    try:
        await message.delete()
    except discord.Forbidden:
        print("[AutoMod] 메시지 삭제 권한이 없어요!")
    except discord.NotFound:
        pass

    count = self.add_warn(message.guild.id, message.author.id)

    await message.channel.send(
        f"{message.author.mention} 🚫 사용할 수 없는 표현이에요. "
        f"경고 **{count}/{WARN_LIMIT}**회 누적됐어요.",
        delete_after=10,
    )

    if count >= WARN_LIMIT:
        await self.mute(message.author)

async def mute(self, member: discord.Member) -> None:
    try:
        await member.timeout(
            timedelta(minutes=MUTE_MINUTES), reason=f"금지어 경고 {WARN_LIMIT}회 누적"
        )
    except discord.Forbidden:
        print("[AutoMod] 타임아웃 권한(멤버 조절하기)이 없어요!")

# discord.py 2.x (2.7.1 기준) / Python 3.8+
# 디스코드 봇 만들기 #21 - 키워드 자동응답 · 금지어 필터

import json
import os
import re
import unicodedata
from datetime import timedelta
from pathlib import Path

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

load_dotenv()

def env_id(key: str) -> int:
    """.env 값이 비어 있어도 안 터지게 정수로 바꿔주는 헬퍼"""
    raw = (os.getenv(key) or "").strip()
    return int(raw) if raw.isdigit() else 0

LOG_CHANNEL_ID = env_id("AUTOMOD_LOG_CHANNEL_ID")
WARN_LIMIT = env_id("AUTOMOD_WARN_LIMIT") or 3
MUTE_MINUTES = env_id("AUTOMOD_MUTE_MINUTES") or 10

BRAND_COLOR = discord.Color.from_str("#5865F2")
WARN_FILE = Path("data/warns.json")

# 키워드 : 자동응답 문구
AUTO_REPLIES = {
    r"공지|공지사항": "📢 공지는 <#000000000000000000> 채널을 확인해주세요!",
    r"봇\s*명령어|명령어\s*목록": "🤖 `/도움말` 을 입력하면 명령어 목록이 나와요!",
    r"안녕|하이|ㅎㅇ": "👋 안녕하세요! 반가워요~",
}

# 금지어 (정규표현식). 실제 운영에서는 서버 성격에 맞게 채우세요
BANNED_PATTERNS = [
    r"바보",
    r"멍청이",
    r"discord\.gg/\w+",       # 초대 링크 광고
    r"https?://\S*(도박|토토)",
]

COMPILED_REPLIES = [
    (re.compile(pattern, re.IGNORECASE), reply) for pattern, reply in AUTO_REPLIES.items()
]
COMPILED_BANNED = [re.compile(pattern, re.IGNORECASE) for pattern in BANNED_PATTERNS]

# 우회 문자 제거용 (바 보 / 바.보 / 바-보 같은 꼼수 차단)
NOISE = re.compile(r"[\s._\-*~`|^]+")

def normalize(text: str) -> str:
    text = unicodedata.normalize("NFKC", text)
    return NOISE.sub("", text).lower()

class AutoMod(commands.Cog):
    """키워드 자동응답 · 금지어 필터 · 경고 누적"""

    def __init__(self, bot: commands.Bot):
        self.bot = bot
        self.warns = self.load_warns()

    # ---------- 경고 저장 (#14 JSON 편 방식) ----------
    def load_warns(self) -> dict:
        if WARN_FILE.exists():
            with WARN_FILE.open(encoding="utf-8") as f:
                return json.load(f)
        return {}

    def save_warns(self) -> None:
        WARN_FILE.parent.mkdir(parents=True, exist_ok=True)
        with WARN_FILE.open("w", encoding="utf-8") as f:
            json.dump(self.warns, f, ensure_ascii=False, indent=2)

    def add_warn(self, guild_id: int, user_id: int) -> int:
        key = f"{guild_id}:{user_id}"
        self.warns[key] = self.warns.get(key, 0) + 1
        self.save_warns()
        return self.warns[key]

    # ---------- 면제 대상 판별 ----------
    def is_exempt(self, message: discord.Message) -> bool:
        if message.author.bot or message.webhook_id:
            return True
        if not isinstance(message.author, discord.Member):
            return True
        return message.author.guild_permissions.manage_messages

    # ---------- 메인 리스너 ----------
    @commands.Cog.listener()
    async def on_message(self, message: discord.Message):
        if self.is_exempt(message):
            return

        cleaned = normalize(message.content)

        # ① 금지어 먼저
        for pattern in COMPILED_BANNED:
            if pattern.search(cleaned) or pattern.search(message.content):
                await self.punish(message, pattern.pattern)
                return

        # ② 자동응답
        for pattern, reply in COMPILED_REPLIES:
            if pattern.search(message.content):
                await message.channel.send(reply, reference=message, mention_author=False)
                return

    async def punish(self, message: discord.Message, matched: str) -> None:
        try:
            await message.delete()
        except discord.Forbidden:
            print("[AutoMod] 메시지 삭제 권한이 없어요!")
        except discord.NotFound:
            pass

        count = self.add_warn(message.guild.id, message.author.id)

        await message.channel.send(
            f"{message.author.mention} 🚫 사용할 수 없는 표현이에요. "
            f"경고 **{count}/{WARN_LIMIT}**회 누적됐어요.",
            delete_after=10,
        )

        if count >= WARN_LIMIT:
            await self.mute(message.author)

        await self.write_log(message, matched, count)

    async def mute(self, member: discord.Member) -> None:
        try:
            await member.timeout(
                timedelta(minutes=MUTE_MINUTES), reason=f"금지어 경고 {WARN_LIMIT}회 누적"
            )
        except discord.Forbidden:
            print("[AutoMod] 타임아웃 권한(멤버 조절하기)이 없어요!")

    async def write_log(self, message: discord.Message, matched: str, count: int) -> None:
        channel = message.guild.get_channel(LOG_CHANNEL_ID)
        if channel is None:
            return

        embed = discord.Embed(
            title="🚫 금지어 감지",
            description=f"```{message.content[:500]}```",
            color=discord.Color.red(),
            timestamp=discord.utils.utcnow(),
        )
        embed.add_field(name="작성자", value=message.author.mention, inline=True)
        embed.add_field(name="채널", value=message.channel.mention, inline=True)
        embed.add_field(name="누적 경고", value=f"{count}회", inline=True)
        embed.set_footer(text=f"패턴: {matched}")
        await channel.send(embed=embed)

    # ---------- 관리 명령어 ----------
    @app_commands.command(name="경고조회", description="멤버의 누적 경고 횟수를 확인해요")
    @app_commands.describe(멤버="확인할 멤버")
    async def check_warn(self, interaction: discord.Interaction, 멤버: discord.Member):
        count = self.warns.get(f"{interaction.guild_id}:{멤버.id}", 0)
        await interaction.response.send_message(
            f"**{멤버.display_name}** 님의 누적 경고는 **{count}회** 예요.", ephemeral=True
        )

    @app_commands.command(name="경고초기화", description="멤버의 경고를 0으로 되돌려요")
    @app_commands.checks.has_permissions(manage_messages=True)
    async def reset_warn(self, interaction: discord.Interaction, 멤버: discord.Member):
        self.warns.pop(f"{interaction.guild_id}:{멤버.id}", None)
        self.save_warns()
        await interaction.response.send_message(
            f"**{멤버.display_name}** 님의 경고를 초기화했어요 ✅", ephemeral=True
        )

    @reset_warn.error
    async def reset_warn_error(self, interaction: discord.Interaction, error):
        if isinstance(error, app_commands.MissingPermissions):
            await interaction.response.send_message(
                "이 명령어는 **메시지 관리** 권한이 있어야 쓸 수 있어요 🔒", ephemeral=True
            )

async def setup(bot: commands.Bot):
    await bot.add_cog(AutoMod(bot))

server-bot/
├─ .env
├─ .gitignore
├─ bot.py
├─ data/
│  └─ warns.json          # ← 자동 생성돼요
└─ cogs/
   ├─ admin.py
   ├─ poll.py             # #18 투표
   ├─ onboarding.py       # #20 환영·자동역할
   └─ automod.py          # ← 오늘 추가!

[Onboarding] 규칙 동의 패널 등록 완료!
✅ cogs.admin 불러옴
✅ cogs.automod 불러옴
✅ cogs.onboarding 불러옴
✅ cogs.poll 불러옴
MojangBot#1234 로그인 성공! (Cog 4개)

@테스터 🚫 사용할 수 없는 표현이에요. 경고 1/3회 누적됐어요.