BedrockBridge

概览

BedrockBridge 是一款 Fabric 模组，让你的基岩版好友（手机、主机或 Windows 10/11）只需勾选一个选项，就能加入你的单人 Java 版世界。无需配置路由器，他们也不需要额外安装软件。

---

工作原理

当你勾选“与基岩版共享”并开启局域网世界时，BedrockBridge 会自动执行以下操作：

1. 启动 Geyser，在 Java 版和基岩版协议之间进行翻译
2. 启动 Floodgate，让基岩版玩家无需 Java 账号即可加入
3. 创建一个 Playit.gg UDP 隧道，将你的世界暴露到互联网，无需端口转发

聊天框中会显示一个类似 means-confidentiality.gl.at.ply.gg:6740 的公共地址。你的好友将它粘贴到 Minecraft 基岩版 > 服务器 > 添加服务器 中，即可加入游戏。

停止时：只需关闭世界或保存并退出。BedrockBridge 会自动关闭所有相关服务。

---

快速上手

1. 下载 BedrockBridge 并将 .jar 文件放入你的 mods/ 文件夹
2. 同时将 Fabric API 添加至 mods/ 文件夹
3. 使用 Fabric 配置文件启动 Minecraft
4. 加载你的世界 > 按 Esc > 对局域网开放 > 勾选“与基岩版共享” > 开启局域网世界
5. 从聊天框中复制地址并发送给你的好友
6. 好友打开基岩版 > 服务器 > 添加服务器，粘贴地址并加入

（你可以按“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”。隧道创建后，端点地址就会显示出来。

移动设备上几秒后出现“主机断开连接” 你很可能正在运行 VPN（如 Cloudflare WARP、Proton 免费版）——这些 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 无任何关联、认可或赞助关系。所有商标和项目名称均归其各自所有者所有。