推荐硬件

我们建议在具有至少 2 个核心和 1 GB RAM 的 64 位 Intel 或 AMD 处理器机器上运行 Bedrock Minecraft 服务器。

操作系统

Linux

Linux 版本的 Bedrock Server 需要 Ubuntu 18 或更高版本。不支持其他发行版。
将压缩包文件解压到一个空文件夹中。使用以下命令启动服务器：

LD_LIBRARY_PATH=. ./bedrock_server

Windows

Windows 版本的 Bedrock Server 需要满足以下条件之一：

• Windows 10 版本 1703 或更高版本
• Windows Server 2016 或更高版本

将压缩包文件解压到一个空文件夹中。通过执行 bedrock_server.exe 文件来启动服务器。

在某些系统上，当你希望使用与服务器运行在同一台机器上的客户端连接到服务器时，你需要将 Minecraft 客户端从 UWP 回环限制中豁免：

CheckNetIsolation.exe LoopbackExempt -a -p=S-1-15-2-1958404141-86561845-1752920682-3514627264-368642714-62675701-733520436

服务器设置

服务器将尝试读取一个名为 server.properties 的文件。其中一些选项仅在创建新世界时读取，而另一些则在每次启动时读取。该文件应包含一个键值对列表，键和值之间用等号分隔，每行一个。

以下选项可用。如果某个值带有括号中的数字，则可以使用该数字代替文本值。

