如何在DSharpPlus中限制Discord机器人命令的角色/用户权限？

一、命令权限区分设置 #

要实现!status对所有用户开放、!start仅限特定角色/用户使用，有两种直接的实现方式：

1. 代码内直接检查权限 #

在!start命令的处理逻辑开头，手动校验用户身份：

[Command("start")]
public async Task StartCommand(CommandContext ctx)
{
    // 定义允许的角色ID或用户ID
    ulong allowedRoleId = 1234567890; // 替换成目标角色ID
    List<ulong> allowedUserIds = new List<ulong> { 9876543210 }; // 替换成目标用户ID

    // 检查用户是否在白名单，或拥有指定角色
    bool hasPermission = allowedUserIds.Contains(ctx.User.Id) || 
                         ctx.Member.Roles.Any(r => r.Id == allowedRoleId);

    if (!hasPermission)
    {
        await ctx.RespondAsync("你没有权限执行此命令！");
        return;
    }

    // 执行命令核心逻辑
    await ctx.RespondAsync("启动成功！");
}

!status命令无需额外检查，直接编写业务逻辑即可。

2. 使用DSharpPlus内置权限属性 #

利用框架提供的[RequireRoles]属性快速实现角色限制：

[Command("start")]
// 允许拥有「管理员」或「版主」角色的用户执行
[RequireRoles(RoleCheckMode.Any, "管理员", "版主")]
public async Task StartCommand(CommandContext ctx)
{
    await ctx.RespondAsync("启动成功！");
}

也可以直接指定角色ID，避免角色名修改导致的失效：

[RequireRoles(RoleCheckMode.Any, roleIds: new ulong[] { 1234567890, 9876543210 })]

二、关于AddRoleAsync的权限存储问题 #

AddRoleAsync的作用是给服务器成员添加指定角色，它只会修改成员的角色列表，不会将你的机器人命令权限规则保存到Discord服务器上。

命令权限的控制逻辑完全由你的代码实现——如果是前缀命令（如!start），Discord服务器不会存储这些权限规则；如果使用Discord原生的斜杠命令，你可以通过开发者门户或DSharpPlus API配置服务器级别的命令权限，这种情况下权限规则会存在Discord服务器端，但AddRoleAsync依然只是给成员添加角色，和命令权限的存储没有直接关系。

三、限制机器人仅在特定频道活动 #

机器人加入服务器后默认能看到所有频道，你可以从代码或服务器权限层面实现限制：

1. 代码层面过滤 #

• 单命令限制：在命令处理逻辑开头检查当前频道是否在允许列表：

[Command("start")]
public async Task StartCommand(CommandContext ctx)
{
    List<ulong> allowedChannelIds = new List<ulong> { 1122334455, 6677889900 }; // 目标频道ID
    if (!allowedChannelIds.Contains(ctx.Channel.Id))
    {
        await ctx.RespondAsync("此命令仅允许在指定频道使用！");
        return;
    }
    // 命令逻辑
}

• 全局监听过滤：在消息监听事件中直接忽略非目标频道的消息：

client.MessageCreated += async (s, e) =>
{
    List<ulong> allowedChannelIds = new List<ulong> { 1122334455, 6677889900 };
    if (!allowedChannelIds.Contains(e.Channel.Id))
        return;

    // 后续消息/命令处理逻辑
};

2. 服务器权限层面限制 #

直接在Discord服务器的频道设置中修改机器人角色的权限：找到机器人对应的角色，在非目标频道中禁用「查看频道」「发送消息」等权限，仅在管理员/版主频道开启这些权限。这种方式是服务器端的硬限制，效果更彻底。

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