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

Install (server owners)

1. Create a bridge in Mutualzz

1. Open Mutualzz → User Settings → Minecraft Bridge (or your space’s bridge settings).
2. Create a bridge and copy the token (starts with mz_bridge_…).
3. Choose a server ID (e.g. survival) — use the same ID when binding Discord channels and voice rooms in Mutualzz.

2. Add the plugin

1. Download the official mutualzz-bridge-1.0.0.jar from Mutualzz (not third-party mirrors).
2. Drop it into your server’s plugins folder.
3. 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

1. Restart the server after saving config.
2. In Mutualzz, open Minecraft Bridge for this bridge:
   • Link Discord (if you use it)
   • Bind chat / voice rooms to this serverId
3. You’re done on the server side.

5. Players

1. Join the Minecraft server.
2. Run /mzlink and enter the code from Mutualzz (or /mzlink <code>).
3. Voice: /mzvoice join or /mzvoice join <room> — leave with /mzvoice leave.
4. For hearing people in-game, install the Mutualzz Voice Fabric mod (plus Fabric API and Amecs).

Commands

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.