Geyser 跨版本互通｜让基岩玩家加入 Java 服的入门指南

资源作者：GeyserMC 团队｜中文整理：方块社
本文依据当前官方文档独立整理，不是官方发布。本站未做游戏连接、性能或安全实测；请先在测试服核验。下载指向官方，不提供插件镜像。资料核验日期：2026-10-10。官方信息可能更新，请以实际下载版本为准。

官方图标与历史演示

GeyserMC 官方项目横幅

图标与横幅来自 GeyserMC 官方项目，用于识别所介绍的项目，不表示方块社与作者存在合作或背书。

GeyserMC 2023年官方博客中的基岩客户端游戏截图

官方历史演示：GeyserMC 项目负责人 RednedEpic 于 2023年7月8日发布的 Four Years of Geyser 中的游戏截图，展示当时 Fabric/Forge 自定义内容的预览。并非本站实测，也不代表所有模组当前均可互通。

朋友用电脑 Java 版，而你用手机基岩版，这时两边通常不能直接加入同一台 Java 服务器。Geyser 位于连接链路中，将基岩客户端协议转换为 Java 服务器能理解的形式，让不同平台的玩家有机会一起游玩。

它不是把 Java 模组自动转换成基岩 Addon 的工具，也不是让 Java 与基岩所有机制完全相同。涉及客户端模组、自定义内容、反作弊、物品交互的服务器，都需要另行检查官方限制与兼容说明。

项目	当前官方文档说明
基岩客户端	当前支持 26.30～26.52；会随游戏更新变化
Geyser 模拟的 Java 协议	Java 26.2
Paper / Spigot 插件方式	Geyser-Spigot，服务器 1.20.5 或以上，Java 21+
低于 1.20.5 的服务端	使用官方支持的代理 / Standalone / ViaProxy 路线；按协议需求配置 ViaVersion
下载版本	以官方页面当前构建为准，本文不固定过期构建号

这是一份核验时的官方文档快照，不是永远有效的兼容承诺。Geyser-Spigot 不能因为安装 ViaVersion 就直接放进所有旧服务端：官方说明低于 1.20.5 的服务器需要选择代理、Standalone 或 ViaProxy 等路线。

安装前请查看当前版本支持表，同时满足服务端、Java 运行环境和各插件自己的版本要求。

以下针对符合官方要求的 Paper / Spigot 服务器；代理网络与模组服不要照套：

基岩监听的常见配置入口如下，只展示相关片段，不是完整配置文件：

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

端口应按主机分配调整。0.0.0.0 是监听地址，不是发给玩家的连接地址；玩家应填写你的服务器域名或公网 IP。若启用 clone-remote-port，实际基岩端口会受到 Java 端口设置影响。

官方提供控制台连接检查入口：

geyser connectiontest <公网地址> <基岩端口>

请替换占位内容后使用，并结合启动日志及官方 Common Issues 排查。

Geyser 负责协议桥接；Floodgate 解决基岩账号进入 Java 服务端时的身份接入问题。若希望基岩玩家无需另有 Java 账号，官方推荐参考 Floodgate 的安装与认证配置。

**不要为了“能连接”就随意关闭认证或公开后端端口。**Floodgate 不是绕过正版基岩身份验证的通用免登录插件。代理转发、身份配置和密钥应依官方文档设置，密钥不要贴到帖子或公开仓库里。

本文为方块社依据官方资料独立整理的入门指南。软件 MIT 许可不自动覆盖其他人的翻译与截图；软件复制或分发须保留相应版权及许可声明。欢迎在讨论区补充你的测试环境和实际问题，但请勿发布账号凭据或服务器密钥。