本指南将引导您在 Legion Hosting 上设置和配置 Minecraft Bedrock Edition 服务器。涵盖首次启动、server.properties 配置、玩家权限、从每个 Bedrock 平台连接、世界管理和跨平台联机注意事项。

Bedrock 版与 Java 版

Minecraft 有两个不同的版本，它们之间原生不兼容：

Bedrock 服务器仅接受 Bedrock 客户端。如果您需要 Java Edition 玩家加入 Bedrock 兼容的服务器，请考虑运行带有 Geyser 插件的 Java 服务器。本指南专门介绍专用 Bedrock 服务器。

步骤 1 — 首次启动

从 Legion Hosting 购买 Minecraft Bedrock 服务器后，按照以下步骤首次运行。

1. 登录 GPanel 并从服务器列表中选择您的 Bedrock 服务器。
2. 点击 Startup 选项卡。您将看到控制服务器基本设置的 egg 变量。关键变量有：

   变量	默认值	描述
   BEDROCK_VERSION	latest	要安装的 Bedrock Dedicated Server 版本。设置为 latest 以在启动时始终获取最新版本，或固定特定版本号（例如 1.21.51.02）。
   SERVERNAME	Dedicated Server	玩家添加您的服务器时显示的名称。
   GAMEMODE	survival	默认游戏模式：survival、creative 或 adventure。
   DIFFICULTY	easy	世界难度：peaceful、easy、normal 或 hard。
   CHEATS	false	是否为非管理员玩家启用作弊（命令）：true 或 false。

3. 调整您想要更改的任何值。Startup 变量的更改将在下次服务器启动时生效。
4. 返回 Console 选项卡并点击 Start。
5. 首次启动时，服务器将下载 Bedrock Dedicated Server 二进制文件 — 这通常需要 1–3 分钟，具体取决于文件大小。
6. 当您在控制台中看到类似 Server started 或 IPv4 supported, port: 的消息时，服务器已就绪，状态应显示为 Running。

步骤 2 — 配置 server.properties

server.properties 文件是 Bedrock 服务器的主要配置文件。它在首次启动时自动创建，位于服务器根目录中。

1. 在 GPanel 中，从 Console 选项卡停止服务器，等待状态显示为 Offline。
2. 点击 Files 选项卡，在文件编辑器中打开 server.properties。
3. 根据需要编辑以下值，然后点击 Save Content。
4. 启动服务器使更改生效。

最简 server.properties 配置示例：

server-name=My Legion Bedrock Server
gamemode=survival
difficulty=normal
max-players=10
online-mode=true
allow-cheats=false
view-distance=16
tick-distance=4
level-seed=
level-name=Bedrock level
default-player-permission-level=member

步骤 3 — 玩家权限

Bedrock Dedicated Server 使用三级权限系统来确定每个玩家可以执行的操作：

server.properties 中的 default-player-permission-level 设置所有新玩家的等级。要为个别玩家分配特定权限等级，请编辑服务器根目录中的 permissions.json 文件：

[
  {
    "permission": "operator",
    "xuid": "1234567890123456"
  },
  {
    "permission": "member",
    "xuid": "9876543210987654"
  }
]

每个条目需要玩家的 XUID（Xbox 用户 ID），这是一个与其 Microsoft 账户关联的 16 位数字。您可以通过以下方式查找玩家的 XUID：

• 检查玩家连接时的服务器控制台输出 — 日志行中包含其 XUID。
• 使用第三方 XUID 查询工具（搜索 "Xbox XUID lookup"）。

白名单

要将服务器限制为仅允许已批准的玩家，请编辑服务器根目录中的 allowlist.json 文件，并在 server.properties 中设置 allow-list=true。

[
  {
    "ignoresPlayerLimit": false,
    "name": "PlayerGamertag",
    "xuid": "1234567890123456"
  },
  {
    "ignoresPlayerLimit": true,
    "name": "AdminGamertag",
    "xuid": "9876543210987654"
  }
]

• name — 玩家的 Xbox/Microsoft 玩家代号（不区分大小写）。
• xuid — 玩家的 XUID。该条目必须包含此字段才能生效。
• ignoresPlayerLimit — 当设置为 true 时，即使服务器已满，该玩家也可以加入。适用于管理员。

步骤 4 — 如何连接

连接之前，请确保您的服务器状态在 GPanel 中显示为 Running。从 GPanel Console 或 Network 选项卡记下您服务器的 IP 地址和端口。

从 Windows 10/11 连接

1. 从 Microsoft Store / Xbox 应用打开 Minecraft（Bedrock Edition）。
2. 从主菜单点击 Play。
3. 选择顶部的 Servers 选项卡。
4. 滚动到底部并点击 Add Server。
5. 输入服务器名称（任意），然后输入 GPanel 中的 Server Address（仅 IP）和 Port。
6. 点击 Save，然后选择您的服务器并点击 Join Server。

从移动设备（iOS / Android）连接

1. 打开 Minecraft 并点击 Play。
2. 点击 Servers 选项卡。
3. 向下滚动并点击 Add Server。
4. 输入 GPanel 中的服务器名称、IP 地址和端口。
5. 点击 Save，然后点击服务器条目进行连接。

从主机（Xbox、PlayStation、Nintendo Switch）连接

Bedrock 的主机版本在 Servers 选项卡中没有原生的 "Add Server" 按钮。要从主机连接到自定义服务器，您需要使用以下方法之一：

• 精选服务器变通方法： 某些主机允许通过好友选项卡或使用精选服务器重定向来添加服务器。具体步骤因主机而异，可能会随 Minecraft 更新而变化。
• 伴侣应用方法： 在同一网络上使用 Minecraft Bedrock 伴侣应用或基于 DNS 的工具（如 BedrockConnect）将精选服务器地址重定向到您的自定义服务器 IP。
• LAN 代理： 在同一网络的 PC 上运行代理工具，将您的远程服务器宣传为局域网游戏，使其出现在主机的好友选项卡中。