选项名称 (Option name)	可能值 (Possible values)	默认值 (Default value)	使用时机 (When is it used)	备注 (Notes)
server-name (服务器名称)	任何字符串（不允许分号）	Dedicated Server	始终	这是在游戏内服务器列表中显示的服务器名称。
gamemode (游戏模式)	survival, creative, adventure	survival	始终或仅对新玩家
force-gamemode (强制游戏模式)	true, false	false	始终	force-gamemode=false（或在 server.properties 文件中未定义 force-gamemode）会阻止服务器向客户端发送除世界创建期间服务器保存的 gamemode 值以外的游戏模式值，即使这些值是在世界创建后在 server.properties 文件中设置的。 force-gamemode=true 会强制服务器向客户端发送除世界创建期间服务器保存的 gamemode 值以外的游戏模式值，如果这些值是在世界创建后在 server.properties 文件中设置的。
difficulty (难度)	peaceful, easy, normal, hard	easy	始终
allow-cheats (允许作弊)	true, false	false	始终	如果为 true，则可以使用命令等作弊功能。
max-players (最大玩家数)	任意整数	10	始终	服务器上应该能够同时游玩的最大玩家数。更高的值会影响性能。
server-port (服务器端口)	1024 到 65535 之间的整数	19132	始终	可以使用低于 1024 的值，但这些端口通常为知名应用程序保留。
server-portv6 (IPv6服务器端口)	1024 到 65535 之间的整数	19133	始终	可以使用低于 1024 的值，但这些端口通常为知名应用程序保留。
enable-lan-visibility (启用局域网可见性)	true, false	true	始终	监听并响应在 LAN 上寻找服务器的客户端。这将导致服务器绑定到默认端口（19132, 19133），即使 ‘server-port’ 和 ‘server-portv6’ 具有非默认值。如果不需要 LAN 发现，或者在同一主机上运行多个服务器可能导致端口冲突，请考虑关闭此选项。
level-name (世界名称)	任何字符串	Bedrock level	始终	要使用/生成的世界的名称。每个世界在 /worlds 文件夹中都有自己的文件夹。
level-seed (世界种子)	任何字符串		世界创建	用于随机化世界的种子。如果留空，将随机选择一个种子。
online-mode (在线模式)	true, false	true	始终	如果为 true，则所有连接的玩家都必须通过 Xbox Live 进行身份验证。 连接到远程（非 LAN）服务器的客户端将始终需要 Xbox Live 身份验证，无论此设置如何。 如果服务器接受来自 Internet 的连接，则强烈建议启用 online-mode。
allow-list (允许名单)	true, false	false	始终	如果为 true，则所有连接的玩家必须列在单独的 allowlist.json 文件中。 请参阅允许名单部分。
view-distance (视距)	任何大于 5 的整数	32	始终	允许的最大视距。更高的值会影响性能。
player-idle-timeout (玩家闲置超时)	任何正整数，包括 0	30	始终	玩家闲置这么多分钟后将被踢出。如果设置为 0，则玩家可以无限期闲置。
max-threads (最大线程数)	任何整数	8	始终	服务器将尝试使用的最大线程数。如果设置为 0 或删除，则将使用尽可能多的线程。
tick-distance (区块更新距离)	范围 [4, 12] 内的整数	4	始终	世界将在距离任何玩家这么多区块的范围内进行更新。更高的值会影响性能。
default-player-permission-level (默认玩家权限等级)	visitor, member, operator	member	始终	新玩家首次加入时将拥有的权限级别。
texturepack-required (强制纹理包)	true, false	false	始终	如果世界使用任何特定的纹理包，则此设置将强制客户端使用它。
content-log-file-enabled (启用内容日志文件)	true, false	false	始终	启用将内容错误记录到文件的功能。
compression-threshold (压缩阈值)	范围 [0-65535] 内的整数	1	始终	确定要压缩的原始网络负载的最小大小。可用于在 CPU 和带宽之间进行权衡实验。
compression-algorithm (压缩算法)	zlib, snappy	zlib	始终	确定用于网络的压缩算法。
server-authoritative-movement-strict (严格服务器权威移动)	true, false	false	始终	如果为 true，将对玩家位置更加严格，在接受客户端信息方面限制性更强。 如果存在高延迟，这将影响玩家周围的移动方块。
server-authoritative-dismount-strict (严格服务器权威下马)	true, false	false	始终	如果为 true，将对玩家下马位置更加严格。 这意味着在高延迟情况下，客户端将在其下马位置上收到校正。
server-authoritative-entity-interactions-strict (严格服务器权威实体交互)	true, false	false	始终	如果为 true，将对实体交互更加严格。这将在高延迟情况下影响玩家之间的互动。
player-position-acceptance-threshold (玩家位置接受阈值)	任意正浮点数	0.5	始终	这是客户端和服务器玩家位置之间差异的容差。 这有助于解决有问题的场景。数值越高，服务器在要求校正之前就越宽容。 传递值 1.0 会增加遗漏作弊的机会。
player-movement-action-direction-threshold (玩家移动动作方向阈值)	范围 [-1.00, 1.00] 内的任意正浮点数	0.85	始终	玩家攻击的方向与玩家注视的方向可以相差的程度，表示为 cos(x)，其中 x 是两个向量之间的角度。值为 1 表示两个向量必须平行，0 表示玩家面前的任何方向，-1 表示任意向量。
server-authoritative-block-breaking (服务器权威方块破坏)	true, false	false	非客户端验证时	如果为 true，服务器将与客户端同步计算方块挖掘操作，以便可以验证客户端在认为可以挖掘方块时是否应该能够挖掘。 此设置不能与客户端权威移动结合使用，如果启用了该设置，则此设置将被禁用。
server-authoritative-block-breaking-pick-range-scalar (服务器权威方块破坏范围系数)	任何高于 1.0 的浮点数	1.5	当 server-authoritative-block-breaking 为 true 时	这会增加方块挖掘的范围。该值会被平方并与默认范围相乘。
chat-restriction (聊天限制)	None, Dropped, Disabled	None	始终	这表示应用于加入服务器的每个玩家的聊天限制级别。 “None” 是默认值，代表常规的自由聊天。 “Dropped” 表示聊天消息被丢弃且永远不会发送到任何客户端。玩家会收到一条消息，告知他们该功能已被禁用。 “Disabled” 表示除非玩家是操作员，否则聊天 UI 甚至不会出现。不会向玩家显示任何信息。
disable-player-interaction (禁用玩家交互)	true, false	false	始终	如果为 true，服务器将通知客户端在与世界交互时应忽略其他玩家。 这不是服务器权威的。
client-side-chunk-generation-enabled (启用客户端区块生成)	true, false	true	始终	如果为 true，服务器将通知客户端，它们有能力在玩家交互距离之外生成可视的世界区块。
block-network-ids-are-hashes (方块网络ID使用哈希值)	true, false	true	始终	如果为 true，服务器将发送哈希后的方块网络 ID，而不是从 0 开始递增的 ID。这些 ID 是稳定的，无论其他方块如何变化都不会改变。
disable-persona (禁用角色)	true, false	false	仅限内部使用
disable-custom-skins (禁用自定义皮肤)	true, false	false	始终	如果为 true，则禁用玩家在 Minecraft 商店资产或游戏内资产之外自定义的皮肤。这用于禁用玩家可能制作的有冒犯性的自定义皮肤。
server-build-radius-ratio (服务器构建半径比例)	Disabled, 0.0-1.0	Disabled	始终	如果为 “Disabled” 服务器将动态计算玩家视野中由服务器生成的比例，其余部分分配给客户端构建。 否则根据覆盖的比例告诉服务器生成玩家视野的比例，忽略客户端硬件能力。 仅在启用 client-side-chunk-generation-enabled 时有效。

