Discord.py 机器人:自定义欢迎消息与用户头像显示教程

DDD
发布: 2025-11-21 10:40:05
原创
711人浏览过

Discord.py 机器人:自定义欢迎消息与用户头像显示教程

本教程详细指导如何使用 discord.py 库为您的 discord 机器人创建自定义欢迎消息。内容涵盖 `on_member_join` 事件处理、构建包含用户头像缩略图和随机本地图片的嵌入式消息(embed),并解决常见的 `attributeerror`。同时,文章还将提供完整的代码示例和重要注意事项,帮助开发者高效实现新成员加入通知功能。

引言:构建 Discord 机器人欢迎功能

在 Discord 机器人开发中,为新加入服务器的成员发送欢迎消息是一个常见且实用的功能,可以提升用户体验并引导新成员快速融入社区。本教程将深入探讨如何利用 Discord.py 库的 on_member_join 事件,结合嵌入式消息(Embed)来创建美观且信息丰富的欢迎通知,包括显示用户头像和随机图片。

核心事件:on_member_join

当有新成员加入服务器时,Discord.py 库会触发 on_member_join 异步事件。您需要在机器人代码中定义一个异步函数来处理此事件。该函数会接收一个 discord.Member 对象作为参数,其中包含了新成员的所有相关信息。

import discord
import os
import random

# 假设 bot 已经初始化并正确设置了 Intents
# intents = discord.Intents.default()
# intents.members = True # 必须启用 members Intent 才能接收 on_member_join 事件
# bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event
async def on_member_join(member):
    # 打印新成员信息,便于调试
    print(f'新成员加入: 用户名: {member.name}, ID: ({member.id})')

    # 定义欢迎频道 ID
    welcome_channel_id = 1190887440433557544 # 替换为您的欢迎频道ID
    welcome_channel = member.guild.get_channel(welcome_channel_id)

    if not welcome_channel:
        print('欢迎频道未找到,请检查ID是否正确。')
        return

    # 进一步的逻辑将在这里实现,例如构建和发送 Embed 消息
    # ...
登录后复制

重要提示: 为了让机器人能够接收到 on_member_join 事件,您必须在初始化机器人时启用 Intents.members。否则,机器人将无法感知成员加入事件。

构建欢迎嵌入式消息 (Embed)

嵌入式消息(Embed)是 Discord 中一种强大的信息展示方式,它允许您创建结构化、视觉吸引力强的消息。

1. 初始化 Embed

    embed = discord.Embed(
        title=f'欢迎来到服务器,{member.name}!',
        description='我们很高兴您的加入。\n希望您能在这里找到乐趣。',
        color=0x3498db # 设置 Embed 的颜色
    )
登录后复制

2. 添加信息字段

您可以使用 embed.add_field() 方法添加额外的标题和内容区域,例如服务器规则或下一步指南。

    embed.add_field(name='服务器规则', value='请严格遵守规则频道中提及的规定。', inline=False)
    embed.add_field(name='下一步做什么', value='示例 1, \n示例 2, \n示例 3', inline=False)
登录后复制

3. 设置用户头像缩略图

这是本教程的重点之一。许多开发者在尝试获取用户头像 URL 时会遇到 AttributeError。常见的错误尝试包括 member.user.avatar_url 或 member.avatar_url。

DeepBrain
DeepBrain

AI视频生成工具,ChatGPT +生成式视频AI =你可以制作伟大的视频!

DeepBrain 94
查看详情 DeepBrain

问题原因:discord.Member 对象本身并没有 user 或 avatar_url 属性。它有一个 avatar 属性,这个 avatar 属性是一个 discord.Asset 对象,而 discord.Asset 对象才拥有 url 属性。

正确做法: 要获取成员的头像 URL,您应该访问 member.avatar.url。

    # 正确设置用户头像为 Embed 缩略图
    if member.avatar: # 检查成员是否有自定义头像
        embed.set_thumbnail(url=member.avatar.url)
    else:
        # 如果成员没有自定义头像,可以使用默认头像
        # Discord.py 默认头像的获取方式可能因版本而异,这里提供一种常见方式
        # 例如:embed.set_thumbnail(url=member.default_avatar.url)
        # 或者直接不设置缩略图
        print(f'{member.name} 没有自定义头像。')
登录后复制

4. 嵌入随机本地图片

