AMCDB

模组

· 作者 0x4e49434f4c45

另一个 Minecraft-Discord 桥接工具

0 本站下载 0 关注 更新于 7 个月前

最新 1.4.0 · 26.3 · Fabric / Quilt

一键开服(送7天)

AMCDB (Another Minecraft-Discord Bridge)

无 AI 软件

AMCDB 由人类亲手打造,是对编程艺术以及用双眼审视软件内部构造这一传统的热爱之作。

本模组中没有任何代码是由 LLM 或“AI”工具生成的。

概述

AMCDB 是一款 Fabric/Quilt 模组,用于将你的 Minecraft 服务器连接到 Discord 服务器。你可以将游戏内聊天连接到 Discord 频道,设置一个用于服务器控制台的频道,甚至可以从任何地方运行服务器命令!

以下是它在 Minecraft 中的样子...
Example of chat in Minecraft game

...而在 Discord 中则是这样!
Example of chat in Discord channel

如果你更喜欢让 Discord 中出现的游戏内消息看起来像是来自玩家(并显示他们的玩家头像作为头像),AMCDB 也支持 Discord 网络钩子(webhooks):
Example of chat in Discord channel using webhook mode

主要功能

  • AMCDB 速度快且*对延迟友好。它几乎在所有工作都在主服务器线程之外进行,因此不会影响游戏性能。
  • AMCDB *灵活性强。你可以按照自己的意愿配置一切——自定义游戏内和 Discord 中的消息外观,在频道主题中放入对你最有用的信息,甚至给 Discord 机器人设置一个聪明的状态消息!
  • AMCDB 稳定且*兼容性好。它不使用 mixins 来修改 Minecraft 代码,因此在不同 Minecraft 版本之间很少会出现故障,并且能与几乎所有其他 Fabric 模组良好配合。
  • 最后,AMCDB *有趣。它支持各种酷炫的 Discord 功能,例如:
    • 字体样式...
      Italic, bold, and underlined text in Minecraft
    • ...名称颜色...
      Discord name color displayed in Minecraft
    • ...甚至是悬停即可揭示的剧透文本!
      Discord spoiler text obfuscated in Minecraft

安装

请按照以下步骤在你的服务器上设置 AMCDB。

注意:你需要是你想要连接的 Discord 服务器的管理员。

在 Minecraft 服务器上安装 AMCDB

