Mutualzz Bridge (server plugin)

Connects your Paper Minecraft server to Mutualzz — chat, account linking, and voice presence with Discord and the Mutualzz app.

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 Fabric mod on each player’s client. 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)

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 26.1.2 (or compatible 26.1.x)
Mutualzz	A bridge created in Mutualzz settings, 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 → User Settings → Minecraft Bridge (or your space’s bridge settings).
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 mutualzz-bridge-1.0.0.jar from Mutualzz (not third-party mirrors).
Drop it into your server’s plugins folder.
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 Minecraft Bridge for this bridge:
- 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 /mzlink and enter the code from Mutualzz (or /mzlink <code>).
Voice: /mzvoice join or /mzvoice join <room> — leave with /mzvoice leave.
For hearing people in-game, install the Mutualzz Voice Fabric mod (plus Fabric API and Amecs).

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.link
mutualzz.bridge.voice

Checklist

<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Paper 26.1.x
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Official plugin jar in plugins/
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> config.yml has hubUrl: wss://bridge.mutualzz.com, your token, and serverId
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Server restarted after editing config
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Bridge shows connected in Mutualzz
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Discord / voice rooms bound to this serverId (if you use them)
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Players linked with /mzlink
<input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> (Optional) Players installed Mutualzz Voice 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).
Chat doesn’t appear in Discord — Bind the Discord channel to this bridge’s serverId in Mutualzz.
/mzvoice says not linked — Player needs /mzlink first.
Joined voice but silent in Minecraft — Expected without the Mutualzz Voice client mod.
Wrong serverId — Must match what you set when binding rooms in Mutualzz.