Discordボット開発#12コマンドのクールダウン(Cooldown)・権限(Permission)を管理しよう！ (Pythonサンプル付き)

pip install -U discord.py

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

import discord
from discord import app_commands
from discord.ext import commands

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

@bot.tree.command(name="출석", description="1日1回の出席チェック！")
@app_commands.checks.cooldown(1, 60.0, key=lambda i: (i.guild_id, i.user.id))
async def attend(interaction: discord.Interaction):
    await interaction.response.send_message(
        f"{interaction.user.mention}さん、出席が完了しました！ ✅"
    )

@attend.error
async def attend_error(interaction: discord.Interaction, error: app_commands.AppCommandError):
    if isinstance(error, app_commands.CommandOnCooldown):
        await interaction.response.send_message(
            f"⏳ 早すぎます！ **{error.retry_after:.1f}秒** 後にもう一度お試しください。",
            ephemeral=True,
        )

@bot.tree.command(name="청소", description="チャンネルのメッセージをまとめて削除します")
@app_commands.describe(amount="削除するメッセージの数 (1~100)")
@app_commands.default_permissions(manage_messages=True)
@app_commands.checks.has_permissions(manage_messages=True)
@app_commands.checks.bot_has_permissions(manage_messages=True)
@app_commands.guild_only()
async def clean(interaction: discord.Interaction, amount: app_commands.Range[int, 1, 100]):
    await interaction.response.defer(ephemeral=True)
    deleted = await interaction.channel.purge(limit=amount)
    await interaction.followup.send(f"🧹 メッセージを{len(deleted)}件削除しました！", ephemeral=True)

@bot.tree.command(name="공지", description="サーバーにお知らせを送ります")
@app_commands.describe(message="お知らせの内容")
@app_commands.checks.has_any_role("관리자", "운영진")
@app_commands.guild_only()
async def notice(interaction: discord.Interaction, message: str):
    embed = discord.Embed(title="📢 お知らせ", description=message, color=0x5865F2)
    embed.set_footer(text=f"投稿者: {interaction.user.display_name}")
    await interaction.response.send_message(embed=embed)

@app_commands.checks.has_any_role(123456789012345678, 987654321098765432)

from typing import Optional

VIP_ROLE_ID = 123456789012345678  # クールタイム免除ロールのID

def vip_cooldown(interaction: discord.Interaction) -> Optional[app_commands.Cooldown]:
    user = interaction.user
    if isinstance(user, discord.Member) and user.get_role(VIP_ROLE_ID):
        return None                          # Noneを返すとクールタイムなし！
    return app_commands.Cooldown(1, 30.0)    # 一般ユーザーは30秒に1回

@bot.tree.command(name="뽑기", description="ランダムくじを引きます")
@app_commands.checks.dynamic_cooldown(vip_cooldown, key=lambda i: (i.guild_id, i.user.id))
async def draw(interaction: discord.Interaction):
    await interaction.response.send_message(f"🎲 結果: **{random.randint(1, 100)}点**!")

# discord.py 2.7.1 / Python 3.8+
import random
import traceback
from typing import Optional

import discord
from discord import app_commands
from discord.ext import commands

TOKEN = "ここにボットトークンを入れてください"
VIP_ROLE_ID = 123456789012345678  # クールタイム免除ロールのID

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

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ ログイン完了: {bot.user}")

# ── 1) クールダウン: サーバー別・ユーザー別に60秒に1回 ──────────────────────
@bot.tree.command(name="출석", description="1日1回の出席チェック！")
@app_commands.checks.cooldown(1, 60.0, key=lambda i: (i.guild_id, i.user.id))
async def attend(interaction: discord.Interaction):
    await interaction.response.send_message(
        f"{interaction.user.mention}さん、出席が完了しました！ ✅"
    )

# ── 2) 権限チェック: メッセージの管理権限を持つ人だけ ──────────────────
@bot.tree.command(name="청소", description="チャンネルのメッセージをまとめて削除します")
@app_commands.describe(amount="削除するメッセージの数 (1~100)")
@app_commands.default_permissions(manage_messages=True)
@app_commands.checks.has_permissions(manage_messages=True)
@app_commands.checks.bot_has_permissions(manage_messages=True)
@app_commands.guild_only()
async def clean(interaction: discord.Interaction, amount: app_commands.Range[int, 1, 100]):
    await interaction.response.defer(ephemeral=True)
    deleted = await interaction.channel.purge(limit=amount)
    await interaction.followup.send(f"🧹 メッセージを{len(deleted)}件削除しました！", ephemeral=True)

# ── 3) ロールチェック: '관리자'(管理者)または'운영진'(運営スタッフ)だけ ───────────────────
@bot.tree.command(name="공지", description="サーバーにお知らせを送ります")
@app_commands.describe(message="お知らせの内容")
@app_commands.checks.has_any_role("관리자", "운영진")
@app_commands.guild_only()
async def notice(interaction: discord.Interaction, message: str):
    embed = discord.Embed(title="📢 お知らせ", description=message, color=0x5865F2)
    embed.set_footer(text=f"投稿者: {interaction.user.display_name}")
    await interaction.response.send_message(embed=embed)

# ── 4) ボーナス: VIPはクールタイム免除 ────────────────────────────
def vip_cooldown(interaction: discord.Interaction) -> Optional[app_commands.Cooldown]:
    user = interaction.user
    if isinstance(user, discord.Member) and user.get_role(VIP_ROLE_ID):
        return None
    return app_commands.Cooldown(1, 30.0)

@bot.tree.command(name="뽑기", description="ランダムくじを引きます")
@app_commands.checks.dynamic_cooldown(vip_cooldown, key=lambda i: (i.guild_id, i.user.id))
async def draw(interaction: discord.Interaction):
    await interaction.response.send_message(f"🎲 結果: **{random.randint(1, 100)}点**!")

# ── 5) グローバルエラーハンドラー (全コマンド共通) ───────────────────
@bot.tree.error
async def on_app_command_error(interaction: discord.Interaction, error: app_commands.AppCommandError):
    if isinstance(error, app_commands.CommandOnCooldown):
        msg = f"⏳ 早すぎます！ **{error.retry_after:.1f}秒** 後にもう一度お試しください。"
    elif isinstance(error, app_commands.MissingPermissions):
        msg = "🚫 このコマンドを使う権限がありません。"
    elif isinstance(error, app_commands.BotMissingPermissions):
        msg = "🤖 ボットに権限がありません！サーバー設定 → ロールでボットの権限を確認してください。"
    elif isinstance(error, app_commands.MissingAnyRole):
        msg = "🎭 このコマンドには管理者・運営スタッフのロールが必要です。"
    elif isinstance(error, app_commands.CheckFailure):
        msg = "❌ 実行条件を満たしていません。"
    else:
        msg = "⚠️ 不明なエラーが発生しました。しばらくしてからもう一度お試しください。"
        traceback.print_exception(type(error), error, error.__traceback__)

    if interaction.response.is_done():
        await interaction.followup.send(msg, ephemeral=True)
    else:
        await interaction.response.send_message(msg, ephemeral=True)

bot.run(TOKEN)