? Minecraft Matrix Chat Bridge
一个强大的、私密且安全的桥梁,连接你的 Minecraft 服务器与 Matrix 家庭服务器(Homeserver)。
?️ 为什么选择 Matrix?
在这个数据隐私和用户安全至关重要的时代,Matrix 成为游戏社区的首选方案。与 Discord 或其他集中式平台不同,Matrix 允许你:
- 拥有你的数据:自行托管服务器。没有任何第三方在挖掘玩家的聊天记录。
- 确保安全:创建一个私密的隔离环境,适合所有年龄段的玩家。你控制谁能加入以及他们能看到什么。
- 保持安全:行业标准的加密和开源透明度。
该插件将你的 Minecraft 服务器直接集成到这个安全生态系统中,提供无缝的体验,使其在两个平台上都感觉像原生应用一样。
✨ 主要功能
-
? 双向聊天桥接
- 消息在 Minecraft 和 Matrix 之间即时流动。
- 无论是在游戏中还是在手机上,都能体验统一的社区氛围。
-
? 真正的用户模拟(Impersonation)
- 忘掉那些通用的机器人消息吧!
- 当玩家在游戏中的聊天框发言时,Matrix 中的消息看起来是来自他们的实际账号,包括他们的头像和名字。
-
? 自动注册与同步
- 自动创建账号:每次有玩家首次加入服务器时,都会自动为其创建一个无需密码的 Matrix 账号。
- 自动头像同步:每次玩家加入时,插件会检查玩家皮肤是否更改,并相应地更新其 Matrix 头像。
- 自动房间同步:每次玩家加入时,根据其权限自动将其添加到正确的 Matrix 房间中。
-
? 基于角色的访问控制
- 根据游戏中的权限(例如 VIP、工作人员)自动管理房间成员资格。
- 无需手动邀请;插件会自动处理繁重的管理工作。
-
? 基岩版玩家支持
- 通过为基岩版玩家(例如来自 Geyser 的玩家)的用户名添加可配置的后缀来区分他们(例如
.Steve变为steve.b)。
- 通过为基岩版玩家(例如来自 Geyser 的玩家)的用户名添加可配置的后缀来区分他们(例如
-
?️ 轻量级且原生
- 使用原始 Matrix/Synapse API 构建。
- 零外部依赖或臃肿的库。
?️ 前置条件
- Minecraft Server:Spigot、Paper 或 Purpur(1.20.6 或更高版本)。
- Matrix Homeserver:一个 Synapse 服务器,且你拥有管理员访问权限。
- Bot Account:一个在你的家庭服务器上具有 管理员特权 的 Matrix 账号(用于模拟身份和管理用户)。
? 安装
- 下载 发布页面中最新的
matrix-chat-1.0.jar。 - 放置 jar 文件到你的服务器的
plugins文件夹中。 - 重启 服务器以生成默认配置文件。
- 配置
plugins/MatrixChat/config.yml(见下文)。 - 重要:手动将你的 bot 账号邀请到配置的
bridgeRoom以及配置文件中列出的任何其他房间。如果没有邀请,bot 无法自动加入私人房间。 - 重载 或重启以应用更改。
⚙️ 配置
编辑 plugins/MatrixChat/config.yml 以连接你的世界。
matrix:
# ? 你的 Matrix 家庭服务器 URL
homeserver: "https://chat.yourdomain.com"
# ? Bot 账号
# 重要:必须是 Synapse 管理员才能使模拟功能正常工作。
username: "@bot:chat.yourdomain.com"
password: "your_secure_password"
# ? 桥接房间
# 共享聊天的主频道。bot 必须是该房间的成员。
bridgeRoom: "!roomid:chat.yourdomain.com"
# ? 要桥接到 Minecraft 的最大 Matrix 消息长度。
maxMessageLength: 256
# ? 基岩版支持
bedrock:
prefix: "."
matrixSuffix: ".b"
# ? 公告
announcements:
join: true
quit: true
death: true
firstJoin: true
# ? 房间管理
rooms:
# 所有人自动加入的房间
default:
- "!generalid:chat.yourdomain.com"
- "!updatesid:chat.yourdomain.com"
# ? 基于角色的房间
# 将权限节点映射到特定房间
roles:
mchat.group.staff:
- "!staffroomid:chat.yourdomain.com"
mchat.group.vip:
- "!viproomid:chat.yourdomain.com"
? 命令与权限
| 命令 | 权限 | 描述 |
|---|---|---|
/mchat register <password> |
mchat.register |
设置自动创建的 Matrix 账号的密码,允许你登录 Element 等客户端。 |
/mchat help |
None | 显示帮助菜单。 |
? 工作原理
模拟魔法
此插件不像是 [Bot] Player: Hello 那样中继消息,而是利用 Synapse Admin API。它为特定用户获取临时登录令牌,并以他们的名义发送消息。
- 结果:原生的聊天体验。
- 回退:如果用户未注册,它将优雅地回退到机器人消息格式。
回声防止
为了防止消息重复的“无限循环”,插件会为桥接的消息添加隐藏的 [MC] 前缀标签。Minecraft 监听器检测到这个标签后会知道忽略该消息,从而确保聊天流的干净。
?️ 从源代码构建
git clone https://github.com/yourusername/matrix-chat.git
cd matrix-chat
mvn clean package
? 许可证
根据 MIT License 分发。有关更多信息,请参阅 LICENSE。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