Mutualzz Bridge

插件

· 作者 AzraelMeow

将你的 Paper Minecraft 服务器与 Mutualzz 连接——实现 Discord 和 Mutualzz 应用中的聊天、账号绑定以及语音状态同步。

0 本站下载 0 关注 更新于 1 周前

最新 1.4.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

Mutualzz Bridge(服务器插件)

将你的 Paper Minecraft 服务器连接到 Mutualzz —— 实现与 Discord 及 Mutualzz 应用的聊天、账号绑定和语音状态同步。

一个插件 jar 文件即支持 Paper/Spigot 1.18.2 至最新版本(包括 Paper 26.x)。游戏内麦克风/扬声器仍需匹配玩家 Minecraft 版本和加载器(Fabric、NeoForge 或 Forge)的 Mutualzz Voice 客户端 jar。

玩家可以:

  • 绑定他们的 Mutualzz 账号(/mzlink)
  • 与 Discord / Mutualzz 应用共享聊天内容
  • 在游戏内加入 Mutualzz 语音频道(/mzvoice)

游戏内 麦克风和扬声器 需要每位玩家的客户端安装 Mutualzz Voice 模组 —— jar 文件必须与其 MC 版本 + 加载器 匹配(Fabric / NeoForge / Forge)。仅状态同步的语音无需此模组即可工作。

该插件通过 Mutualzz 托管的桥接中心 进行通信。你无需自行运行桥接中心。


许可证与再分发

源代码可供公开查阅,以保障透明度并促进 社区贡献。但这 不代表 允许再分发构建版本。

你可以:

  • 在 Paper 服务器上安装官方构建版本,并使用你的桥接令牌连接至 Mutualzz
  • Fork 仓库并提交拉取请求 —— 贡献者将获得署名(参见 CONTRIBUTING.md)

未经 Mutualzz 书面许可,你不得:

  • 重新上传或分享通用用途的 jar 文件 / 非官方构建版本
  • 将其发布到 Modrinth、CurseForge、GitHub Releases 等平台供他人安装
  • 运营或售卖第三方 “兼容 Mutualzz” 的桥接中心

详见 LICENSE。如需合作权限,请联系 mutualzz.com。


所需环境

服务器 Paper(或兼容核心)1.18.2+ —— 重点测试版本:1.18.2、1.21.x、26.x
Java 17+(该 MC 版本线对 Paper 的要求;较新的 Paper 需要 21/25)
Mutualzz 拥有“管理空间”权限的 空间,并在 空间设置 → Minecraft 桥接 中创建了桥接,且拥有 桥接令牌
可选 已在 Mutualzz 中关联 Discord;语音房间已绑定至此服务器

安装(服务器管理员)

1. 在 Mutualzz 中创建桥接

  1. 打开 Mutualzz → 进入目标空间 → 空间设置 → Minecraft 桥接。
  2. 创建桥接并复制 令牌(以 mz_bridge_… 开头)。
  3. 选择一个 服务器 ID(例如 survival)—— 在 Mutualzz 中绑定 Discord 频道和语音房间时需使用相同 ID。

2. 添加插件

  1. 从 Modrinth 下载官方桥接 jar,或从 Mutualzz GitHub Release 中下载标题为 Mutualzz Minecraft v…(标签 minecraft-v…)的版本 —— 请勿使用非官方镜像。同一 GitHub 发布页还包含支持客户端版本的 Voice 模组 jar。
  2. 将 mutualzz-bridge-*.jar 放入服务器的 plugins 文件夹。
  3. 启动(或重启)服务器一次,以便生成配置文件夹。

3. 配置

编辑 plugins/MutualzzBridge/config.yml:

# 官方 Mutualzz 桥接中心 —— 保持原样
hubUrl: wss://bridge.mutualzz.com

# 粘贴来自 Mutualzz 设置的令牌
token: mz_bridge_your_token_here

# 与你在 Mutualzz 中绑定 Discord / 语音时使用的 ID 一致
serverId: survival

4. 重启并完成 Mutualzz 中的设置

  1. 保存配置后重启服务器。
  2. 在 Mutualzz 中,打开此空间的 空间设置 → Minecraft 桥接:
    • 关联 Discord(如使用)
    • 将聊天 / 语音房间绑定到此 serverId
  3. 服务器端设置完毕。

5. 玩家操作

  1. 加入 Minecraft 服务器。
  2. 执行 /mzlink 并输入来自 Mutualzz 的代码(或直接 /mzlink <code>)。
  3. 语音:/mzvoice join 或 /mzvoice join <room> —— 退出请使用 /mzvoice leave。
  4. 若要在游戏内 听到他人声音,请为 你的 Minecraft 版本和加载器 安装 Mutualzz Voice jar(Fabric 需在 26.1.2 上安装 Fabric API + Amecs;NeoForge/Forge 则不需要)。

游戏内语音默认按键为 Alt(而非 Ctrl)—— 例如 Alt+O 打开设置、Alt+M 静音、按住 V 为按键说话。完整列表见:Mutualzz Voice 控制键。


命令

命令 适用对象 功能说明
/mzlink 玩家 开始绑定 Mutualzz 账号
/mzlink <code> 玩家 使用来自 Mutualzz 的代码完成绑定
/mzvoice join [room] 玩家 加入 Mutualzz 语音(若无 room 则加入默认频道)
/mzvoice leave 玩家 离开 Mutualzz 语音

权限(默认:所有人均可使用):

  • mutualzz.bridge.link
  • mutualzz.bridge.voice

检查清单

  • Paper/Spigot 1.18.2+(Java 17+)
  • 官方插件 jar 已放入 plugins/ 目录
  • config.yml 中包含 hubUrl: wss://bridge.mutualzz.com、你的 token 和 serverId
  • 编辑配置后已重启服务器
  • Mutualzz 中显示桥接已连接
  • Discord / 语音房间已绑定到此 serverId(如使用)
  • 玩家已通过 /mzlink 完成绑定
  • (可选)玩家已为其 MC 版本 + 加载器安装了 Mutualzz Voice 模组以实现游戏内音频

故障排除

  • 桥接无法连接 —— 检查令牌是否正确,以及服务器能否访问 wss://bridge.mutualzz.com(出站 WebSocket)。
  • 插件启用时自动禁用 —— 服务器版本低于 1.18.2。
  • 聊天未出现在 Discord 中 —— 请在 Mutualzz 中将 Discord 频道绑定到此桥接的 serverId。
  • /mzvoice 提示未绑定 —— 玩家需先执行 /mzlink。
  • 已加入语音但在 Minecraft 中无声 —— 未安装 Mutualzz Voice 模组,或安装的 jar 与客户端的 MC 版本 + 加载器不匹配。
  • serverId 错误 —— 必须与你在 Mutualzz 中绑定房间时设置的值一致。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源