AstralBot

模组

· 作者 Erdragh

Minecraft 模组兼作 Discord 机器人,最初为 Create: Astral 制作

0 本站下载 0 关注 更新于 1 年前

需要前置:Fabric API、Forge Config API Port、Fabric Language Kotlin

最新 1.5.5-mc1.18.2-fabric · 1.18.2 · Fabric

一键开服(送7天)

AstralBot

这是一个集 Minecraft 模组与 Discord 机器人于一体的包。它旨在用于 Create: Astral 整合包的官方服务器,但其跨平台实现也使其可供其他用户使用。 目标是让非技术性的服务器管理员能够轻松使用且易于上手, 同时为高级用户允许真正的复杂性。

功能

这些功能是此机器人的核心用途。查看 状态部分 以了解目前已实现的内容。

  • Discord 与 Minecraft 账户关联,可选择要求白名单验证
  • Discord 与 Minecraft 聊天同步,可选通过 Webhook 以提高可读性
  • 使用 Markdown 文件的 FAQ 命令,无需重启服务器

依赖项

此模组有一些依赖项,其中一些在技术上并非必需,因此未直接指定:

实现

  • 使用 JDA 库与 Discord API 进行通信。
  • 使用 Kotlin 以获得比 Java 更好的开发体验
  • 使用 JetBrains Exposed 与数据库进行通信

配置

以下内容可配置:

  • 白名单所需的链接绑定(默认:关闭)

  • 与模拟 Discord 用户的聊天同步:

    1. 无用户模拟(机器人将以其自身名称发送消息)
    2. (如可能)Minecraft 用户模拟(使用 Minecraft 用户名和头像发送消息)
    3. (仅在要求链接绑定以加入白名单时可用)Discord 用户模拟(消息将以绑定的 Discord 名称发送)

    默认:Minecraft 用户模拟(如果已设置 webhook,否则为无模拟)

  • 通过命令界面管理常见问题解答(FAQ)(默认:关闭)

  • 数据库连接。默认使用 SQLite 数据库

状态

  • 白名单功能
  • FAQ 命令
    • 读取 Markdown 文件
    • 无需重启即可更新建议
    • 通过命令进行管理/创建
  • 聊天同步
    • Minecraft 到 Discord
    • Discord 到 Minecraft
    • Discord 上的用户模仿。可使用 Minecraft 头像或 Discord 头像

运行方式

目前尚无该机器人/模组的公开实例。要使用它,请在 Discord Developer Portal 上创建一个新的应用程序,并配置以下三个特权网关意图:PRESENCE、SERVER MEMBERS 和 MESSAGE CONTENT。

复制机器人令牌并将其保存在安全的地方(例如密码管理器),切勿向任何人展示。为确保令牌能被机器人正确读取,您需要将其设置为运行 Minecraft 服务器可访问的环境变量 DISCORD_TOKEN,或者在配置文件的 token 键下填入该令牌。

例如,您可以在类 Unix 系统上修改 start.sh 脚本以 export 它,或直接设置该变量后启动 shell 脚本:

startmc.sh:

export DISCORD_TOKEN=<place token here>

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

或

DISCORD_TOKEN=<place token here> startmc.sh # 在设置环境变量后启动脚本

服务器启动后,你可以前往 Discord 开发者门户中的 OAuth2 URL 生成器,生成一个包含 bot 和 applications.command 权限的 URL。使用该生成的 URL 让机器人加入你的服务器。

为了实现用户模拟功能(使聊天同步更易读),机器人将尝试在配置的聊天同步频道中创建一个 webhook。这意味着它需要拥有管理 webhook 的权限。如果你不希望如此,可以手动在你希望同步消息的频道中创建一个 webhook,并在模组的配置文件中将其设置到 webhook.url 选项内。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源