带权限的 Discord 机器人邀请链接生成器
Discord 机器人邀请链接是一个 OAuth2 网址,其中包含机器人的客户端 ID、你授予的权限以及它所需的作用域。 输入客户端 ID,勾选权限,此生成器就会构建官方的 discord.com 链接以及与之对应的权限整数。
Permissions integer: 0
如何使用
- 找到客户端 ID。在 Discord 开发者门户中打开你的应用,然后进入“通用信息”。应用 ID 就是同一个数字。
- 选择作用域。保留
bot以添加机器人用户。如果机器人有斜杠命令,请保留applications.commands。 - 勾选权限。从预设开始,然后添加或删除你需要的内容。整数会实时更新。
- 复制链接并打开它。选择你拥有管理服务器权限的服务器,然后按下授权。
链接中包含什么
| 部分 | 含义 |
|---|---|
client_id | 机器人的应用 ID |
permissions | 将每项权限的位值相加得到的数字 |
scope | 应用可以做什么:添加机器人、注册斜杠命令 |
权限数字是一个位字段。每项权限都是 2 的幂,整数就是它们的和。你无需手动相加:本工具使用精确的大数运算完成,因为这些值超出了普通 JavaScript 数字能够安全容纳的范围。若要从数字反推出权限列表,请使用权限计算器。
选择能正常工作的最小权限集
只给机器人其功能所需的权限,不要多给。管理员会关闭所有检查,因此一旦出现漏洞或令牌泄露,就没有任何防护。还要记住 Discord 在服务器端强制执行的两件事:
- 链接只设置机器人的初始身份组。频道覆盖设置仍可能阻止它。
- 机器人无法管理位于其自身身份组之上的身份组。
本生成器只构建网址。它不会联系 Discord,也永远不会看到你的机器人令牌。切勿把令牌粘贴到任何地方。客户端 ID 是公开的。
改为添加 Noxyr
只有为你自己制作的机器人才需要使用此工具。要添加 Noxyr,请使用邀请链接。Noxyr 请求的是固定的权限列表,而不是管理员,权限参考说明了每项权限的用途。如果你想要一个使用自己名称和头像的机器人,请阅读自定义机器人文档。
故障排查
“Integration requires code grant”或作用域无效
你的机器人在开发者门户中设置为需要 OAuth2 代码授权。对于普通机器人,请将其关闭。
机器人已加入,但看不到某个频道
检查频道覆盖设置。频道上的拒绝优先于链接中的身份组权限。
服务器不在列表中
添加机器人时,你需要该服务器的管理服务器权限。
相关阅读
应用 ID 术语条目解释了你粘贴的数字,机器人令牌条目则说明了为什么这一项必须保密。添加机器人后,可以使用状态检查器查看 Discord 的运行状况。
常见问题
如何制作 Discord 机器人邀请链接?
使用 https://discord.com/oauth2/authorize,并附上你的 client_id、权限整数以及作用域 bot 和 applications.commands。本工具会为你构建该网址。
权限数字是什么意思?
它是你勾选的每项权限的位值之和。工具会自动计算,而权限计算器可以将其解码回列表。
我应该给机器人管理员权限吗?
只有在你完全信任并控制它的情况下才应该。只授予机器人所需的权限,可以限制漏洞或令牌泄露造成的损失。
本工具需要我的机器人令牌吗?
不需要。它只需要公开的客户端 ID,并且从不发出任何网络请求。