server.properties参数解释

前言

作者：LT_Name
原文： server.properties (opens new window)

修改服务器的运行配置，以此来定制一些基本功能。

server-ip

数据类型	默认值
String	0.0.0.0

服务器的IP

server-port

数据类型	默认值
Integer	19132

服务器的端口

同一端口不能运行多个服务器
如果不能访问请检查防火墙
基岩版使用 UDP

enable-query

数据类型	默认值
Boolean	on

启用 Query 查询
详见：https://wiki.vg/Query

motd

数据类型	默认值
String	Minecraft Server

服务器名称/显示在服务器列表上的文本

sub-motd

数据类型	默认值
String	Powered by Nukkit-MOT

motd 的第二行

只有当在游戏中的好友列表中查看服务器时，才会显示给本地网络中的玩家
自 1.16.210 以来不能为空

view-distance

数据类型	默认值
Integer	8

最大视距（以区块为单位）
更大的值 = 加载更多区块 = 更多的内存和 CPU 使用

achievements

数据类型	默认值
Boolean	on

启用玩家成就

announce-player-achievements

数据类型	默认值
Boolean	on

向所有玩家广播获得成就的消息

spawn-protection

数据类型	默认值
Integer	10

非管理员(OP)玩家无法在区块内建造或破坏方块的生成保护区域大小（以方块为单位）

max-players

数据类型	默认值
Integer	50

服务器允许的最大玩家人数

drop-spawners

数据类型	默认值
Boolean	on

刷怪笼被挖掘后掉落

spawn-animals

数据类型	默认值
Boolean	off

启用动物生成

spawn-mobs

数据类型	默认值
Boolean	off

启用怪物生成

gamemode

数据类型	默认值
Integer	2

服务器的默认游戏模式
0 = 生存, 1 = 创造, 2 = 冒险, 3 = 旁观

force-gamemode

数据类型	默认值
Boolean	on

每次加入时将玩家游戏模式设置为默认游戏模式

difficulty

数据类型	默认值
Integer	2

服务器的默认难度（0-3）

hardcore

数据类型	默认值
Boolean	off

玩家死亡后将其封禁

pvp

数据类型	默认值
Boolean	on

是否启用玩家对战

white-list

数据类型	默认值
Boolean	off

仅允许白名单中的玩家加入服务器
使用/whitelist命令或修改 white-list.txt 来添加玩家到白名单

whitelist-reason

数据类型	默认值
String	Server is white-listed

启用白名单的原因，显示给被阻挡在外的玩家

generator-settings

数据类型	默认值
String

默认级别的特殊世界生成器设置

level-name

数据类型	默认值
String	world

默认世界的名称

level-seed

数据类型	默认值
String

默认世界的种子

level-type

数据类型	默认值
String	void

如果默认世界不存在，则使用的生成器
默认支持：default, normal, flat, nether, the_end或void

enable-rcon

数据类型	默认值
Boolean	off

启用远程控制台访问

RCON 不是一个非常安全的远程控制服务器的方式
RCON 可以使用与服务器相同的端口（TCP 协议）
详见：https://developer.valvesoftware.com/wiki/Source_RCON_Protocol

rcon.password

数据类型	默认值
String	随机10位字符

RCON 连接的密码

rcon.port

数据类型	默认值
Integer	25575

RCON 连接的端口

auto-save

数据类型	默认值
Boolean	on

自动保存世界、玩家数据

如果禁用，则对世界的更改不会自动保存，即使在卸载时也是如此，如果需要可以使用插件手动保存

您可以使用 worlds-level-auto-save-disabled 仅禁用自动保存世界

force-resources

数据类型	默认值
Boolean	off

强制玩家下载服务器的资源包后才能加入
还请参阅 force-resources-allow-client-packs

force-resources-allow-client-packs

数据类型	默认值
Boolean	off

在启用 force-resources 时不要禁用客户端自己的资源包

xbox-auth

数据类型	默认值
Boolean	on

需要经过 Xbox 帐户验证后才能加入

不会绕过客户端的限制条件。
如果您选择禁用此功能（不推荐这样做），请在玩家名称和 UUIDs 传递给权限管理器或管理员之后，以确保它们已经得到了验证。

encryption

数据类型	默认值
Boolean	on

启用网络加密
如果不使用代理软件，则建议启用此功能

bed-spawnpoints

数据类型	默认值
Boolean	on

允许玩家使用床和重生锚设置重生点

explosion-break-blocks

数据类型	默认值
Boolean	on

