Minecraft Bedrock 服务器属性允许玩家自定义其 Bedrock 版服务器的各个方面。 这些属性可控制 功能,例如游戏模式、难度等级、玩家人数上限以及世界生成设置。 以下指南概述了每项设置,并简要说明其功能。 了解并配置这些服务器属性,可以显著提升服务器管理员和玩家的整体游戏体验,确保服务器符合他们的偏好和玩法风格。
注意:列出的设置为 Minecraft Bedrock 1.21.9 版本的默认设置。
了解如何编辑 Minecraft Bedrock 服务器设置,请点击 此处。
allow-cheats=false
设置是否允许在服务器上运行作弊命令。
allow-inbound-script-debugging=false
设置是否允许脚本调试器的 'listen' 命令。
allow-list=false
设置是否启用允许列表。 不在 allowlist.json 文件中的玩家无法连接。
allow-outbound-script-debugging=false
设置是否允许脚本调试器的 'connect' 命令。
block-network-ids-are-hashes=true
设置服务器是否发送经过哈希处理的方块网络 ID,而不是顺序 ID。 哈希 ID 是稳定的,即使其他方块发生变化也会保持不变。
chat-restriction=None
表示对加入服务器的每位玩家应用的聊天限制等级。 可用值为 None、Dropped 和 Disabled。
None- 默认值,表示常规自由聊天。Dropped- 聊天消息会被丢弃,且不会发送给任何客户端。 玩家会收到一条消息,告知他们该功能已禁用。Disabled- 对非 OP 玩家隐藏聊天界面。 不会向玩家显示任何信息。
client-side-chunk-generation-enabled=true
设置服务器是否通知客户端,它们可以在玩家交互距离之外生成可视级区块。
compression-algorithm=zlib
设置网络传输使用的压缩算法。 可用值为 zlib 和 snappy。
compression-threshold=1
设置需要压缩的原始网络负载大小。
content-log-file-enabled=false
设置是否启用将内容错误记录到文件。
default-player-permission-level=member
设置新玩家的权限等级:visitor、member 或 operator。
diagnostics-capture-auto-start=false
设置是否在世界加载时启动诊断捕获会话。
diagnostics-capture-max-file-size=2097152
设置当前诊断捕获文件在切换到新文件前的最大大小,单位为字节。
diagnostics-capture-max-files=5
设置轮换前保留的诊断捕获文件最大数量。
difficulty=easy
设置世界的难度。 可用值为 peaceful、easy、normal 和 hard。
disable-client-vibrant-visuals=true
设置服务器是否告知客户端使用下一个最佳可用图形设置,而不是 Vibrant Visuals。
disable-custom-skins=false
设置是否禁用在 Minecraft 商店之外创建的自定义皮肤。 用于防止冒犯性皮肤。
disable-persona=false
仅供内部使用。
disable-player-interaction=false
设置服务器是否通知客户端在与世界互动时忽略其他玩家。
enable-lan-visibility=true
设置服务器是否响应在局域网中查找服务器的客户端。 如果在同一主机上运行多个服务器,建议禁用此项以避免端口冲突。
force-gamemode=false
设置服务器是否强制玩家使用 server.properties 中定义的游戏模式。 如果为 true,则会覆盖世界创建时保存的游戏模式。 如果为 false,则会遵循世界创建设置。
force-inbound-debug-port=19144
锁定入站(监听)调试器端口。 使用 script-debugger-auto-attach=listen 模式时必需。
gamemode=survival
设置新玩家的游戏模式。 可用值为 survival、creative 和 adventure。
level-name=Bedrock level
设置世界名称和保存文件夹。
level-seed=
生成世界种子。 如果留空,则会生成随机种子。
max-players=10
设置服务器上的最大玩家数量。 允许输入任何正整数。
max-threads=8
设置最大服务器线程数。 输入 0 可使用尽可能多的线程。
online-mode=true
设置服务器是否检查加入的玩家已通过 Xbox Live 身份验证。 连接到非局域网服务器的玩家仍会经过 Xbox Live 身份验证。 出于安全考虑,建议保持为 true。
player-idle-timeout=30
设置玩家被踢出前允许闲置的时间,单位为分钟。 输入 0 可禁用。
player-movement-action-direction-threshold=0.85
设置玩家攻击方向与视线方向之间的差异量。 取值范围从 0(允许 90 度差异)到 1(要求完全匹配)。
player-position-acceptance-threshold=0.5
设置客户端与服务器之间位置差异的容差(例如因击退造成)。 数值越高,服务器容忍度越高,但作弊风险也会增加。
script-debugger-auto-attach=disabled
设置脚本调试器是否在世界加载时附加。 可用值为 disabled、connect 和 listen。
script-debugger-auto-attach-connect-address=localhost:19144
设置自动附加模式设为 connect 时使用的地址(主机:端口)。
script-debugger-auto-attach-timeout=0
设置在世界加载时等待调试器附加的时间。
script-debugger-passcode=
设置 VSCode 连接所需的密码。
script-watchdog-enable=true
设置是否启用看门狗。
script-watchdog-enable-exception-handling=true
设置是否通过 events.beforeWatchdogTerminate 事件启用看门狗异常处理。
script-watchdog-enable-shutdown=true
设置在出现未处理的看门狗异常时,服务器是否关闭。
script-watchdog-hang-exception=true
设置发生卡死时是否抛出严重异常,从而中断脚本执行。
script-watchdog-hang-threshold=10000
设置单个游戏刻卡死的看门狗阈值,单位为毫秒。
script-watchdog-memory-limit=250
设置在保存并关闭世界前,脚本合计内存使用量的阈值,单位为兆字节。 输入 0 可禁用。
script-watchdog-memory-warning=100
设置在生成内容日志警告前,合计内存使用量的阈值,单位为兆字节。 输入 0 可禁用。
script-watchdog-slow-threshold=10
设置脚本在多个游戏刻内运行缓慢时的看门狗阈值。 如果未设置,则禁用警告。
script-watchdog-spike-threshold=100
设置单个游戏刻尖峰的看门狗阈值。 如果未设置,则禁用警告。
server-authoritative-block-breaking-pick-range-scalar=1.5
设置服务器是否与客户端同步计算方块挖掘操作。 它会检查玩家是否足够接近,可以破坏该方块。
server-authoritative-dismount-strict=false
设置服务器是否严格处理玩家下乘位置。 如果为 true,客户端会在高延迟情况下收到修正。
server-authoritative-entity-interactions-strict=false
设置服务器是否严格处理实体交互。 如果为 true,玩家之间的交互可能会受高延迟影响。
server-authoritative-movement-strict=false
设置服务器是否严格处理玩家位置差异。 如果为 true,客户端会收到更多位置修正。
server-build-radius-ratio=Disabled
设置服务器相对于客户端生成玩家视野内容的比例。 如果为 Disabled,服务器会动态计算此项。 仅当启用 客户端区块生成 时有效。
server-name=Dedicated Server
设置服务器名称。 允许值为不含分号的任意字符串。
server-port=19132
设置服务器的 IPv4 端口。
server-portv6=19133
设置服务器的 IPv6 端口。
texturepack-required=false
要求玩家接受服务器材质包。 拒绝将导致玩家断开连接。
tick-distance=4
设置距离玩家会进行游戏刻更新的区块数量,范围从 4 到 12。 较低的值可以提升性能。
view-distance=32
设置以区块数量表示的最大视距。 较低的值可减少延迟。
实用链接
Minecraft Bedrock 服务器属性 Wiki
编辑 Minecraft Bedrock 服务器设置
为 Minecraft Bedrock 服务器添加资源包
为 Minecraft Bedrock 服务器添加行为包