重要的 Discord 链接

重要的 Discord 链接

一个仅保留基本功能的 Discord 链接模组，满足您从 Discord 到 Hytale 的需求

实用

Discord Hytale Link

一个轻量、简单、易用、无冗余的模块，用于在 Discord 和 Hytale 之间搭建桥梁。该模块深受并基于为 Minecraft 开发的 EssentialsX Discord 启发。

您希望从 Discord 桥接中获得的功能，例如：

  • Hytale 聊天 → Discord 频道
  • Discord 频道 → Hytale 聊天
  • 基础的 Hytale → Discord 事件监控（加入/离开/死亡/禁言）
  • 以及更多……

目录

初始设置

  1. 在启动服务器之前，需要完成几个步骤。首先，您必须在 discord.com/developers/applications 创建一个新的 Discord 机器人。

  2. 进入该页面后，点击右上角的“New Application”按钮，为您的机器人命名，然后点击“Create”。

创建应用程序 New Application -> 为应用程序命名 -> Create

  1. 创建应用程序后，您将进入其概览页面。在此页面，您需要复制您的“Application ID”并保存以供后续步骤使用。要复制您的 Application ID，请点击左上角的蓝色“Copy”按钮。务必保存好，以备后续使用。

复制 Application ID Copy -> 粘贴到记事本，留待后续步骤使用

  1. 可选：您可以为应用程序设置一个图标，该图标也将用作机器人的图标。

头像

  1. 下一步是为您的应用程序创建一个机器人用户。在概览页面，转到左侧的“Bot”选项卡，然后点击右侧的“Add Bot”，最后点击“Yes, do it!”。

创建机器人 Bot -> Add Bot -> Yes, do it!

  1. 进入此页面后，您需要取消勾选“Public Bot”设置，启用所有“Privileged Intents”，然后点击“Save Changes”。这可以防止其他人添加您的机器人，并允许您的机器人使用更多 Discord 功能。

更新机器人设置 取消勾选 Public Bot -> 勾选 Presence Intent -> 勾选 Server Members Intent -> 勾选 Message Content Intent -> Save Changes

  1. 最后，您需要复制机器人的令牌并保存以供后续步骤使用。要复制机器人令牌，请点击机器人图标右侧的蓝色“Reset Token”按钮，然后点击“Yes, do it!”，最后点击“Copy”。务必保存好，以备后续使用。

复制令牌 Reset Token -> Yes, do it! -> Copy -> 粘贴到记事本，留待后续步骤使用

  1. 接下来是将您的机器人添加到 Discord 服务器。

  2. 进入 Discord 授权页面后，从“Select a server”下拉菜单中选择您想要添加机器人的服务器。然后点击“Authorize”按钮。系统可能会提示您确认不是机器人，像处理其他验证码一样正常操作即可。

授权 选择服务器 -> Authorize

  1. 在接下来的几个步骤中，您需要在 Discord 中执行一些操作，因此请启动您的 Discord 桌面端/网页端客户端。

  2. 进入 Discord 客户端后，您需要启用开发者模式。进入设置，然后转到“Advanced”选项卡，勾选页面底部的“Developer Mode”。勾选“Developer Mode”后，点击右上角的 X 退出设置。

开发者模式 User Settings -> Advanced -> 勾选 Developer Mode -> 退出设置

  1. 接下来是复制一些 ID。首先，您需要复制服务器（也称为公会）ID。找到您添加了机器人的服务器，右键点击其图标，然后点击“Copy ID”。复制后，务必保存好，以备后续步骤使用。

公会 ID 右键点击服务器 -> Copy ID -> 粘贴到记事本，留待后续步骤使用

  1. 您需要复制的另一个 ID 是您希望作为主频道的频道 ID。换句话说，这将是默认接收玩家聊天/加入/离开/死亡消息以及禁言/踢出消息的频道。要了解如何进一步配置消息类型，请参阅配置消息。

主频道 ID 右键点击您的“主”频道 -> Copy ID -> 粘贴到记事本，留待后续步骤使用

  1. 您已成功复制了基本设置所需的所有必要 ID。接下来是生成插件的默认配置，以便您可以开始进行设置！将 JAR 文件（如果您还没有，可以从这里下载）放入您的 mods 文件夹，启动您的服务器，然后在它完成启动后立即停止。

  2. 现在，您可以使用之前复制的所有信息开始配置插件。打开配置文件 mods/anirudhgupta109_HytaleDiscordLink/config.yml。打开配置文件后，首先要配置的是您的机器人令牌。将配置文件中的 YOUR_BOT_TOKEN 替换为您在第 6 步中复制的令牌。

  3. 接下来是公会 ID。将配置文件中公会值对应的零替换为您在第 12 步中复制的公会 ID。

  4. 最后，您需要粘贴从第 13 步复制的频道 ID，将其粘贴到 channels 部分。完成后，保存配置文件！

  5. 恭喜，您已完成初始设置指南！当您启动服务器时，您应该会注意到聊天和其他消息开始出现在您指定的频道中。现在您已经完成了初始设置，请返回目录查看您还可以做哪些其他酷炫的事情！

配置身份验证

该插件还为服务器所有者提供了一个可选功能，即只有 Discord 频道的成员才能通过 config.yml 中的 auth-enabled 选项加入并游玩服务器。

这可以进一步扩展，将 strict-auth 作为一个选项，要求每次会话加入时都提供一个链接代码（对于“离线”游戏或当您的 Discord 服务器成员频繁加入和离开时非常有用）。

如何编译？

按照此指南获取 HytaleServer.jar 文件，并将其放在 libs/ 目录下。

使用以下命令运行构建：

./gradlew clean build shadowJar

输出的 JAR 文件将位于 build/libs/hytale-discord-link-<VERSION>-all.jar。 成功！

进行中的工作

  • Discord 角色 → Hytale 组同步
  • 通过 Discord 执行控制台命令
  • 列出命令和 Webhook 集成