Skip to content

Commit 891653d

Browse files
authored
Merge pull request #61 from Sjshi763/更新文档(让discord图更多一点)
增强 Discord 文档
2 parents b1573d1 + ae4979a commit 891653d

File tree

7 files changed

+33
-9
lines changed

7 files changed

+33
-9
lines changed

deploy/platform/discord.md

Lines changed: 33 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,22 +6,37 @@ AstrBot v3.5.16 及之后,支持接入 [Discord](https://discord.com/) 消息
66

77
进入消息平台,点击新增适配器,找到 Discord 并点击进入 Discord 配置页。
88

9-
![](../../source/images/discord/image.png)
9+
![点击创建机器人,选择discord类型](../../source/images/discord/image.png)
1010

11-
在弹出的配置对话框中点击 `启用`
11+
![选项从上到下依次是 1.机器人名称 2. 启用 3. Bot token 4. Discord 代理地址 5. 是否自动将插件指令注册为 Discord 斜杠指令 6. discord_guild_id_for_debug 7.Discord 活动名称](../../source/images/discord/image-3.png)
12+
> 本次教程只用管1,2,3,5项
1213
14+
- 机器人名称:自定义,方便区分不同适配器
15+
- 启用:勾选后启用该适配器
16+
- Bot Token:在 Discord 创建 App 后获取的 Token(见下文)
17+
- Discord 代理地址:如果你需要使用代理访问 Discord,可以在这里填写代理地址(可选)
18+
- 是否自动将插件指令注册为 Discord 斜杠指令:勾选后,AstrBot 会自动将已安装插件中的指令注册为 Discord 斜杠指令,方便用户使用。
1319
## 在 Discord 创建 App
1420

1521
1. 前往 [Discord](https://discord.com/developers/applications),点击右上角蓝色按钮,输入应用名字,创建应用。
1622

17-
![](../../source/images/discord/image-1.png)
23+
![创建bot(输入名字)](../../source/images/discord/image-1.png)
1824

1925
2. 点击左边栏的 Bot,点击 Reset Token 按钮,创建好 Token 后,点击 Copy 按钮,将 Token 填入配置中的 Discord Bot Token 处。
20-
3. 下滑找到这三个选项全开启
2126

22-
![](../../source/images/discord/image-2.png)
27+
![token选项](../../source/images/discord/image-4.png)
28+
4. 下滑找到这三个选项全开启
2329

24-
4. 点击左边栏的 OAuth2,在 OAuth2 URL Generator 中选中 `Bot`,然后在下方出现的 Bot Permissions 处选择允许的权限。一般来说,建议添加如下权限:
30+
![Presence Intent,Server Members Intent,Message Content Intent截图](../../source/images/discord/image-2.png)
31+
32+
- Presence Intent:允许机器人获取用户在线状态
33+
- Server Members Intent:允许机器人获取服务器成员信息
34+
- Message Content Intent:允许机器人读取消息内容
35+
36+
5. 点击左边栏的 OAuth2,在 OAuth2 URL Generator 中选中 `Bot`
37+
也就是这样
38+
![OAuth2 URL Generator](../../source/images/discord/image-6.png)
39+
然后在下方出现的 Bot Permissions 处选择允许的权限。一般来说,建议添加如下权限:
2540
- Send Messages
2641
- Create Public Threads
2742
- Create Private Threads
@@ -32,8 +47,17 @@ AstrBot v3.5.16 及之后,支持接入 [Discord](https://discord.com/) 消息
3247
- Attach Files
3348
- Read Message History
3449
- Add Reactions
35-
4. 复制下方出现的 GENERATED URL。打开这个 URL,将 Bot 添加到所需要的服务器。
36-
5. 返回 AstrBot,在填好 Discord Bot Token 后,点击保存。
37-
6. 进入 Discord 服务器,@ 刚刚创建的机器人(也可以不 @),输入 `/help`,如果成功返回,则测试成功。
50+
如果你觉得麻烦也可以直接使用administrator权限,但仍然建议在使用环境中使用上文的配置权限(或您自己需要的权限)
51+
> 记住,权限越高,风险越大。
52+
53+
6. 复制下方出现的 Generated URL。打开这个 URL,将 Bot 添加到所需要的服务器。
54+
![Generated URL位置](../../source/images/discord/image-5.png)
55+
56+
7. 进入 Discord 服务器,你的机器人应该已经提示在线了
57+
![机器人在线](../../source/images/discord/image-7.png)
58+
@ 刚刚创建的机器人(也可以不 @),输入 `/help`,如果成功返回,则测试成功。
59+
60+
# 故障排除
61+
- 如果卡在最后的步骤,机器人不在线请确定自己的服务器可以直接连接discord
3862

3963
如果有疑问,请[提交 Issue](https://github.com/AstrBotDevs/AstrBot/issues)

source/images/discord/image-3.png

80.9 KB
Loading

source/images/discord/image-4.png

19.2 KB
Loading

source/images/discord/image-5.png

70.2 KB
Loading

source/images/discord/image-6.png

38.7 KB
Loading

source/images/discord/image-7.png

51.3 KB
Loading

source/images/discord/image.png

-195 KB
Loading

0 commit comments

Comments
 (0)