除了用户头像,您还可以从本地文件夹中随机选择一张图片并将其嵌入到欢迎消息中。

    images_folder = r'Z:\Spooks [Discord Bot]\Images' # 替换为您的图片文件夹路径
    image_files = [f for f in os.listdir(images_folder) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp', '.webp'))]

    if not image_files:
        print('图片文件夹中未找到有效图片。')
        # 如果没有图片,可以选择不设置图片或使用默认图片
    else:
        random_image_file = random.choice(image_files)
        image_path = os.path.join(images_folder, random_image_file)

        # 设置 Embed 的图片。注意,这里使用 attachment:// 前缀
        # 告诉 Discord 这张图片将作为附件发送
        embed.set_image(url=f'attachment://{random_image_file}')

        # 创建 discord.File 对象,用于将本地图片作为附件发送
        file = discord.File(image_path, filename=random_image_file)

        # 发送消息时需要同时传入 embed 和 file
        await welcome_channel.send(embed=embed, file=file)
登录后复制

关于图片尺寸:embed.set_image() 方法会显示您提供的图片。如果您希望图片显示为矩形,那么源图片本身就必须是矩形。Discord 的 Embed 系统不会强制将矩形图片裁剪或拉伸为正方形,它会尽可能保持图片的原始宽高比。如果您的图片目前显示为正方形(如 320x320),那是因为您的源文件就是正方形。要显示矩形图片,请提供矩形尺寸的图片文件。

完整示例代码

将上述所有部分整合,构成一个完整的 on_member_join 事件处理器

import discord
from discord.ext import commands
import os
import random

# 机器人初始化,务必启用 intents.members
intents = discord.Intents.default()
intents.members = True # 必须启用
bot = commands.Bot(command_prefix='!', intents=intents)

@bot.event
async def on_ready():
    print(f'{bot.user} 已上线!')

@bot.event
async def on_member_join(member):
    print(f'新成员加入: 用户名: {member.name}, ID: ({member.id})')

    # 替换为您的欢迎频道 ID
    welcome_channel_id = 1190887440433557544 
    welcome_channel = member.guild.get_channel(welcome_channel_id)

    if not welcome_channel:
        print('欢迎频道未找到,请检查ID是否正确。')
        return

    # 初始化 Embed 消息
    embed = discord.Embed(
        title=f'欢迎来到服务器,{member.name}!',
        description='我们很高兴您的加入。\n希望您能在这里找到乐趣。',
        color=0x3498db # 蓝色
    )

    # 添加信息字段
    embed.add_field(name='服务器规则', value='请严格遵守规则频道中提及的规定。', inline=False)
    embed.add_field(name='下一步做什么', value='示例 1, \n示例 2, \n示例 3', inline=False)

    # 设置用户头像缩略图
    if member.avatar: # 检查成员是否有自定义头像
        embed.set_thumbnail(url=member.avatar.url)
    else:
        print(f'{member.name} 没有自定义头像。')
        # 可以选择使用默认头像或不设置缩略图

    # 处理本地随机图片
    images_folder = r'Z:\Spooks [Discord Bot]\Images' # 替换为您的图片文件夹路径
    file_to_send = None # 初始化为 None

    if os.path.exists(images_folder) and os.path.isdir(images_folder):
        image_files = [f for f in os.listdir(images_folder) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.bmp', '.webp'))]

        if not image_files:
            print('图片文件夹中未找到有效图片。')
        else:
            random_image_file = random.choice(image_files)
            image_path = os.path.join(images_folder, random_image_file)

            # 设置 Embed 的图片,使用 attachment:// 前缀
            embed.set_image(url=f'attachment://{random_image_file}')

            # 创建 discord.File 对象
            file_to_send = discord.File(image_path, filename=random_image_file)
    else:
        print(f"图片文件夹路径 '{images_folder}' 不存在或不是一个目录。")


    # 发送欢迎消息
    try:
        if file_to_send:
            await welcome_channel.send(embed=embed, file=file_to_send)
        else:
            await welcome_channel.send(embed=embed)
        print(f'已向 {member.name} 发送欢迎消息。')
    except discord.Forbidden:
        print(f'机器人没有权限在 {welcome_channel.name} 频道发送消息。')
    except Exception as e:
        print(f'发送欢迎消息时发生错误: {e}')


# 运行机器人 (替换为您的机器人 Token)
# bot.run('YOUR_BOT_TOKEN')
登录后复制

注意事项与最佳实践

  1. 启用 Intents.members: 这是接收 on_member_join 事件的关键。在 Discord 开发者门户中,您可能还需要在 Bot 设置页面启用 "PRESENCE INTENT" 和 "SERVER MEMBERS INTENT"。
  2. 频道 ID 准确性: 确保 welcome_channel_id 是正确的,并且机器人有权限在该频道发送消息。
  3. 图片路径处理:
    • images_folder 应指向您的图片文件夹的绝对路径或相对于机器人脚本的相对路径。
    • 在部署机器人时,请确保图片文件夹在服务器上是可访问的。
  4. 错误处理:
    • 始终检查 welcome_channel 是否成功获取,以及图片文件夹中是否有图片。
    • 添加 try-except 块来捕获发送消息时可能出现的权限错误或其他异常。
  5. 异步编程: Discord.py 是一个异步库。所有与 Discord API 交互的操作都应该是 awaitable 的。
  6. Embed 限制: Discord 对 Embed 的大小和字段数量有一定限制。避免创建过大或字段过多的 Embed。

总结

通过本教程,您应该已经掌握了如何使用 Discord.py 创建一个功能完善的机器人欢迎系统。这包括正确处理 on_member_join 事件,构建包含用户头像和本地图片的嵌入式消息,并解决了常见的 AttributeError。遵循这些指南和最佳实践,您的 Discord 机器人将能提供更友好、更专业的欢迎体验。

以上就是Discord.py 机器人:自定义欢迎消息与用户头像显示教程的详细内容,更多请关注php中文网其它相关文章!

相关标签:
最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号