步骤 5 — 世界管理

世界文件位置

Bedrock 世界存储在服务器的 worlds/ 目录中。worlds/ 内的文件夹名称与 server.properties 中的 level-name 值匹配。默认情况下为 worlds/Bedrock level/。

上传现有世界

您可以从单人存档或其他服务器上传世界：

1. 从 GPanel Console 选项卡停止服务器。
2. 在 GPanel 中打开 Files 选项卡并导航到 worlds/ 目录。
3. 如果您要替换当前世界，请删除或重命名现有世界文件夹（例如将 Bedrock level 重命名为 Bedrock level backup）。
4. 使用 GPanel 文件管理器或通过 SFTP 上传您的世界文件夹。该文件夹至少必须包含 level.dat 文件和 db/ 目录。
5. 将上传的文件夹重命名为与 server.properties 中的 level-name 值匹配，或更新 level-name 以匹配上传的文件夹名称。
6. 启动服务器。它应该会加载上传的世界。

备份

定期备份可防止数据丢失、损坏和意外更改：

• GPanel 备份： 查看 GPanel 中的 Backups 选项卡。根据您的套餐，可能提供自动备份。您也可以从此选项卡创建手动备份。
• 通过 SFTP 手动备份： 停止服务器，通过 SFTP 连接，然后将整个 worlds/ 目录下载到本地计算机。将这些副本存储在安全的位置。
• 重大更改前： 在上传新世界、更改 level-name 或更新服务器版本之前，务必创建备份。

步骤 6 — 跨平台联机注意事项

Bedrock Edition 的核心优势之一是原生跨平台联机 — 所有 Bedrock 平台都可以在同一服务器上一起游戏，无需任何额外配置。但是，有几点需要注意：

• 所有 Bedrock 平台都兼容。 Xbox 上的玩家可以与手机、Switch 或 Windows 10/11 PC 上的玩家一起游戏。不需要模组或插件 — 跨平台联机内置于 Bedrock 协议中。
• 需要 Microsoft 账户。 当 online-mode=true（默认且推荐的设置）时，所有玩家都必须登录 Microsoft / Xbox Live 账户，无论使用什么平台。未登录的玩家将无法加入。
• 输入差异。 主机玩家使用手柄，移动玩家使用触控操作，PC 玩家可能使用键盘和鼠标。在构建复杂的红石装置或 PvP 竞技场时请考虑这一点 — 不同的输入方式会创造不同的游戏体验。
• 版本匹配至关重要。 所有连接的客户端必须与服务器使用相同的 Bedrock 版本。如果某个平台上的玩家已自动更新但其他玩家尚未更新，他们将无法一起游戏，直到所有客户端与服务器版本匹配。使用版本固定（BEDROCK_VERSION Startup 变量）来控制此项。
• Java Edition 不兼容。 Java Edition 玩家无法连接到 Bedrock 服务器。如果您需要同时支持 Java 和 Bedrock 玩家，请考虑运行带有 Geyser 插件的 Java 服务器，该插件可为 Java 服务器转换 Bedrock 协议。

故障排除

服务器显示 Running 但无人能连接

• 仔细检查您是否在单独的字段中输入了正确的 IP 地址和端口（不要用冒号组合在一起）。
• 通过检查控制台中的 Server started 消息确认服务器已完全启动。
• 验证客户端的 Minecraft 版本与服务器版本完全匹配。即使是微小的版本差异也会阻止连接。
• 如果 server.properties 中的 allow-list 设置为 true，请确保连接玩家的 XUID 已列在 allowlist.json 中。

"Could not connect: Outdated server" 或 "Outdated client"

这意味着客户端和服务器运行的是不同的 Bedrock 版本。要么更新客户端以匹配服务器，要么更改 BEDROCK_VERSION Startup 变量以匹配客户端版本并重启服务器。

上传后世界无法加载

• 确保上传的世界文件夹直接位于 worlds/ 内，而不是嵌套在额外的子目录中（例如 worlds/Bedrock level/level.dat 是正确的，worlds/Bedrock level/Bedrock level/level.dat 是错误的）。
• 确认文件夹名称与 server.properties 中的 level-name 值完全匹配，包括空格和大小写。
• 验证世界包含有效的 level.dat 文件和 db/ 目录。
• Java Edition 世界与 Bedrock 服务器不兼容。您必须先使用第三方工具（如 Chunker 或 Amulet）进行转换才能上传。

性能问题（延迟、区块加载缓慢）

• 降低 server.properties 中的 view-distance。推荐值在 10 到 16 之间。默认值 32 对大多数托管服务器来说过高。
• 将 tick-distance 降低到 4（最小值）。这会减少模拟区域并降低 CPU 使用量。
• 如果服务器经常满员，请减少 max-players。
• 检查 GPanel 的资源使用图表，查看服务器是否达到了 RAM 或 CPU 限制。如果是，请考虑升级您的套餐。

主机玩家找不到 "Add Server" 按钮

这是平台限制 — Xbox、PlayStation 和 Nintendo Switch 并非对所有用户原生公开 "Add Server" 选项。请参阅上面步骤 4 中的主机连接方法。如果您需要设置主机访问方面的帮助，请 提交支持工单。

相关文章

• Minecraft Java 服务器设置指南 — 如果您运行的是 Java Edition 服务器
• 如何查找您的服务器 IP 和端口
• 如何通过 SFTP 上传文件

如果您遇到本文未涵盖的问题，请 提交支持工单，我们的团队将帮助您解决。