启用爆炸对方块造成的破坏
影响所有爆炸，如 TNT、苦力怕和末影水晶

stop-in-game

数据类型	默认值
Boolean	on

允许 OP 在游戏中使用 /stop 命令

op-in-game

数据类型	默认值
Boolean	on

允许 OP 在游戏中使用 /op 命令对其他玩家进行操作

space-name-mode

数据类型	默认值
String	ignore

玩家名称中带有空格的处理方式
"disabled" - 禁止带有空格名称的玩家进入服务器
"ignore" - 忽略空格名称 （默认）
"replacing" - 用"_"替换玩家名称中的空格

xp-bottles-on-creative

数据类型	默认值
Boolean	on

允许创造模式下玩家扔经验瓶

spawn-eggs

数据类型	默认值
Boolean	off

启用刷怪蛋，允许通过刷怪蛋生成实体

mob-ai

数据类型	默认值
Boolean	on

启用 MobPlugin 的生物 AI

entity-auto-spawn-task

数据类型	默认值
Boolean	off

启用自动生成怪物和动物的任务
生成功能依据服务器的游戏难度来工作
注意：如果您希望生成任何生物，必须启用spawn-animals、spawn-mobs其一，或者两者都启用。

entity-despawn-task

数据类型	默认值
Boolean	off

若启用，则没有使用命名牌命名的生物的会自动消失

末影龙、凋灵和村民不会消失

language

数据类型	默认值
String	eng

Nukkit 使用的默认语言

force-language

数据类型	默认值
Boolean	off

强制使用服务器端翻译
只有在你有插件来实现这些翻译时才启用

shutdown-message

数据类型	默认值
String	Server closed

当您停止服务器时向玩家显示的消息
可以使用颜色符号§，换行请使用 §n。

save-player-data

数据类型	默认值
Boolean	on

如果启用，则以其UUID保存玩家数据的格式，并自动将旧格式的玩家数据转换为新格式
如果使用旧版Waterdog代理，请禁用此功能
如果存在新的玩家数据，请勿禁用

query-plugins

数据类型	默认值
Boolean	off

若启用则 Query 查询可以获取插件列表（enable-query=on）

debug-level

数据类型	默认值
Integer	1

如果您想要更多的调试日志记录，请设置较高的值（1-3）

async-workers

数据类型	默认值
String	auto

异步工作线程数
如果设置为 auto，则会尝试自动检测核心数进行调整

zlib-provider

数据类型	默认值
Integer	2

选择 zlib 提供程序
0 = ZlibOriginal，1 = ZlibSingleThreadLowMem，2 = ZlibThreadLocal
默认：2
其他提供程序可能会对服务器的性能产生负面影响

compression-level

数据类型	默认值
Integer	4

发送数据包的 Zlib 压缩级别（0-9）
更高的值 = 更多的 CPU 占用 + 更少的网络占用

compression-threshold

数据类型	默认值
Integer	256

不要压缩小于此值的批处理数据包（仅限Zlib）

use-snappy-compression

数据类型	默认值
Boolean	on

使用 Snappy 压缩数据包

min-mtu

数据类型	默认值
Integer	576

设置最小 MTU 大小
默认值：576

max-mtu

数据类型	默认值
Integer	1492

设置最大 MTU 大小（576 - 1492）
值越大网络发包越高效，但较小的值或许可以解决某些连接上的问题。

rak-packet-limit

数据类型	默认值
Integer	120

每个ip可以在一个 RakNet 周期（10ms）内发送的数据包数量
超过此限制的ip将被暂时封禁

enable-rak-send-cookie

Data Type	Default Value
Boolean	on

启用此选项后，服务器会在客户端连接时发送一个 Cookie，用于验证客户端的合法性。
这将增强连接的安全性，防止潜在的恶意连接或攻击。

timeout-milliseconds

数据类型	默认值
Integer	25000

如果客户端没有响应，服务器应该等待多长时间后踢出玩家
单位为毫秒，1000 毫秒 = 1 秒

auto-tick-rate

数据类型	默认值
Boolean	on

允许服务器自动调整世界游戏刻以维持每秒 20 个游戏刻

auto-tick-rate-limit

数据类型	默认值
Integer	20

服务器可以临时降低游戏刻速率到多少

base-tick-rate

数据类型	默认值
Integer	1

基础游戏刻速率
1 = 每秒 20 个刻度，2 = 每秒 10 个刻度，以此类推。
建议保持默认值（1）。

always-tick-players

