ホーム › 使い方ガイド › discord.py で NG ワード削除・スパム対策・タイムアウトを作る方法
GUIDE

discord.py で NG ワード削除・スパム対策・タイムアウトを作る方法

サーバーが大きくなると、荒らしやスパム、不適切な発言への対応が欠かせなくなります。このページでは、discord.py で NG ワードを含むメッセージの自動削除、連投スパムの検知、タイムアウト(一時的な発言禁止)を作る方法と、Discord 標準の AutoMod との使い分けを説明します。

準備

  • メッセージの中身を読むため、Message Content Intent をオンにします(「設定方法」)。
  • Bot に「メッセージの管理」「メンバーをタイムアウト」の権限を付けます。
  • Bot のロールを、対象のメンバーのロールより上に置きます。

NG ワードを自動で削除する

import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix="!", intents=intents)

NG_WORDS = ["NGワード1", "NGワード2", "discord.gg/"]

@bot.event
async def on_message(message: discord.Message):
    if message.author.bot or message.guild is None:
        return
    if message.author.guild_permissions.manage_messages:
        return await bot.process_commands(message)  # スタッフは対象外

    text = message.content.lower()
    if any(w.lower() in text for w in NG_WORDS):
        await message.delete()
        await message.channel.send(f"{message.author.mention} 禁止されている言葉が含まれていたため削除しました。", delete_after=5)
        return

    await bot.process_commands(message)
on_message を自分で書くと、プレフィックスコマンド(! で始まるコマンド)が動かなくなります。最後に await bot.process_commands(message) を必ず入れましょう。

連投スパムを検知する

import time
from collections import defaultdict, deque

history = defaultdict(lambda: deque(maxlen=5))  # ユーザーごとの直近5件の時刻

async def check_spam(message: discord.Message) -> bool:
    q = history[(message.guild.id, message.author.id)]
    q.append(time.monotonic())
    # 5件を4秒以内に送ったらスパムとみなす
    return len(q) == 5 and q[-1] - q[0] < 4

on_message の中で if await check_spam(message): として、下のタイムアウトと組み合わせます。

タイムアウトする

import datetime

async def punish(message: discord.Message, minutes: int, reason: str):
    try:
        await message.author.timeout(datetime.timedelta(minutes=minutes), reason=reason)
        await message.channel.send(f"{message.author.mention} を {minutes} 分間タイムアウトしました({reason})")
    except discord.Forbidden:
        print("タイムアウトする権限がありません")

タイムアウト中のメンバーは、発言・リアクション・ボイスへの参加ができなくなります。最大28日まで指定できます。

スタッフ用のタイムアウトコマンド

from discord import app_commands

@bot.tree.command(name="timeout", description="メンバーをタイムアウトします")
@app_commands.default_permissions(moderate_members=True)
async def timeout_cmd(interaction: discord.Interaction, member: discord.Member, minutes: app_commands.Range[int, 1, 40320], reason: str = "なし"):
    await member.timeout(datetime.timedelta(minutes=minutes), reason=reason)
    await interaction.response.send_message(f"{member.mention} を {minutes} 分間タイムアウトしました。理由:{reason}")

default_permissions を付けると、その権限を持つ人にだけコマンドが表示されます。

Discord 標準の AutoMod との使い分け

Discord の AutoMod自作 Bot
設定サーバー設定からすぐ使えるコードを書く必要がある
Bot の停止影響なしBot が止まると機能しない
自由度NG ワード・スパム・メンションの数など決まった項目独自のルール・警告回数の記録・ログ送信など自由

基本の NG ワードは AutoMod に任せ、警告回数に応じた処罰や独自のログなど、AutoMod でできない部分を Bot で補うのがおすすめです。警告回数を残すには「SQLite でデータを保存する方法」が使えます。

まとめ

  • on_message で NG ワードを検知して message.delete()
  • 直近の投稿時刻を記録して連投を検知し、member.timeout() で発言を止める
  • 荒らし対策は Bot が止まると無力。24時間稼働のサーバーで動かす

Discord Bot を、月 ¥180 で24時間。

支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

Discord Bot のステータス(プレイ中・視聴中)を表示・変更する方法discord.py で Bot の「○○をプレイ中」などのステータスを設定する方法、オンライン状態の変え方、導入サーバー数を表示して定期的に切り替える方法を解説します。読む → Discord Bot がメッセージを読めない?Message Content Intent の設定方法コマンドに反応しない・message.content が空になる原因は Message Content Intent。Discord Developer Portal とコード(discord.py)の両方で有効にする手順を解説します。読む → Discord Bot を24時間動かす方法|PCを閉じても止まらないPC を閉じると止まってしまう Discord Bot を、24時間動かし続ける方法を解説。自分の PC・無料ホスティング・Bot 用サーバーの違いと、月額 ¥180 から始められる手順を紹介します。読む → Python で作った Discord Bot をサーバーで動かす手順discord.py などで作った Bot を、main.py と requirements.txt を置くだけでサーバーで動かす手順を解説。トークンの安全な置き方や、よくあるエラーの対処も紹介します。読む → Discord Bot が勝手に止まる・落ちる原因と対処法Discord Bot がいつの間にかオフラインになる原因を、PC・回線・プログラムのエラー・メモリ不足・レート制限・トークンの順に解説。ログの見方と、止まりにくくする対策を紹介します。読む → 無料の Discord Bot ホスティングと有料の違い|どっちを選ぶ?無料ホスティングによくある制限(スリープ・稼働時間の上限・リソース不足)と、有料ホスティングとの違いを比較。用途別にどちらを選べばよいかの目安を紹介します。読む →