如果命令处于冷却状态，如何使 discord.py 机器人发送特定消息

Question

I'm trying to make a discord.py bot have a command which a user can use only once an hour. I want the bot to send a message "The command is on cooldown" when someone uses the command more than once an hour. This is the code for the command:

bot = discord.Client()

@bot.event
@commands.cooldown(1, 3600, commands.BucketType.user)
async def on_message(message):
    await message.channel.send("hello")

bot.run("xxxxxxxxxxxx")

How do I achieve that?

Answer 1

1. If you want to create commands for your bot - you better use ext.commands extension part of the discord.py library. It prevents spaghetti code, gives better perfomance, it's easier to understand and there is command cooldown functionality, needed for your question and many more benefits. Thus I should send you to read docs for ext.commands or part of the library FAQ about it

2. Anyway, you already figured out that cooldowns are made with @commands.cooldown(1, 3600, commands.BucketType.user) but the way it works - it triggers error commands.CommandOnCooldown when user is on cooldown and thus we need to write error handler to catch that and send specific message as an answer. Again, link to read , gist . But in my example below I use local error handler for the !test command and if error is indeed of type commands.CommandOnCooldown - the bot will send "The command is on cooldown." as a response.

So MRE would look something like this.

import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.message_content = True  # dont forget to optin them on dev portal

bot = commands.Bot(
    command_prefix='!',
    intents=intents
)


@commands.cooldown(1, 60*60, commands.BucketType.user)
@bot.command()
async def test(ctx: commands.Context):
    await ctx.send("hello")


@test.error
async def test_error(ctx, error):
    if isinstance(error, commands.CommandOnCooldown):
        await ctx.send(f"The command is on cooldown.")


bot.run("xxxxxxxxxxxx")