AstralBot (AstralBot)

AstralBot (AstralBot)

---

Github | 相关wiki | 源站链接

支持: fabric , forge

AstralBot是一个Minecraft模组和Discord机器人的组合。最初是为了Create: Astral模组包而制作的，旨在提供易于使用的功能，并且可由非技术性的服务器管理员使用，同时也为高级用户提供真正的复杂性。

特点

AstralBot的核心功能包括：
- Discord和Minecraft账户链接，可以选择要求进行白名单验证
- Discord和Minecraft聊天同步
- 使用Markdown文件的FAQ命令，无需重新启动服务器即可更新

依赖关系

该模组有一些依赖关系，其中一些未直接指定，因为它们从技术上讲是可选的：
- 您正在运行的平台的Kotlin实现。（例如，[Kotlin For Forge]( 链接)或[Fabric Language Kotlin]( 链接)）
- Forge配置API（包含在Forge中，[Fabric的额外模组]( 链接)）
- SQLite数据库驱动程序。（这在[Ledger]( 链接)中已经包含，但也[可以单独获得]( 链接)）

实现

- [JDA]( 链接)库用于与Discord API进行通信。
- Kotlin用于相对于Java的改进开发体验
- Architectury用于多平台开发
- [JetBrains Exposed]( 链接)用于与数据库通信

配置

以下内容将是可配置的：
- 必要的链接进行白名单验证（默认：关闭）
- 与模拟Discord用户的聊天同步：
1. 不模拟用户（机器人将以自己的名义写入消息）
2. （如果可能）模拟Minecraft用户（将使用Minecraft用户名和头像来发送消息）
3. （仅在需要链接进行白名单验证时可用）模拟Discord用户（消息将以链接的Discord名称发布）

默认：不模拟用户
- 通过命令界面管理FAQ（默认：关闭）
- 数据库连接。默认使用SQLite数据库

状态

- [x] 白名单验证
- [ ] FAQ命令
- [x] 读取Markdown文件
- [x] 更新建议而无需重新启动
- [ ] 通过命令进行管理/创建
- [ ] 聊天同步
- [x] 从Minecraft到Discord
- [x] 从Discord到Minecraft
- [ ] 在Discord上模拟用户

运行

此Bot/模组没有公共实例可用。要使用它，请在[Discord开发者门户网站]( 链接)上创建一个新应用程序，并配置它具有三个特权网关意图：`PRESENCE`，`SERVER MEMBERS`和`MESSAGE CONTENT`。

复制机器人令牌并将其存储在安全位置（例如密码管理器）中，不要向其他人显示。为确保机器人读取令牌，它必须位于[环境变量]( 链接)`DISCORD_TOKEN`中，运行Minecraft服务器可以访问它的地方。例如，您可以修改Unix-like系统上的`start.sh`脚本以`export`它或直接以设置的方式启动shell脚本：

`startmc.sh`：
shell
export DISCORD_TOKEN=

java ... # 启动服务器的Java命令

或

shell
DISCORD_TOKEN= startmc.sh # 使用设置的环境变量启动脚本

启动服务器后，您可以在Discord开发者门户网站上的OAuth2 URL生成器中生成一个URL，其中包含`bot`和`applications.command`权限。使用生成的URL让机器人加入您的服务器。

截图：