Modern的Discord桥接

Modern's Discord Bridge

Modern's Discord Bridge 可将您的 Hytale 世界聊天与 Discord 频道连接起来，使用的是您自己的 Discord 机器人。

将 Hytale 聊天消息发送至 Discord，将 Discord 消息转发回 Hytale，宣布加入/离开/死亡事件，并允许 Discord 用户使用 !players 查看当前在线玩家。

功能

• 在 Hytale 和 Discord 之间进行双向聊天转发
• 从 Discord 到 Hytale 的聊天内容中清理表情符号，包括 :smile: 之类的 Unicode 表情符号别名和 :name: 之类的自定义 Discord 表情符号名称
• 玩家加入和离开公告
• 玩家死亡公告，支持 Hytale 死亡消息及备用死亡原因
• Discord 上的 !players 命令，用于显示在线玩家列表
• 游戏内设置界面，通过 /mdb 打开
• 设置界面中安全的令牌处理，令牌字段会被遮盖显示
• 首次启动时自动生成世界/服务器配置文件

安装

1. 下载 moderns-discord-bridge-1.0.jar。
2. 停止您的 Hytale 服务器或关闭您的 Hytale 世界。
3. 将 jar 文件放入您的 Hytale Mods 文件夹。

对于本地 Hytale 安装，通常路径为：

C:\Users\<你的用户名>\AppData\Roaming\Hytale\UserData\mods

对于专用服务器，请将 jar 文件放入该服务器的 mods 文件夹。

1. 启动世界或服务器一次，以便生成配置文件。
2. 在游戏中使用以下命令打开设置界面：

/mdb

1. 粘贴您的 Discord 机器人令牌和 Discord 频道 ID，然后点击保存。
2. 如果保存后 Discord 未立即连接，请重启世界/服务器。

Discord 机器人设置

在 Discord 开发者门户中创建一个 Discord 应用程序和机器人。

启用以下机器人设置：

• 消息内容意图

邀请机器人到您的服务器，并为其授予以下频道权限：

• 查看频道
• 发送消息
• 读取消息历史

将机器人令牌和目标频道 ID 复制到 /mdb 设置界面中。

重要提示：切勿分享您的 Discord 机器人令牌。如果它出现在截图、日志文件或公开聊天中，请立即在 Discord 开发者门户中重新生成。

权限

/mdb 设置界面受权限限制。玩家需要以下权限之一：

mdb.admin mdb.* *

仅将 mdb.admin 权限授予受信任的管理员。没有权限的玩家无法打开配置界面。

配置文件位置

该模组将其配置文件生成在世界/服务器的插件数据文件夹内。在本地世界中，路径类似于：

Hytale\UserData\Saves\<世界名称>\mods\modernknight_ModernsDiscordBridge\config.json

旧的开发版配置文件位于：

Discord 命令

默认命令前缀：

!

可用的 Discord 命令：

!players

显示当前在线的 Hytale 玩家。

注意事项

此模组使用 Discord 机器人连接，而非 Webhook。请确保您的机器人令牌保密，并仅将 /mdb 权限授予可信人员。

在 1.0 版本中，自定义 Discord 表情符号图片不会在 Hytale 聊天中渲染。它们会被转换为可读的文本别名。