数据类型	默认值
Boolean	off

始终对玩家进行游戏刻更新

light-updates

数据类型	默认值
Boolean	off

光照更新

clear-chunk-tick-list

数据类型	默认值
Boolean	on

允许服务器在完成每个游戏刻的逻辑更新后，清空用于追踪哪些区块需要进行逻辑更新的列表 chunkTickList。
这可以帮助优化服务器性能，防止不必要的计算，特别是在大型服务器或有大量区块需要管理的情况下。

spawn-threshold

数据类型	默认值
Integer	56

在生成玩家之前需要加载多少个区块

chunk-sending-per-tick

数据类型	默认值
Integer	4

每游戏刻发送的区块数

chunk-ticking-per-tick

数据类型	默认值
Integer	40

每游戏刻 chunkTickList 存储的区块数

chunk-ticking-radius

Data Type	Default Value
Integer	3

玩家周围需要进行刻算的区块半径

chunk-generation-queue-size

Data Type	Default Value
Integer	8

等待生成的区块数量

chunk-generation-population-queue-size

Data Type	Default Value
Integer	8

等待填充的区块数量

ticks-per-autosave

Data Type	Default Value
Integer	6000

世界自动保存任务运行的频率
以刻为单位，20刻 = 1秒

ticks-per-entity-spawns

Data Type	Default Value
Integer	200

实体自动生成任务运行的频率
以刻为单位，20刻 = 1秒

ticks-per-entity-despawns

Data Type	Default Value
Integer	12000

实体存活的时间
以刻为单位，20刻 = 1秒

thread-watchdog

数据类型	默认值
Boolean	on

启用线程看门狗

thread-watchdog-tick

数据类型	默认值
Integer	60000

如果 Nukkit-MOT 主线程暂停超过 60000 毫秒，会抛出致命错误并终止执行的毫秒数

nether

数据类型	默认值
Boolean	off

生成地狱世界

end

数据类型	默认值
Boolean	off

生成末地世界

vanilla-portals

数据类型	默认值
Boolean	on

原版传送门

portal-ticks

数据类型	默认值
Integer	80

玩家触发传送门所需Tick

multi-nether-worlds

数据类型	默认值
String

如果你需要多个地狱世界，在这里列出应该有自己地狱的世界，否则使用默认的地狱世界

anti-xray-worlds

数据类型	默认值
String

启用内置反矿透的世界列表

示例：world, survival, factions

do-not-tick-worlds

数据类型	默认值
String

禁用随机方块刻度的世界列表
这将禁用植物生长、树叶腐烂、草方块蔓延、方块掉落等。
你可能想在这里添加你的大堂和迷你游戏世界

worlds-entity-spawning-disabled

数据类型	默认值
String

不允许实体自动生成的世界列表

示例：lobby, pvp, creative

load-all-worlds

数据类型	默认值
Boolean	on

加载所有世界

ansi-title

数据类型	默认值
Boolean	off

启用在 Windows CMD 标题中显示服务器占用信息
<Image img={require('@site/static/images/server-config/windows_cmd_title.png')} alt="Windows 命令行标题" />

block-listener

数据类型	默认值
Boolean	on

启用用于雪块、铁傀儡、怪物蛋石等的检查

allow-flight

数据类型	默认值
Boolean	off

启用/禁用飞行反作弊

multiversion-min-protocol

数据类型	默认值
Integer	0

多版本的最低协议

multiversion-max-protocol

数据类型	默认值
Integer	-1

多版本的最高协议

vanilla-bossbars

数据类型	默认值
Boolean	off

显示凋零和末影龙的Boss血条（实验性）

strong-ip-bans

数据类型	默认值
Boolean	off

强制 IP 封禁

worlds-level-auto-save-disabled

数据类型	默认值
String

禁用自动保存
等级的世界

temp-ip-ban-failed-xbox-auth

数据类型	默认值
Boolean	off

临时封禁 Xbox 身份验证失败的玩家

call-data-pk-send-event

数据类型	默认值
Boolean	on

如果没有插件使用它，可以禁用 DataPacketSendEvent 以获得更好的性能

call-batch-pk-send-event

数据类型	默认值
Boolean	on

如果没有插件使用它，可以禁用 BatchPacketsEvent 以获得更好的性能

do-level-gc

数据类型	默认值
Boolean	on

在游戏刻之间进行世界垃圾收集

skin-change-cooldown

数据类型	默认值
Integer	15

玩家皮肤更换冷却时间（秒）

check-op-movement

