Discord自动禁言机器人开发问题：无需移除角色实现禁言

最优方案：利用专属禁言角色+权限优先级 #

Discord权限系统遵循「拒绝权限优先于允许权限」规则，你完全不用移除用户原有角色，只需要创建一个自带全局拒绝权限的禁言角色，给违规用户添加该角色即可限制其聊天及功能使用，到期后移除角色就能恢复正常权限。

步骤1：创建禁言角色

• 在Discord服务器设置的「角色」页面新建角色，命名为Muted（或自定义名称）
• 调整角色位置：把这个角色拖到所有用户自定义角色的上方，确保其权限优先级高于用户原有角色
• 设置角色权限：在「权限」选项卡中勾选以下拒绝权限（按需调整）：
  • 发送消息
  • 添加反应
  • 连接语音频道
  • 在语音频道说话
  • 创建邀请
  • 发送嵌入内容
  • 上传文件

步骤2：代码实现逻辑（以Discord.js v14为例）

1. 检测到违禁词时添加禁言角色：

// 假设message是触发违禁词的消息对象
const guild = message.guild;
const member = message.member;
const mutedRole = guild.roles.cache.find(role => role.name === 'Muted');

if (!mutedRole) {
  return message.channel.send('服务器未配置禁言角色，请先创建Muted角色');
}

// 给用户添加禁言角色
await member.roles.add(mutedRole);
message.channel.send(`<@${member.id}> 因使用违禁词被禁言1小时`);

2. 定时自动解禁：

// 设置1小时后移除禁言角色（单位：毫秒）
setTimeout(async () => {
  if (member.roles.cache.has(mutedRole.id)) {
    await member.roles.remove(mutedRole);
    message.channel.send(`<@${member.id}> 禁言时长已结束，恢复正常权限`);
  }
}, 60 * 60 * 1000);

对比你的原方案的优势

• 无需操作数据库存储用户原有角色，减少开发复杂度和数据出错风险
• 避免移除角色导致的用户丢失专属频道访问、特殊权限等问题
• 操作更高效：仅需添加/移除单个角色，比批量处理多个角色更稳定

注意事项

• 确保机器人拥有「管理角色」的权限，否则无法给用户添加/移除角色
• 如果服务器有私有频道，需要单独给禁言角色设置该频道的拒绝权限，或在服务器级别统一配置角色权限
• 若需持久化禁言（比如机器人重启后仍需维持禁言），可以将用户ID、禁言结束时间存入数据库，机器人启动时遍历数据库恢复未到期的禁言

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