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 中创建桥接
- 打开 Mutualzz → 进入目标空间 → 空间设置 → Minecraft 桥接。
- 创建桥接并复制 令牌(以
mz_bridge_…开头)。 - 选择一个 服务器 ID(例如
survival)—— 在 Mutualzz 中绑定 Discord 频道和语音房间时需使用相同 ID。
2. 添加插件
- 从 Modrinth 下载官方桥接 jar,或从 Mutualzz GitHub Release 中下载标题为 Mutualzz Minecraft v…(标签
minecraft-v…)的版本 —— 请勿使用非官方镜像。同一 GitHub 发布页还包含支持客户端版本的 Voice 模组 jar。 - 将
mutualzz-bridge-*.jar放入服务器的plugins文件夹。 - 启动(或重启)服务器一次,以便生成配置文件夹。
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 中的设置
- 保存配置后重启服务器。
- 在 Mutualzz 中,打开此空间的 空间设置 → Minecraft 桥接:
- 关联 Discord(如使用)
- 将聊天 / 语音房间绑定到此
serverId
- 服务器端设置完毕。
5. 玩家操作
- 加入 Minecraft 服务器。
- 执行
/mzlink并输入来自 Mutualzz 的代码(或直接/mzlink <code>)。 - 语音:
/mzvoice join或/mzvoice join <room>—— 退出请使用/mzvoice leave。 - 若要在游戏内 听到他人声音,请为 你的 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.linkmutualzz.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 中绑定房间时设置的值一致。
Mutualzz Bridge (server plugin)
Connects your Paper Minecraft server to Mutualzz — chat, account linking, and voice presence with Discord and the Mutualzz app.
One plugin jar supports Paper/Spigot 1.18.2 through current (including Paper 26.x). In-game mic/speakers still need a Mutualzz Voice client jar matching the player’s Minecraft version and loader (Fabric, NeoForge, or Forge).
Players can:
- Link their Mutualzz account (
/mzlink) - Share chat with Discord / the Mutualzz app
- Join Mutualzz voice from in-game (
/mzvoice)
In-game mic and speakers need the Mutualzz Voice mod on each player’s client — the jar must match their MC version + loader (Fabric / NeoForge / Forge). Presence-only voice works without the mod.
The plugin talks to Mutualzz’s hosted bridge hub. You do not run your own hub.
License & redistribution
Source is available for transparency and community contributions. That is not permission to redistribute builds.
You may:
- Install official builds on your Paper server and connect them to Mutualzz with your bridge token
- Fork the repo and open pull requests — contributors get credit (see
CONTRIBUTING.md)
You may not (without written permission from Mutualzz):
- Re-upload or share general-purpose jars / unofficial builds
- Publish it on Modrinth, CurseForge, GitHub Releases, etc. for others to install
- Run or sell a third-party “Mutualzz-compatible” hub
See LICENSE. Contact mutualzz.com for partnership rights.
What you need
| Server | Paper (or compatible) 1.18.2+ — tested focus: 1.18.2, 1.21.x, 26.x |
| Java | 17+ (Paper’s requirement for that MC line; newer Paper needs 21/25) |
| Mutualzz | A space with Manage Space permission, and a bridge created under Space Settings → Minecraft Bridge, with a bridge token |
| Optional | Discord linked in Mutualzz; voice rooms bound to this server |
Install (server owners)
1. Create a bridge in Mutualzz
- Open Mutualzz → open the space → Space Settings → Minecraft Bridge.
- Create a bridge and copy the token (starts with
mz_bridge_…). - Choose a server ID (e.g.
survival) — use the same ID when binding Discord channels and voice rooms in Mutualzz.
2. Add the plugin
- Download the official bridge jar from Modrinth or the Mutualzz GitHub Release titled Mutualzz Minecraft v… (tag
minecraft-v…) — not unofficial mirrors. The same GitHub release includes the Voice mod jar(s) for supported client versions. - Drop
mutualzz-bridge-*.jarinto your server’spluginsfolder. - Start (or restart) the server once so it creates the config folder.
3. Configure
Edit plugins/MutualzzBridge/config.yml:
# Official Mutualzz hub — leave this as-is
hubUrl: wss://bridge.mutualzz.com
# Paste the token from Mutualzz settings
token: mz_bridge_your_token_here
# Same ID you use when binding Discord / voice in Mutualzz
serverId: survival
4. Restart and finish setup in Mutualzz
- Restart the server after saving config.
- In Mutualzz, open Space Settings → Minecraft Bridge for this space:
- Link Discord (if you use it)
- Bind chat / voice rooms to this
serverId
- You’re done on the server side.
5. Players
- Join the Minecraft server.
- Run
/mzlinkand enter the code from Mutualzz (or/mzlink <code>). - Voice:
/mzvoice joinor/mzvoice join <room>— leave with/mzvoice leave. - For hearing people in-game, install the Mutualzz Voice jar for your Minecraft version and loader (Fabric needs Fabric API + Amecs on 26.1.2; NeoForge/Forge do not).
In-game voice defaults use Alt (not Ctrl) — e.g. Alt+O settings, Alt+M mute, hold V for push-to-talk. Full list: Mutualzz Voice controls.
Commands
| Command | Who | What it does |
|---|---|---|
/mzlink |
Players | Start linking to Mutualzz |
/mzlink <code> |
Players | Finish linking with a code from Mutualzz |
/mzvoice join [room] |
Players | Join Mutualzz voice (default if no room) |
/mzvoice leave |
Players | Leave Mutualzz voice |
Permissions (default: everyone can use them):
mutualzz.bridge.linkmutualzz.bridge.voice
Checklist
- Paper/Spigot 1.18.2+ (Java 17+)
- Official plugin jar in
plugins/ -
config.ymlhashubUrl: wss://bridge.mutualzz.com, yourtoken, andserverId - Server restarted after editing config
- Bridge shows connected in Mutualzz
- Discord / voice rooms bound to this
serverId(if you use them) - Players linked with
/mzlink - (Optional) Players installed Mutualzz Voice for their MC version + loader for in-game audio
Troubleshooting
- Bridge won’t connect — Check the token is correct and the server can reach
wss://bridge.mutualzz.com(outbound WebSocket). - Plugin disables on enable — Server is older than 1.18.2.
- Chat doesn’t appear in Discord — Bind the Discord channel to this bridge’s
serverIdin Mutualzz. /mzvoicesays not linked — Player needs/mzlinkfirst.- Joined voice but silent in Minecraft — Expected without Mutualzz Voice, or with a jar that doesn’t match the client’s MC version + loader.
- Wrong
serverId— Must match what you set when binding rooms in Mutualzz.
下载 Mutualzz Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mutualzz Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mutualzz Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mutualzz Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mutualzz Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Mutualzz Bridge
下载 Mutualzz Bridge
下载 Mutualzz Bridge
下载 Mutualzz Bridge
下载 Mutualzz Bridge
Official Mutualzz Minecraft v1.4.0 - 查看 GitHub Release minecraft-v1.4.0。
官方 Mutualzz Minecraft v1.2.0 - 查看 GitHub Release minecraft-v1.2.0。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
插件
创建用户友好的菜单以前往不同的世界
插件
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
评论 0
登录后参与评分
还没有评论,来抢沙发吧