如何让Bot加入服务器时自动为自身分配专属角色

原理说明 #

你观察到的两种自动获取角色的情况对应两种不同的实现逻辑：

1. 带Bot标签的同名默认角色是Discord官方原生行为，所有在Discord开发者平台注册的正规Bot加入服务器时，系统都会自动分配该角色，无需额外开发，角色默认权限对应你邀请Bot时勾选的权限集合。
2. MEE6这类Bot额外携带的定制专属角色，是Bot自身通过代码逻辑实现的功能，具体实现方法如下。

实现前提 #

Bot邀请入服时必须勾选Manage Roles（管理角色）权限，且Bot的默认角色在服务器角色列表中的排序，要高于你要创建/分配的专属角色，否则会触发权限不足错误。

核心实现步骤 #

• 监听GuildCreate事件，该事件会在Bot成功加入新服务器时触发，返回对应服务器的实例对象
• 遍历服务器现有角色，判断是否已存在目标专属角色，避免重复创建
• 若角色不存在，调用服务器角色创建接口，自定义角色的名称、配色、权限、是否在成员列表单独展示等属性
• 若角色已存在，直接获取对应角色实例
• 调用成员角色分配接口，将目标角色绑定到Bot自身在当前服务器的成员实例上

代码示例（discord.js v14） #

client.on('guildCreate', async (guild) => {
  // 获取Bot自身在当前服务器的成员对象
  const botSelf = guild.members.me;
  // 匹配现有专属角色
  let customRole = guild.roles.cache.find(role => role.name === '我的Bot专属角色');
  
  // 不存在则创建新角色
  if (!customRole) {
    customRole = await guild.roles.create({
      name: '我的Bot专属角色',
      color: '#5865F2',
      permissions: [], // 按需配置角色权限
      hoist: true, // 设置为true可在成员列表单独展示该角色分组
      position: botSelf.roles.highest.position - 1, // 排序仅低于Bot默认角色，避免权限冲突
      reason: '创建Bot专属角色'
    });
  }

  // 为自身分配角色
  await botSelf.roles.add(customRole);
});

注意事项 #

• 自定义角色的权限不能超过Bot自身拥有的权限，否则超出的权限不会生效
• 如果仅需要自动分配服务器已有的指定角色，跳过创建角色的步骤，直接匹配对应角色分配即可

内容的提问来源于stack exchange，提问作者Zwiebelmilch