概览
BedrockBridge 是一款 Fabric 模组,允许你的 移动设备、主机或 Windows 10/11 上的基岩版好友通过勾选一个复选框即可加入你的单人 Java 版世界。无需配置路由器,也无需为他们安装额外软件。
工作原理
当你开启局域网并勾选“与基岩版共享”时,BedrockBridge 会自动执行以下操作:
- 启动 Geyser 以在 Java 版和基岩版协议之间进行转换
- 启动 Floodgate,使基岩版玩家无需 Java 版账户即可加入
- 创建 Playit.gg UDP 隧道,在不进行端口映射的情况下将你的世界暴露给互联网
聊天栏中会显示一个公共地址,例如 means-confidentiality.gl.at.ply.gg:6740。你的朋友只需将其粘贴到 Minecraft 基岩版 > 服务器 > 添加服务器 中,即可加入游戏。
要停止使用:只需关闭世界或保存并退出即可。BedrockBridge 会自动关闭所有相关服务。
快速开始
- 下载 BedrockBridge 并将其 .jar 文件放入
mods/ 文件夹
- 同样将 Fabric API 添加到
mods/ 文件夹中
- 使用 Fabric 配置文件启动 Minecraft
- 加载你的世界 > 按 Esc > 开放给局域网 > 勾选“与基岩版共享” > 启动局域网世界
- 复制聊天栏中的地址并发送给你的朋友
- 他们在基岩版中打开 > 服务器 > 添加服务器,粘贴地址并加入
(你可以随时使用 “B” 键隐藏服务器名称并编辑绑定按键)
首次启动: BedrockBridge 会自动下载 Geyser、Floodgate 和 Playit 代理(总计约 25 MB,仅一次性)。你将在聊天栏中看到 playit.gg/claim/... 链接——打开它并点击“Add Agent”以激活你的免费隧道。
要求
- Minecraft Java 1.26.1.2 (别名 26.1.2)
- Fabric Loader 0.19.2 或更高版本
- Java 25 运行时
- Fabric API
互联网隧道的支持平台:
- Linux x86_64 和 aarch64(树莓派 4+ 等)
- Windows x86_64
- macOS:尚不支持隧道功能(但 Geyser 和 Floodgate 仍可用于本地局域网)
故障排除
聊天栏中从未显示公网地址
请从聊天栏中打开 Playit 认领链接,然后点击“Add Agent”。在隧道创建完成后,端点将会出现。
移动端几秒后出现“Host disconnect”
你可能正在运行 VPN(如 Cloudflare WARP、Proton Free 等)——这些 VPN 会丢弃 UDP 数据包。请禁用它们或使用真实移动数据测试。
Playit API HTTP 401:未授权
密钥已损坏。删除 <gameDir>/bedrockbridge/playit.toml 并重新开启局域网以重新认领。
想要切换 Playit 账户
删除 <gameDir>/bedrockbridge/playit.toml 并重新开启局域网。
致谢
BedrockBridge 起到粘合剂的作用。核心工作由以下项目完成:
- GeyserMC/Geyser (MIT) -- 基岩版到 Java 版的协议转换
- GeyserMC/Floodgate (MIT) -- 无需 Java 账号的基岩版玩家认证
- playit-cloud/playit-agent (BSD-2) -- 无需端口映射即可将 UDP 流量穿透至互联网的隧道
- API 客户端架构 改编自 maxomatic458/playit-minecraft-mod (BSD-2, 已归档)。
本项目基于 MIT 许可证 发布 —— 欢迎自由修改
免责声明
BedrockBridge 与 GeyserMC、Floodgate 或 Playit.gg 无关,未获得其认可或赞助。所有商标和项目名称均归其各自所有者所有。
Overview
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:
- Starts Geyser to translate between Java and Bedrock protocols
- Starts Floodgate so Bedrock players can join without a Java account
- 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
- Download BedrockBridge and drop the .jar into your
mods/ folder
- Add Fabric API to
mods/ as well
- Launch Minecraft with the Fabric profile
- Load your world > Esc > Open to LAN > tick "Share with Bedrock" > Start LAN World
- Copy the address from chat and send it to your friend
- 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 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