Avrae Discord Bot 使用教程

Avrae Discord Bot 使用教程

avrae A Discord bot to streamline running D&D 5e. 项目地址: https://gitcode.com/gh_mirrors/avr/avrae

1. 项目介绍

Avrae 是一个专为在 Discord 上进行 D&D（龙与地下城）游戏而设计的开源机器人。它提供了高级的骰子滚动功能、SRD（系统参考文档）和角色表集成，以及战斗回合管理等功能。Avrae 旨在简化在线 D&D 游戏的流程，使玩家能够更专注于游戏本身，而不是技术细节。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了 Python 3.8 或更高版本。然后，克隆项目仓库并安装所需的依赖：

git clone https://github.com/avrae/avrae.git
cd avrae
pip install -r requirements.txt

2.2 配置环境变量

在项目根目录下创建一个 .env 文件，并添加以下内容：

DISCORD_TOKEN=your_discord_bot_token

将 your_discord_bot_token 替换为你从 Discord 开发者门户获取的实际 Bot 令牌。

2.3 启动 Bot

运行以下命令启动 Avrae Bot：

python main.py

2.4 邀请 Bot 到你的服务器

访问 Discord 开发者门户，选择你的 Bot，然后生成一个邀请链接。确保在邀请链接中启用了以下权限：

• 读取消息
• 发送消息
• 嵌入链接
• 管理消息

点击生成的邀请链接，将 Bot 添加到你的 Discord 服务器。

3. 应用案例和最佳实践

3.1 使用 Avrae 进行骰子滚动

Avrae 提供了强大的骰子滚动功能，支持各种复杂的骰子操作。例如，你可以使用以下命令进行一次攻击检定：

!roll 1d20 + 5

3.2 角色表集成

Avrae 可以与 D&D Beyond、Dicecloud 或 Google Sheets 等平台集成，自动生成角色表。你可以使用以下命令从 D&D Beyond 导入角色：

!beyond import character_url

3.3 战斗回合管理

Avrae 的战斗回合管理功能可以帮助你轻松管理战斗中的角色和怪物。你可以使用以下命令开始一场战斗：

!init start

然后，使用以下命令添加战斗者：

!init add "Character Name" ac=15 hp=50

4. 典型生态项目

4.1 D&D Beyond

D&D Beyond 是一个官方的 D&D 资源网站，提供了大量的角色表、怪物、物品和规则书。Avrae 可以与 D&D Beyond 无缝集成，自动导入角色数据。

4.2 Dicecloud

Dicecloud 是一个在线角色表管理工具，支持自定义角色表和高级骰子滚动功能。Avrae 可以与 Dicecloud 集成，提供更灵活的角色管理体验。

4.3 Google Sheets

如果你更喜欢使用 Google Sheets 来管理角色表，Avrae 也支持从 Google Sheets 导入角色数据。你只需要提供 Google Sheets 的共享链接即可。

通过以上步骤，你可以快速上手并充分利用 Avrae Discord Bot 的功能，提升你的 D&D 游戏体验。

avrae A Discord bot to streamline running D&D 5e. 项目地址: https://gitcode.com/gh_mirrors/avr/avrae