Matrix Chat Bridge

插件

· 作者 Sovtoshi

一个强大、私密且安全的桥梁,连接你的 Minecraft 服务器和 Matrix 家庭服务器。提供类似 Discord 的自托管体验。

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

最新 1.0 · 1.21.11 · Paper

一键开服(送7天)

? Minecraft Matrix Chat Bridge

一个强大的、私密且安全的桥梁,连接你的 Minecraft 服务器与 Matrix 家庭服务器(Homeserver)。


?️ 为什么选择 Matrix?

在这个数据隐私和用户安全至关重要的时代,Matrix 成为游戏社区的首选方案。与 Discord 或其他集中式平台不同,Matrix 允许你:

  • 拥有你的数据:自行托管服务器。没有任何第三方在挖掘玩家的聊天记录。
  • 确保安全:创建一个私密的隔离环境,适合所有年龄段的玩家。你控制谁能加入以及他们能看到什么。
  • 保持安全:行业标准的加密和开源透明度。

该插件将你的 Minecraft 服务器直接集成到这个安全生态系统中,提供无缝的体验,使其在两个平台上都感觉像原生应用一样。


✨ 主要功能

  • ? 双向聊天桥接

    • 消息在 Minecraft 和 Matrix 之间即时流动。
    • 无论是在游戏中还是在手机上,都能体验统一的社区氛围。
  • ? 真正的用户模拟(Impersonation)

    • 忘掉那些通用的机器人消息吧!
    • 当玩家在游戏中的聊天框发言时,Matrix 中的消息看起来是来自他们的实际账号,包括他们的头像和名字。
  • ? 自动注册与同步

    • 自动创建账号:每次有玩家首次加入服务器时,都会自动为其创建一个无需密码的 Matrix 账号。
    • 自动头像同步:每次玩家加入时,插件会检查玩家皮肤是否更改,并相应地更新其 Matrix 头像。
    • 自动房间同步:每次玩家加入时,根据其权限自动将其添加到正确的 Matrix 房间中。
  • ? 基于角色的访问控制

    • 根据游戏中的权限(例如 VIP、工作人员)自动管理房间成员资格。
    • 无需手动邀请;插件会自动处理繁重的管理工作。
  • ? 基岩版玩家支持

    • 通过为基岩版玩家(例如来自 Geyser 的玩家)的用户名添加可配置的后缀来区分他们(例如 .Steve 变为 steve.b)。
  • ?️ 轻量级且原生

    • 使用原始 Matrix/Synapse API 构建。
    • 零外部依赖或臃肿的库。

?️ 前置条件

  • Minecraft Server:Spigot、Paper 或 Purpur(1.20.6 或更高版本)。
  • Matrix Homeserver:一个 Synapse 服务器,且你拥有管理员访问权限。
  • Bot Account:一个在你的家庭服务器上具有 管理员特权 的 Matrix 账号(用于模拟身份和管理用户)。

? 安装

  1. 下载 发布页面中最新的 matrix-chat-1.0.jar。
  2. 放置 jar 文件到你的服务器的 plugins 文件夹中。
  3. 重启 服务器以生成默认配置文件。
  4. 配置 plugins/MatrixChat/config.yml(见下文)。
  5. 重要:手动将你的 bot 账号邀请到配置的 bridgeRoom 以及配置文件中列出的任何其他房间。如果没有邀请,bot 无法自动加入私人房间。
  6. 重载 或重启以应用更改。

⚙️ 配置

编辑 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。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源