跨平台联机选项卡：Geyser、Floodgate、Via 和基岩版玩家

Minecraft 跨平台联机服务器运行带有 Geyser 和 Floodgate 的 Paper，因此 Java 版和基岩版玩家（手机、平板电脑、游戏机和 Windows）可以在同一个世界中玩游戏。跨平台联机选项卡将这些部分集中在一个地方进行更新。本指南解释了该选项卡的功能、基岩版玩家在哪里找到您的地址和端口，以及如何将基岩版玩家添加到您的白名单。

刚接触跨平台联机？请从Minecraft 跨平台联机入门开始。

在哪里找到它

打开您的服务器并在侧边栏的 Minecraft 下选择跨平台联机。该选项卡位于 Minecraft 跨平台联机服务器上。如果您自己将 Geyser 添加到其他服务器类型，您将看不到它；上面的入门指南解释了该设置。

顶部，跨平台联机工具包显示服务器是否正在运行。大多数更新需要停止服务器：当它运行时，选项卡会显示并使这些按钮保持灰色。当没有人玩游戏时，从控制台停止服务器，然后返回。

选项卡上的内容

每一行都显示您服务器上的版本和可用的最新版本，带有一个更新按钮（如果您的服务器上尚未安装，则为安装）。您首先会被问到这将替换磁盘上的文件。继续吗？。之后您会看到更新已应用。重启服务器以加载新版本。

更新 Geyser 和 Floodgate

保持这两个最新：玩家设备上的新基岩版通常需要新的 Geyser。

1. 停止服务器。
2. 点击 Geyser 上的更新，然后点击 Floodgate 上的更新。
3. 再次启动服务器。

新文件在旧文件被删除之前下载，因此下载失败不会让您没有 Geyser。

Via 插件

ViaVersion、ViaBackwards 和 ViaRewind 允许其他 Minecraft 版本的玩家加入。该选项卡安装与您服务器的 Minecraft 版本兼容的最新版本（兼容版本）。这三个插件是相互关联的：当您更新其中一个时，您已有的其他插件也会更新到匹配的版本。您没有的插件永远不会单独添加。

当您的服务器运行的 Minecraft 版本比 Geyser 构建的版本旧时，ViaVersion 也有助于基岩版玩家。如果选项卡建议安装它，请执行此操作。

更新 Paper

Paper 服务器上的更新将您的服务器移动到最新的 Paper。以前的 jar 文件将保留为 .bak 文件。服务器必须停止。

在将 Paper 更新到新的 Minecraft 版本之前，请阅读此内容：

• 首先检查 Geyser 是否支持它。基岩版玩家只有在 Geyser 支持您服务器的 Minecraft 版本后才能加入。在新的 Minecraft 发布后，这可能需要一点时间。首先更新 Geyser，并在将 Paper 移动到全新版本之前检查 geysermc.org 上支持的版本。
• 世界无法回溯到旧版本。一旦服务器在新 Minecraft 上运行了您的世界，它就无法在旧版本上运行。选项卡拒绝安装比您的世界旧的 Paper，因此请先进行备份。请参阅备份您的服务器。

高级：固定到特定 Minecraft 版本允许您从 Minecraft version 中选择一个 Paper 版本并点击安装。相同的规则适用。

基岩版设置需要注意

有时选项卡会显示基岩版设置需要注意，每个项目旁边都有一个一键式按钮：

如果您有意以不同方式设置它，则可以忽略某个项目。修复后重启服务器。

基岩版地址和端口

基岩版玩家无法使用您的子域名，因此他们总是将地址和端口输入到两个单独的字段中。

1. 打开概览选项卡。基岩版 / 游戏机（跨平台联机）框显示基岩版玩家的服务器地址和端口。
2. 在 Minecraft 基岩版中，玩家前往游戏，然后是服务器，然后是添加服务器，并准确输入显示的地址和端口。

基岩版端口通常与您的 Java 端口不同。在网络选项卡中，它带有基岩版标签和锁：它保留给基岩版玩家，不能删除或设为主要，并且不计入您的端口限制。

NetherNet。自基岩版 26.60（2026 年 10 月 27 日）以来，基岩版玩家通过 Mojang 的 NetherNet 连接。在 Minecraft 跨平台联机服务器上，我们通过服务器的启动为您设置了此功能，因此您无需在跨平台联机选项卡或 Geyser 的 config.yml 中更改任何内容。如果您的服务器页面顶部通知显示 Geyser 已过期，或者您的基岩版端口正在设置中，请按照其说明操作：通常这意味着在此处更新 Geyser 并重启。更多详细信息请参见Minecraft 跨平台联机入门。

将基岩版玩家添加到白名单

基岩版玩家拥有玩家代号而不是 Java 用户名。您可以在玩家列表页面（侧边栏，Minecraft 下）添加他们：

1. 打开白名单选项卡。
2. 输入玩家的基岩版玩家代号。空格是允许的。
3. 勾选基岩版玩家。
4. 点击添加到白名单。

玩家将显示基岩版标签。除了勾选复选框外，您还可以使用 Floodgate 的前缀（除非您更改过，否则为点号 .）开始名称，例如 .Steve Builder。页面在复选框下方显示您的服务器使用的前缀。在服务器运行时添加效果最佳。

须知：

• 基岩版玩家只能在此页面添加到白名单，不能添加到其他列表。
• 白名单只有在开启时才能阻止人们加入。在控制台中输入 whitelist on 以开启它。请参阅服务器基础知识：server.properties、白名单和管理员。
• 如果找不到玩家代号，请检查拼写，或要求玩家尝试加入一次，然后再次添加。您也可以输入他们的 XUID。

常见问题

如果您遇到困难，请提交支持工单，提供您的服务器名称以及基岩版玩家尝试加入时看到的内容，我们将提供帮助。