游戏内规则

对于游戏内的相关规则，例如死亡后保留物品栏或允许作弊，您应当参考此链接：游戏规则 – 中文 Minecraft Wiki。

文件夹

解压后您会看到几个文件夹和二进制可执行文件。首次启动服务器时，将创建一些新的（空）文件夹。您需要关注的文件夹如下：

文件夹名称 (Folder name)	用途 (Purpose)
behavior_packs (行为包)	这是安装新行为包的位置。暂时无法在某个世界中激活它们。
resource_packs (资源包)	这是安装新资源包的位置。暂时无法在某个世界中激活它们。
worlds (世界)	如果不存在，此文件夹将在启动时创建。每个创建的世界都会有一个文件夹，其名称与 server.properties 文件中的 level-name 相对应。

允许名单（白名单）

如果在 server.properties 中启用了 allow-list 属性，则服务器仅允许选定用户连接。要允许用户连接，您需要知道他们的 Xbox Live 玩家代号（Gamertag）。将用户添加到允许名单的最简单方法是使用命令 allowlist add <玩家代号>（例如：allowlist add ExampleName）。注意：如果玩家代号中有空格，需要用双引号括起来：allowlist add "Example Name"

如果之后想从列表中删除某人，可以使用命令 allowlist remove <玩家代号>。

允许名单将保存在名为 allowlist.json 的文件中。如果您想自动化添加或删除玩家的过程，可以手动修改此文件。修改文件后，需要运行命令 allowlist reload 以确保服务器知道您的新更改。

注意： 此文件以前名为 whitelist.json。为了向后兼容，如果同时存在 whitelist.json 文件，则将使用它而不是 allowlist.json。
要迁移，请删除默认的 allowlist.json 文件，将 whitelist.json 重命名为 allowlist.json，然后重新启动服务器。

该文件包含一个 JSON 数组，其中的对象包含以下键/值：

键 (Key)	类型 (Type)	值 (Value)
name (名称)	String	用户的玩家代号。
xuid (XUID)	String	可选。用户的 XUID。如果未设置，则当具有匹配名称的用户连接时将被填充。
ignoresPlayerLimit (忽略玩家限制)	Boolean	如果为 true，则此用户不计入最大玩家限制。目前即使玩家使用此选项，也存在另一个 30 人（或比指定的最大玩家数多 1）的软限制。此选项的目的是让某些玩家即使在服务器已满时也能加入。

示例 allowlist.json 文件：