你需要一个 Fabric 或 Quilt 服务器。一旦设置好,请确保 [Fabric API](https://modrinth.com/mod/fabric-api) 位于你的 mods 文件夹中——这是 AMCDB 唯一的依赖项。

然后,从 GitHub Releases 或 Modrinth 获取最新的 AMCDB .jar 文件。它可能是类似 amcdb-1.1.5.jar 的文件。将其放入你的 mods 文件夹中。

接下来,启动你的服务器。它会崩溃——这只是因为你还没有配置 AMCDB。现在你已经启动过一次服务器了,在 config 文件夹中应该会有一个名为 amcdb.properties 的文件。用文本编辑器打开该文件,并在下一步中使用它。

设置 Discord 机器人

如果你以前使用过其他 Minecraft-Discord 模组,你可能已经有一个机器人。只要它在你的服务器上有正确的权限,你就可以重用它——只需将令牌放入 amcdb.properties 文件中即可。

如果你没有 Discord 机器人:

  1. 登录 。
  2. 点击右上角的 New Application(新建应用)。
  3. 为你的机器人取一个名字,然后点击 Create(创建)。
    Discord Create Application dialog
  4. 在屏幕左侧,点击 Bot。
    Discord Application menu
  5. 现在你将生成 AMCDB 用于连接的令牌。在页面的主要部分,找到 Bot 部分中的 Token,然后点击 Reset Token。确认并输入你的两步验证代码(如果需要)后,会出现类似下图的一串随机字符——这就是你的令牌!点击 Copy(复制)。
    Discord Bot token
  6. 在你之前打开的 amcdb.properties 文件中,找到以 amcdb.discord.bot.token= 开头的那一行,并将你的机器人令牌粘贴到该行末尾。它看起来像这样:
    amcdb.discord.bot.token=MTUxNjYyMDU5MTU2ODkxNjUyMQ.GtHHYH.cwfUiwbSCguEt8vA4KtdUdPlD-kexM_V98cSwE
    
  7. 向下滚动到 Privileged Gateway Intents(特权网关意图)部分,并开启 Message Content Intent(消息内容意图)。这将允许你的机器人读取你 Discord 服务器中的消息,以便将其显示在你的 Minecraft 游戏聊天中。
    Discord Privileged Gateway Intents settings
  8. 回到屏幕左侧,转到 OAuth2。
  9. 在 OAuth2 URL Generator(OAuth2 URL 生成器)部分,在 Scopes(作用域)下,勾选 bot 选项。将出现一个标记为 Bot Permissions(机器人权限)的新框。在此处,选择以下权限:
    • Manage Channels(管理频道)
    • View Channels(查看频道)
    • Send Messages(发送消息) Discord Bot Permissions
  10. 然后向下滚动到 Generated URL(生成的 URL)部分,并从框中复制 URL。它应该看起来像这样:
https://discord.com/oauth2/authorize?client_id=1516620591568916521&permissions=3088&integration_type=0&scope=bot
  1. 将你复制的 URL 粘贴到一个新的浏览器标签页中,选择一个服务器,点击 Continue(继续),然后点击 Authorize(授权)。你应该看到机器人加入你的 Discord 服务器!

配置聊天频道

AMCDB 有许多可以配置的设置,但除了机器人令牌外,你只需要配置一项即可开始使用——你需要告诉 AMCDB 你想用于游戏内聊道的频道 ID。你可能希望为此创建一个新的文本频道,因为该频道中的所有消息都会出现在 Minecraft 中,反之亦然。

要获取频道 ID,请在你的 Discord 应用中启用开发者模式。打开设置菜单,然后在左侧选择 Advanced(高级)。接着,开启 Developer Mode(开发者模式)。
Discord Developer Mode setting

一旦开启了开发者模式,你可以右键单击你想要使用的频道,然后点击 Copy ID(复制 ID)。将该 ID 粘贴到 amcdb.properties 中 amcdb.discord.chat.channel= 旁边。它看起来像这样:

amcdb.discord.chat.channel=1046313040837832782

如果你想为一个服务器控制台频道设置,也复制其 ID 并将其粘贴到 amcdb.discord.console.channel= 旁边。控制台频道支持运行你通过 Discord 发送的命令;出于安全考虑,此功能默认禁用,但你可以通过将设置 amcdb.discord.channels.console.enableExecution= 更改为 true 来启用它。

然后保存 amcdb.properties 文件并重新启动你的 Minecraft 服务器。如果你一切操作正确,你在游戏聊天中输入的任何内容都应该出现在 Discord 频道中,而你在 Discord 频道中输入的任何内容也应该出现在你的游戏中!

请随意探索 amcdb.properties 文件的其余部分,因为所有 AMCDB 的配置设置都位于此处。如果你更改了任何内容,你需要停止并启动 Minecraft 服务器以使新设置生效。

配置 webhook 模式

如果你想将 Minecraft 玩家头像显示为 Discord 头像,你需要启用 webhook 模式。这是可选的——如果不设置 webhook,AMCDB 也能正常工作。

要设置 webhook,请按照以下步骤操作:

  1. 打开你的 Discord 服务器设置页面。
  2. 在左侧,选择 Integrations(集成)(在“Apps”类别下)。
  3. 点击“Webhooks”,然后点击“New Webhook”(新建 Webhook)。
  4. 点击你的新 webhook,将其名称更改为 Minecraft(或你想要的任何名称),并将频道设置为你想用于 Minecraft 聊天的频道。
  5. 点击“Copy Webhook URL”(复制 Webhook URL)。
  6. 将 URL 粘贴到 amcdb.properties 中 amcdb.discord.channels.chat.webhookUrl= 旁边。别忘了通过删除开头的 # 来取消注释该行。
  7. 与往常一样,保存 amcdb.properties 文件并重启你的服务器。你应该开始看到带有玩家名称和头像的游戏内消息出现在 Discord 中!

升级

通常,你只需将 .jar 文件替换为新版本即可升级 AMCDB。

当你升级时,最好检查 amcdb.properties 中是否添加了新属性;你可以在这里找到最新版本的默认配置文件。偶尔会添加新的必需属性;这会导致你在更新 .jar 后服务器无法启动,直到你将新属性添加到你的配置中。

你还可以通过强制 AMCDB 生成一个新的配置文件来更新你的 properties 文件:

  1. 停止你的 Minecraft 服务器
  2. 将 amcdb.properties 重命名为一个临时名称,例如 amcdb.properties.old
  3. 更新 .jar 文件并启动你的服务器。AMCDB 会生成一个新的 amcdb.properties 模板,并且服务器会像全新安装时一样停止。
  4. 从 amcdb.properties.old 中复制你的设置到新的 amcdb.properties 文件中。
    • 你也可以直接将任何缺失的属性复制到 amcdb.properties.old 中,然后将其重新命名为 amcdb.properties。
  5. 启动你的 Minecraft 服务器。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源