如何在您的 Minecraft 服务器上安装 Geyser 和 Floodgate

Geyser 允许基岩版玩家加入 Java 版 Minecraft 服务器。通常会安装 Floodgate，以便基岩版玩家无需 Java 版账户即可加入。如果您还没有服务器，可以从我们的网站获取 Minecraft 服务器托管。

本指南适用于基于插件的 Minecraft 服务器，例如 Paper、Purpur 或 Spigot。如果您正在运行 Forge、Fabric、NeoForge 或模组包，请在进行更改之前检查您的设置是否支持您要使用的 Geyser 版本。

开始之前

1. 在控制面板中打开您的 Minecraft 服务器。
2. 在更改文件之前停止服务器并进行备份。
3. 确保您的服务器正在使用 Paper、Purpur、Spigot 或其他兼容插件的服务器类型。

如果需要更改服务器类型，请打开版本，选择 Paper，然后选择您要安装的 Minecraft 版本。

除非您想清空服务器，否则不要勾选删除文件框。

检查您的基岩端口

Geyser 需要一个端口供基岩玩家连接。打开网络并使用那里显示的额外分配之一。基岩通常使用 UDP 端口 19132，但在面板上您应该使用分配给您服务器的额外端口。如果没有备用端口，请点击创建分配以添加另一个。

下载 Geyser 和 Floodgate

1. 从 GeyserMC 下载页面下载 Geyser Spigot 插件。
2. 从同一下载页面下载 Floodgate Spigot 插件。
3. 您也可以使用 Geyser 和 Floodgate 的直接下载链接。
4. 将两个文件保留为 .jar 文件。不要解压它们。

上传插件文件

1. 在控制面板中打开文件。
2. 打开 plugins 文件夹。
3. 将 Geyser-Spigot.jar 和 floodgate-spigot.jar 上传到 plugins 文件夹中。

生成并编辑配置

1. 启动服务器并等待其加载完成。
2. 在创建 Geyser 和 Floodgate 文件夹后停止或重启服务器。
3. 在文件管理器中打开 plugins/Geyser-Spigot/config.yml。
4. 将基岩端口设置为您正在使用的额外分配，然后将 Java 身份验证类型设置为 Floodgate。

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

java:
  auth-type: floodgate

将 27147 替换为您在网络页面上使用的额外端口。这是基岩玩家在添加您的服务器时输入的端口。

启动并测试服务器

1. 保存配置文件。
2. 再次启动您的服务器。
3. 检查控制台中的 Geyser 和 Floodgate 启动消息。
4. Java 版玩家应继续使用您的正常服务器地址或子域。
5. 基岩版玩家应使用来自额外网络分配的 IP 地址和端口。面板子域仅指向您的主要分配。

如果基岩玩家无法连接，请检查 config.yml 中的端口是否与网络页面上显示的额外端口相同，然后检查控制台中是否有任何 Geyser 或 Floodgate 错误。如果设置看起来正确但基岩连接仍然失败，请 提交支持票，以便我们可以从我们这边检查分配和端口。