[
    {
        "ignoresPlayerLimit": false,
        "name": "MyPlayer"
    },
    {
        "ignoresPlayerLimit": false,
        "name": "AnotherPlayer",
        "xuid": "274817248"
    }
]

权限

您可以通过在服务器可执行文件同目录下的 permissions.json 文件中为用户分配角色来调整特定玩家权限。该文件包含一个简单的 JSON 对象，其中包含 XUID 和权限。有效权限包括：operator、member、visitor。使用这些帐户连接的每个玩家都将根据设置的权限进行处理。如果在服务器运行时更改此文件，请运行命令 permission reload 以确保服务器知道您的新更改。您还可以使用 permission list 列出当前权限。请注意，此功能需要启用 online-mode，因为 xuid 需要在线验证用户帐户。如果未在此列表中的新玩家连接，则将应用 default-player-permission-level 选项。

示例 permissions.json 文件：

[
    {
        "permission": "operator",
        "xuid": "451298348"
    },
    {
        "permission": "member",
        "xuid": "52819329"
    },
    {
        "permission": "visitor",
        "xuid": "234114123"
    }
]

崩溃报告

如果服务器崩溃，它将自动向我们发送各种信息，以帮助我们将来解决此问题。

命令

您可以通过在控制台中输入命令来向服务器发出命令。以下命令可用。< > 表示参数是必需的，[ ] 表示是可选的，| 表示不同的允许值。如果字符串包含空格，可以用双引号 " 括起来。

命令语法 (Command syntax)	描述 (Description)
kick <玩家名称或xuid> <原因>	立即踢出玩家。原因将显示在被踢玩家的屏幕上。
stop	优雅地关闭服务器。
save <hold | resume | query>	用于在服务器运行时进行原子备份。有关更多信息，请参阅备份部分。
allowlist <on | off | list | reload>	on 和 off 用于打开和关闭允许名单。请注意，这不会更改 server.properties 文件中的值！ list 打印服务器当前使用的允许名单 reload 使服务器从文件重新加载允许名单。 有关更多信息，请参阅允许名单部分。
allowlist <add | remove> <名称>	在允许名单文件中添加或删除玩家。名称参数应为要添加或删除的玩家的 Xbox 玩家代号。您不需要在此处指定 XUID，它将在玩家首次连接时被解析。 有关更多信息，请参阅允许名单部分。
permission <list | reload>	list 打印当前使用的操作员列表。 reload 使服务器从 ops 文件重新加载操作员列表。 有关更多信息，请参阅权限部分。
op <玩家>	将玩家提升为 operator。如果玩家已通过 XBL 身份验证，这也会持久保存在 permissions.json 中。如果缺少 permissions.json，则将创建它。如果玩家未连接到 XBL，则该玩家将在当前服务器会话中被提升，并且不会持久保存在磁盘上。服务器重启后，将分配默认服务器权限级别给该玩家。
deop <玩家>	将玩家降级为 member。如果玩家已通过 XBL 身份验证，这也会持久保存在 permissions.json 中。如果缺少 permissions.json，则将创建它。
changesetting <设置> <值>	更改服务器设置而无需重新启动服务器。目前仅支持更改两个设置：allow-cheats（true 或 false）和 difficulty（0/peaceful、1/easy、2/normal、3/hard）。它们不会修改 server.properties 中指定的值。

备份

服务器支持在服务器运行时备份世界文件。它不太适合手动备份，但在自动化时效果更好。从服务器的角度来看，备份包括三个命令。

命令 (Command)	描述 (Description)
save hold	这将要求服务器准备备份。它是异步的，会立即返回。
save query	调用 save hold 后，您应重复调用此命令以查看准备是否已完成。当它返回成功时，它将返回您需要复制的文件列表（包含每个文件的长度）。在此过程中服务器不会暂停，因此某些文件可能会在备份期间被修改。只要您仅复制给定文件列表中的文件并将复制的文件截断为指定长度，备份就应该是有效的。
save resume	复制文件完成后，您应调用此命令以告诉服务器可以再次删除旧文件。