数据类型	默认值
Boolean	off

为管理员(OP)启用移动检查

do-not-limit-interactions

数据类型	默认值
Boolean	off

禁用用于限制客户端右键交互垃圾数据包的黑客技术

do-not-limit-skin-geometry

数据类型	默认值
Boolean	on

禁用最大皮肤几何大小检查
可能对某些玩家，皮肤的可用性是必需的

automatic-bug-report

数据类型	默认值
Boolean	on

启用自动报告错误

anvils-enabled

数据类型	默认值
Boolean	on

启用铁砧
在 Nukkit 上，铁砧属于实验性功能方块，普遍存在物品重命名、物品数据丢失等问题

save-player-data-by-uuid

数据类型	默认值
Boolean	on

如果启用，则以 NukkitX 使用的格式保存玩家数据，并自动将旧格式的玩家数据转换为新格式
如果使用旧版 WaterdogPE 代理，请禁用此功能

如果存在新的玩家数据，请勿禁用

persona-skins

数据类型	默认值
Boolean	on

允许玩家自己的皮肤

如果禁用，将显示默认的史蒂夫皮肤
某些玩家的皮肤可能需要启用 do-not-limit-skin-geometry 才能使用

call-entity-motion-event

数据类型	默认值
Boolean	on

您可以禁用 EntityMotionEvent 以获得更好的性能，如果您的插件没有使用它

update-notifications

数据类型	默认值
Boolean	on

有新的 Nukkit-MOT 版本发布时通知刚加入游戏的管理员(OP)

bstats-metrics

数据类型	默认值
Boolean	on

启用 bStats 统计
https://bstats.org/plugin/server-implementation/Nukkit/
匿名收集数据：Nukkit 版本（Nukkit-MOT）、玩家数量、玩家游戏版本、是否开启 Xbox 身份验证、Java 版本、操作系统、CPU 架构及数量、服务器地理位置（粗略）

cache-chunks

数据类型	默认值
Boolean	off

将区块保存到内存中以加快发送速度

多版本支持的效果不佳

async-chunks

数据类型	默认值
Boolean	on

启用异步区块发送
当向不同版本的玩家发送大量区块时，这可以极大地提高性能
建议保持此选项开启

deprecated-verbose

数据类型	默认值
Boolean	on

当插件使用不推荐 API 时在控制台显示警告。

server-authoritative-movement

数据类型	默认值
String	server-auth

服务器移动验证方式 可选：client-auth / server-auth-with-rewind / server-auth

server-authoritative-block-breaking

数据类型	默认值
Boolean	on

服务器权威方块破坏

use-client-spectator

数据类型	默认值
Boolean	on

使用客户端侧的旁观者模式

enable-experiment-mode

数据类型	默认值
Boolean	on

启用实验模式

use-waterdog

数据类型	默认值
Boolean	off

尝试获取 WaterdogPE 提供的客户端真实 IP
详见：https://waterdog.dev/

enable-spark

数据类型	默认值
Boolean	off

启用 Spark 用于性能分析
详见：https://spark.lucko.me/docs

hastebin-token

数据类型	默认值
String

Hastebin 令牌，方便生成 debug 链接
详见：https://www.toptal.com/developers/hastebin/documentation

use-native-leveldb

数据类型	默认值
Boolean	off

使用原生的 LevelDB 实现

enable-raw-ores

数据类型	默认值
Boolean	on

启用粗矿石；若启用则对高版本玩家掉落粗铜、粗铁、粗金
版本自 BE 1.17.0 (opens new window) 起

enable-new-paintings

Data Type	Default Value
Boolean	on

启用在1.21版本新加入的画

enable-new-chicken-eggs-laying

Data Type	Default Value
Boolean	on

启用鸡产出新类型鸡蛋 （蓝色鸡蛋&棕色鸡蛋）

leveldb-cache-mb

数据类型	默认值
Integer	80

与 use-native-leveldb 一同使用
用于减少每个世界硬盘读写操作的区块数据最大缓存大小
如果你拥有大量内存并且仅有几个大型世界，可以调高此缓存大小

forced-safety-enchant

Data Type	Default Value
Boolean	on

启用强制安全附魔（限制附魔最大等级）

netease-client-support

Data Type	Default Value
Boolean	off

启用网易客户端支持，启用后将允许网易玩家进入服务器

only-allow-netease-client

Data Type	Default Value
Boolean	off

仅允许网易玩家进入服务器，开启后将禁止微软版玩家进入服务器，仅允许网易玩家加入服务器