BedrockBridge

## Overview <p align="center"> <img src="https://raw.githubusercontent.com/folxxsreal/bedrockbridge/refs/heads/main/src/main/resources/assets/bedrockbridge/icongithub.png" alt="BedrockBridge" width="480"> </p> **BedrockBridge** is a Fabric mod that lets your Bedrock friends on **mobile, console, or Windows 10/11** join your single-player Java world with a single checkbox. No router configuration. No extra software for them. --- ## How it works When you open your world to LAN with "Share with Bedrock" ticked, BedrockBridge automatically: 1. Starts **Geyser** to translate between Java and Bedrock protocols 2. Starts **Floodgate** so Bedrock players can join without a Java account 3. Creates a **Playit.gg UDP tunnel** that exposes your world to the internet without port-forwarding A public address like `means-confidentiality.gl.at.ply.gg:6740` appears in your chat. Your friend pastes it into **Minecraft Bedrock > Servers > Add Server** and they are in. To stop: just close the world or Save and Quit. BedrockBridge shuts everything down automatically. --- ## Quick Start 1. Download BedrockBridge and drop the .jar into your `mods/` folder 2. Add **Fabric API** to `mods/` as well 3. Launch Minecraft with the Fabric profile 4. Load your world > Esc > Open to LAN > tick "Share with Bedrock" > Start LAN World 5. Copy the address from chat and send it to your friend 6. They open Bedrock > Servers > Add Server, paste the address, and join (You can hide the server name with "**B**" and edit the keybind at any time) **First launch:** BedrockBridge downloads Geyser, Floodgate, and the Playit agent automatically (~25 MB total, one time only). You will see a playit.gg/claim/... link in chat -- open it and click "Add Agent" to activate your free tunnel. --- ## Requirements - Minecraft Java 1.26.1.2 (alias 26.1.2) - Fabric Loader 0.19.2 or newer - Java 25 runtimeproject - Fabric API **Supported platforms for the internet tunnel:** - Linux x86_64 and aarch64 (Raspberry Pi 4+, etc.) - Windows x86_64 - macOS: not supported for the tunnel yet (Geyser and Floodgate still work for local LAN) --- ## Troubleshooting **The public address never shows up in chat** Open the Playit claim link from chat and click "Add Agent". The endpoint appears after the tunnel is created. **"Host disconnect" on mobile after a few seconds** You likely have a VPN (Cloudflare WARP, Proton free) running -- those VPNs drop UDP packets. Disable it or test with real mobile data. **Playit API HTTP 401: not authorized** The secret is corrupt. Delete `<gameDir>/bedrockbridge/playit.toml` and reopen LAN to re-claim. **Want to switch Playit accounts** Delete `<gameDir>/bedrockbridge/playit.toml` and reopen LAN. --- ## Credits BedrockBridge is the glue. The heavy lifting is done by: - **GeyserMC/Geyser** (MIT) -- Bedrock to Java protocol translation - **GeyserMC/Floodgate** (MIT) -- authentication for Bedrock players without a Java account - **playit-cloud/playit-agent** (BSD-2) -- UDP tunnel to the internet without port-forwarding - **API client schema** adapted from (https://github.com/maxomatic458/playit-minecraft-mod) (BSD-2, archived). Released under **MIT License** -- modify freely if you want ## Disclaimer BedrockBridge is not affiliated with, endorsed by, or sponsored by GeyserMC, Floodgate, or Playit.gg. All trademarks and project names belong to their respective owners.