实战记录：搭建 Minecraft 基岩版与 Java 版互通服务器踩坑指南

大家好，我是 33blog 的小编。最近有个朋友想开个 MC 服务器，但团队里既有 Java 版玩家又有基岩版玩家，于是找我帮忙搭建互通服务器。折腾了两天终于搞定，过程中踩了不少坑，今天就把完整流程和注意事项分享给大家。

一、准备工作

首先明确需求：我们需要一个能让 Java 版和基岩版玩家同时进入的服务器。经过调研，目前最成熟的方案是使用 GeyserMC + Floodgate 组合。

需要准备的：

• 一台性能足够的服务器（建议至少 2核4G）
• Java 版服务端（我用的 PaperMC 1.20.1）
• GeyserMC 插件
• Floodgate 插件（可选，用于基岩版玩家免验证登录）

二、安装 Java 版服务端

这部分比较常规，但有个坑要注意：

# 下载 PaperMC
wget https://papermc.io/api/v2/projects/paper/versions/1.20.1/builds/100/downloads/paper-1.20.1-100.jar -O server.jar

# 首次运行
java -Xms2G -Xmx2G -jar server.jar nogui

第一次运行会生成 eula.txt，记得修改 eula=true。我刚开始就忘了这步，结果服务器一直启动失败，排查了半天才发现…

三、配置 GeyserMC

把下载的 Geyser 插件放到 plugins 文件夹后重启服务器。关键的配置在 plugins/Geyser-Spigot/config.yml：

# 允许基岩版玩家连接
bedrock:
  address: 0.0.0.0
  port: 19132
  
# 与 Java 版服务端通信
remote:
  address: 127.0.0.1
  port: 25565

这里有个坑：如果服务器有防火墙，一定要开放 UDP 19132 端口（基岩版默认用 UDP）。我一开始只开了 TCP，基岩版死活连不上，后来用 netstat -tulnp 检查才发现问题。

四、Floodgate 免验证配置（可选）

如果不想让基岩版玩家每次都输入正版验证，可以安装 Floodgate。配置很简单：

1. 把插件放入 plugins 文件夹
2. 修改 config.yml 中的 auth-type 为 floodgate

不过要注意：这样基岩版玩家的用户名会带前缀（如 *玩家名），某些插件可能需要额外适配。

五、实测效果与优化建议

最终测试结果：

• Java 版延迟 50ms 左右
• 基岩版延迟 80-120ms（跨平台转发有额外开销）
• 10人同时在线 CPU 占用约 30%

几个优化建议：

1. 安装 ViaVersion 插件支持多版本
2. 基岩版玩家建议关闭视野调整（性能影响较大）
3. 定期备份 world 文件夹（互通服务端偶尔会出幺蛾子）

六、常见问题排查

最后分享几个我遇到的典型问题：

基岩版能连但马上断开

检查 Geyser 和 Floodgate 版本是否匹配，我遇到过插件版本冲突导致的问题

玩家位置不同步

尝试关闭服务端的 anti-xray 插件，某些防护插件会影响位置同步

如果还有其他问题，欢迎在评论区交流。搭建过程虽然折腾，但看到不同平台的玩家能一起玩耍，还是挺有成就感的！