用 discord.py 制作可开关的回声机器人

本文将指导你如何使用 discord.py 库创建一个回声机器人。该机器人可以通过 k!echo 命令启动，开始重复用户发送的消息，直到用户再次输入 k!echo 命令停止。文章将提供完整的代码示例，并解释关键部分的实现逻辑，包括如何使用全局变量控制机器人的开关状态，以及如何处理超时情况。

创建一个可开关的回声机器人

以下代码展示了如何使用 discord.py 创建一个通过命令控制开关的回声机器人。

import discord
from discord.ext import commands
import asyncio

# 替换为你的机器人 token
TOKEN = 'YOUR_BOT_TOKEN'

intents = discord.Intents.default()
intents.message_content = True

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

boolean = False

@bot.event
async def on_message(message: discord.Message):
    global boolean
    if message.author == bot.user:
        return

    if boolean:
        if message.author.bot:
            return
        if message.content == "k!echo":
            boolean = False
            await message.channel.send("Echo mode stopped.")
            return
        if isinstance(message.channel, discord.TextChannel):
            await message.channel.send(message.content)
    else:
        await bot.process_commands(message)

@bot.command(name="echo")
async def echo(ctx):
    global boolean
    boolean = True
    channel = ctx.channel
    await ctx.send('Bot will start echoing. Type "k!echo" to stop.')

bot.run(TOKEN)

代码解释

1. 导入必要的库:
   • discord: discord.py 库的核心模块。
   • discord.ext.commands: 用于创建命令的扩展。
   • asyncio: 用于异步操作。
2. 初始化机器人:
   • TOKEN = 'YOUR_BOT_TOKEN'：将 'YOUR_BOT_TOKEN' 替换为你的机器人的 token。
   • intents = discord.Intents.default()：设置机器人需要的权限。
   • intents.message_content = True：启用消息内容权限，这是读取消息内容所必需的。
   • bot = commands.Bot(command_prefix='k!', intents=intents)：创建一个机器人实例，并设置命令前缀为 k!。
3. boolean 全局变量:
   • boolean = False: 定义一个全局变量 boolean，用于控制回声功能的开关状态。初始值为 False，表示回声功能关闭。
4. on_message 事件:
   • @bot.event\nasync def on_message(message: discord.Message): 定义一个事件监听器，当机器人接收到任何消息时都会触发。
   • if message.author == bot.user: return：忽略机器人自身发送的消息，避免无限循环。
   • if boolean:：判断 boolean 是否为 True，如果是，则执行回声逻辑。
   • if message.author.bot: return: 忽略来自其他机器人的消息。
   • if message.content == "k!echo":: 如果用户发送的消息是 k!echo，则将 boolean 设置为 False，停止回声功能。
   • await message.channel.send(message.content): 将用户发送的消息发送到相同的频道。
   • else: await bot.process_commands(message): 如果boolean为False，则让机器人处理其他命令。
5. echo 命令:
   • @bot.command(name="echo")\nasync def echo(ctx): 定义一个名为 echo 的命令。
   • boolean = True: 将 boolean 设置为 True，启动回声功能。
   • await ctx.send('Bot will start echoing. Type "k!echo" to stop.'): 发送一条消息通知用户回声功能已启动。
6. 启动机器人:
   • bot.run(TOKEN): 使用你的机器人 token 启动机器人。

运行步骤

1. 确保你已经安装了 discord.py 库：pip install discord.py。
2. 将代码中的 YOUR_BOT_TOKEN 替换为你的机器人 token。
3. 运行 Python 脚本。
4. 邀请你的机器人到你的 Discord 服务器。
5. 在 Discord 频道中输入 k!echo 命令启动回声功能。
6. 再次输入 k!echo 命令停止回声功能。

注意事项

• 权限: 确保你的机器人拥有读取和发送消息的权限。
• Token 安全: 不要将你的机器人 token 泄露给他人。
• 错误处理: 在生产环境中，建议添加适当的错误处理机制，例如捕获 discord.errors.HTTPException 异常。
• 命令前缀: 可以根据需要修改命令前缀。
• 全局变量: 尽量避免过度使用全局变量，可以考虑使用类来封装状态。
• 并发安全: 如果你的机器人需要处理大量并发请求，请注意线程安全问题。

总结

本文提供了一个简单的回声机器人的实现示例，展示了如何使用 discord.py 库创建命令，以及如何使用全局变量控制机器人的状态。你可以根据这个示例进行扩展，例如添加更多的命令、自定义回声行为等。记住要关注机器人的性能和安全性，并进行适当的错误处理。