AMCDB

AMCDB（另一个 Minecraft-Discord 桥接模组）

无 AI 软件

AMCDB 自豪地由人类亲手打造，是对编程艺术的热爱，也是对亲自探究软件内部运作这一传统的致敬。

本模组中的代码均未使用 LLM 或“AI”工具创作。

概览

AMCDB 是一款 Fabric/Quilt 模组，可将你的 Minecraft 服务器连接到 Discord
服务器。你可以将游戏内聊天连接到 Discord 频道，为服务器控制台设置专用频道，
甚至可以随时随地运行服务器命令！

这是它在 Minecraft 中的样子……

……这是它在 Discord 中的样子！

如果你希望 Discord 中的游戏内消息显示为由玩家发送
（并使用玩家头像作为头像！），AMCDB 也支持 Discord
webhook：

主要功能

• AMCDB 速度快，并且对延迟友好。它几乎所有工作都在

服务器主线程之外完成，因此不会影响游戏性能。

• AMCDB 灵活。你可以按自己的喜好配置一切，

包括自定义游戏内和 Discord 中的消息显示方式、在频道主题中放入对你最有用的
信息，甚至为 Discord 机器人设置一句巧妙的状态消息！

• AMCDB 稳定且兼容性好。它不会使用 mixin 修改

Minecraft 代码，因此在不同 Minecraft 版本之间很少出现问题，而且与几乎所有其他 Fabric 模组都能
良好兼容。

• 最后，AMCDB 还很好玩。它支持各种酷炫的 Discord

功能，例如：

• 字体样式……
  
• ……名称颜色……
  
• ……甚至还有悬停即可揭示的剧透文本！
  

安装

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

注意：你需要拥有要连接的 Discord 服务器的管理员权限。

在 Minecraft 服务器上安装 AMCDB

你需要一个 Fabric 或 Quilt 服务器。完成服务器设置后，请确保
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. 登录 https://discord.com/developers/applications/。
2. 点击右上角的 New Application。
3. 为机器人命名，然后点击 Create。
   
4. 在屏幕左侧，点击 Bot。
   
5. 现在，你需要生成 AMCDB 用来连接的令牌。在页面主体

部分的 Bot 区域中找到 Token，然后点击 Reset Token。
确认并输入双重验证代码（如有要求）后，会出现一串随机字符，如下图所示——这就是你的令牌！点击 Copy。

1. 在你之前打开的 amcdb.properties 文件中，找到以此开头的那一行

使用 amcdb.discord.bot.token=，并将你的机器人令牌粘贴到该
行的末尾。内容看起来会像这样：

    amcdb.discord.bot.token=MTUxNjYyMDU5MTU2ODkxNjUyMQ.GtHHYH.cwfUiwbSCguEt8vA4KtdUdPlD-kexM_V98cSwE

1. 向下滚动到 特权网关意图部分，然后开启

消息内容意图。这样机器人就能读取
Discord 服务器中的消息，并将其发送到 Minecraft 游戏聊天中。

1. 回到屏幕左侧，前往 OAuth2。
2. 在 OAuth2 URL 生成器部分的 作用域下，勾选 bot 选项。

随后会出现一个标有 机器人权限的框。在这里选择以下权限：

• 管理频道
• 查看频道
• 发送消息

1. 然后向下滚动到 生成的 URL部分，并复制框中的 URL。它

应该看起来像这样：

   https://discord.com/oauth2/authorize?client_id=1516620591568916521&permissions=3088&integration_type=0&scope=bot

1. 将复制的 URL 粘贴到新的浏览器标签页中，选择一个服务器，点击

继续，然后点击授权。你应该会看到机器人加入你的 Discord
服务器！

配置聊天频道

AMCDB 有很多可以配置的设置，但除了机器人令牌之外，
要开始使用，你只需完成一项设置——告诉 AMCDB 游戏内聊天所用
频道的 ID。你可能需要为此
新建一个文字频道，因为该频道中的所有消息都会
同步显示在 Minecraft 和 Discord 中。

要获取频道 ID，请在 Discord 应用中启用开发者模式。打开
设置菜单，然后点击左侧的 高级。接着开启 **开发者
模式**。

开启开发者模式后，右键点击要使用的频道，然后点击
复制 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. 在左侧选择“集成”（位于“应用”类别下）。
3. 点击“Webhooks”，然后点击“新建 Webhook”。
4. 点击新建的 webhook，将其名称改为 Minecraft（或你喜欢的名称），并将频道设为你想用于 Minecraft 聊天的频道。
5. 点击“复制 Webhook URL”。
6. 将 URL 粘贴到 amcdb.properties 中的 amcdb.discord.channels.chat.webhookUrl= 后面。别忘了删除该行开头的 #，取消注释。
7. 和往常一样，保存 amcdb.properties 文件并重启服务器。之后你应该就能在 Discord 中看到带有玩家名称和头像的游戏内消息了！

升级

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

升级时，最好检查 amcdb.properties 中是否新增了属性；你可以在此处找到最新版本的默认
配置。有时会新增必需属性；更新 .jar 后，如果未将这些新属性添加到配置中，服务器将无法启动。

你也可以强制 AMCDB 生成新的配置文件来更新属性文件：

1. 停止 Minecraft 服务器
2. 将 amcdb.properties 重命名为临时名称，例如 amcdb.properties.old
3. 更新 .jar 文件并启动服务器。AMCDB 将生成新的 amcdb.properties 模板，随后服务器会像全新安装时一样停止。
4. 将 amcdb.properties.old 中的设置复制到新的 amcdb.properties 中。

• 你也可以直接将缺少的属性复制到 amcdb.properties.old 中，然后将其重命名回 amcdb.properties。

1. 启动 Minecraft 服务器。