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 ホスティングと有料の違い|どっちを選ぶ?無料ホスティングによくある制限(スリープ・稼働時間の上限・リソース不足)と、有料ホスティングとの違いを比較。用途別にどちらを選べばよいかの目安を紹介します。読む →