💨
discord.py 入門 その4
おさらい
前回はチャンネルのメッセージを記録する機能の実装方法について解説しました。今回はメンバーをミュートさせる機能を実装していきます。
Step5. メンバーをミュートしよう
ミュートの実装方法ですが、以下の要素があれば実装できそうです。
- コマンドでミュートしたい人に「チャット制限」というロールを付与する。
- メッセージリスナーを登録し、チャット制限ロールを持っている人がメッセージを送信したら削除する。
このままだと、bot稼働時にミュートされると解除する術がないので、ミュート解除コマンドも後ほど実装します。
チャット制限ロールの付与
以下のコードを実装します。
from discord.utils import get # 新しく追加
# 省略
@bot.command(name="mute")
async def mute(ctx: commands.Context, member: discord.Member) -> None:
if (role := get(member.roles, name="チャット制限")) is None: # ロールがサーバーに存在しない場合
# ロールを作成
role = await ctx.guild.create_role(
name="チャット制限", # ロール名
mentionable=True # メンションできるようにする
)
await member.add_roles(role) # メンバーにロールを付与
await ctx.send(f"{member.mention} をチャット制限しました。")
以下のようになれば成功です。プロフィールに「チャット制限」というロールが追加されていることを確認してください。ここで少し補足。discord.utilsからインポートしたget関数は、リストから条件に合う要素を取得する関数です。今回はメンバーのロールリストからチャット制限という名前のロールを取得しています。詳しくはこちら。
チャット制限の実装
次に、メッセージをチャット制限の人が送信したら削除する処理を実装します。
イベントリスナーの場合、チャット制限が掛かっている人もコマンドを実行できてしまうので、イベントハンドラとして実装します。
@bot.event
async def on_message(message: discord.Message) -> None:
if message.author.bot: # botからのメッセージは無視
return
# チャット制限ロールをメッセージ送信者が持っているか確認
role = get(message.author.roles, name="チャット制限")
if role is not None:
await message.delete() # メッセージを削除
return # ミュートされている場合はコマンドを実行しない
await bot.process_commands(message) # コマンドを実行
チャット制限されている人はコマンドも実行できなくなることに注意してください。
まとめ
今回はチャット制限の機能を実装しました。しかし、このままだとサーバーの管理者以外の人も他人をミュートできてしまったり、ミュートを解除することができないままです。次回はミュートの解除機能と、ミュートの権限を管理者のみにする機能を実装していきます。
次回ともよろしくお願いします。お疲れ様でした。
Discussion