跳到主要内容

server.properties

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

server-ip​

数据类型默认值
String0.0.0.0

服务器的端口

备注

同一端口不能运行多个服务器

如果不能访问请检查防火墙

基岩版使用 UDP 协议

server-port​

数据类型默认值
Integer19132

服务器的端口

备注

同一端口不能运行多个服务器

如果不能访问请检查防火墙

基岩版使用 UDP

enable-query​

数据类型默认值
Booleanon

启用 Query 查询

详见：https://wiki.vg/Query

motd​

数据类型默认值
StringMinecraft Server

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

备注

不能为空

sub-motd​

数据类型默认值
StringPowered by Nukkit-MOT

motd 的第二行

备注

只有当在游戏中的好友列表中查看服务器时，才会显示给本地网络中的玩家

自 1.16.210 以来不能为空

view-distance​

数据类型默认值
Integer8

最大视距（以区块为单位）

更大的值 = 加载更多区块 = 更多的内存和 CPU 使用

achievements​

数据类型默认值
Booleanon

启用玩家成就

announce-player-achievements​

数据类型默认值
Booleanon

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

spawn-protection​

数据类型默认值
Integer10

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

max-players​

数据类型默认值
Integer50

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

drop-spawners​

数据类型默认值
Booleanon

刷怪笼被挖掘后掉落

spawn-animals​

数据类型默认值
Booleanoff

启用动物生成

spawn-mobs​

数据类型默认值
Booleanoff

启用怪物生成

gamemode​

数据类型默认值
Integer2

服务器的默认游戏模式

0 = 生存, 1 = 创造, 2 = 冒险, 3 = 旁观

force-gamemode​

数据类型默认值
Booleanon

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

difficulty​

数据类型默认值
Integer2

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

hardcore​

数据类型默认值
Booleanoff

玩家死亡后将其封禁

pvp​

数据类型默认值
Booleanon

是否启用玩家对战

white-list​

数据类型默认值
Booleanoff

仅允许白名单中的玩家加入服务器

使用/whitelist命令或修改 white-list.txt 来添加玩家到白名单

whitelist-reason​

数据类型默认值
StringServer is white-listed

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

generator-settings​

数据类型默认值
String

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

level-name​

数据类型默认值
Stringworld

默认世界的名称

level-seed​

数据类型默认值
String

默认世界的种子

level-type​

数据类型默认值
Stringvoid

如果默认世界不存在，则使用的生成器

默认支持：default, normal, flat, nether, the_end或void

enable-rcon​

数据类型默认值
Booleanoff

启用远程控制台访问

备注

RCON 不是一个非常安全的远程控制服务器的方式

RCON 可以使用与服务器相同的端口（TCP 协议）

详见：https://developer.valvesoftware.com/wiki/Source_RCON_Protocol

rcon.password​

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

RCON 连接的密码

rcon.port​

数据类型默认值
Integer25575

RCON 连接的端口

auto-save​

数据类型默认值
Booleanon

自动保存世界、玩家数据

备注

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

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

force-resources​

数据类型默认值
Booleanoff

强制玩家下载服务器的资源包后才能加入

还请参阅 force-resources-allow-client-packs

force-resources-allow-client-packs​

数据类型默认值
Booleanoff

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

xbox-auth​

数据类型默认值
Booleanon

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

备注

不会绕过客户端的限制条件。

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

encryption​

数据类型默认值
Booleanon

启用网络加密

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

bed-spawnpoints​

数据类型默认值
Booleanon

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

explosion-break-blocks​

数据类型默认值
Booleanon

启用爆炸对方块造成的破坏

影响所有爆炸，如 TNT、苦力怕和末影水晶

stop-in-game​

数据类型默认值
Booleanon

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

op-in-game​

数据类型默认值
Booleanon

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

xp-bottles-on-creative​

数据类型默认值
Booleanon

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

spawn-eggs​

数据类型默认值
Booleanoff

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

mob-ai​

数据类型默认值
Booleanon

启用 MobPlugin 的生物 AI

entity-auto-spawn-task​

数据类型默认值
Booleanoff

启用自动生成怪物和动物的任务

生成功能依据服务器的游戏难度来工作

注意：如果您希望生成任何生物，必须启用spawn-animals、spawn-mobs其一，或者两者都启用。

entity-despawn-task​

数据类型默认值
Booleanoff

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

备注

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

language​

数据类型默认值
Stringeng

Nukkit 使用的默认语言

force-language​

数据类型默认值
Booleanoff

强制使用服务器端翻译

只有在你有插件来实现这些翻译时才启用

shutdown-message​

数据类型默认值
StringServer closed

当您停止服务器时向玩家显示的消息

可以使用颜色符号§，换行请使用 §n。

save-player-data​

数据类型默认值
Booleanon

如果启用，则以其UUID保存玩家数据的格式，并自动将旧格式的玩家数据转换为新格式

如果使用旧版Waterdog代理，请禁用此功能

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

query-plugins​

数据类型默认值
Booleanoff

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

debug-level​

数据类型默认值
Integer1

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

async-workers​

数据类型默认值
Stringauto

异步工作线程数

如果设置为 auto，则会尝试自动检测核心数进行调整

zlib-provider​

数据类型默认值
Integer2

选择 zlib 提供程序

0 = ZlibOriginal，1 = ZlibSingleThreadLowMem，2 = ZlibThreadLocal

默认：2

其他提供程序可能会对服务器的性能产生负面影响

compression-level​

数据类型默认值
Integer4

发送数据包的 Zlib 压缩级别（0-9）

更高的值 = 更多的 CPU 占用 + 更少的网络占用

compression-threshold​

数据类型默认值
Integer256

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

use-snappy-compression​

数据类型默认值
Booleanon

使用 Snappy 压缩数据包

min-mtu​

数据类型默认值
Integer576

设置最小 MTU 大小

默认值：576

max-mtu​

数据类型默认值
Integer1492

设置最大 MTU 大小（576 - 1492）

值越大网络发包越高效，但较小的值或许可以解决某些连接上的问题。

rak-packet-limit​

数据类型默认值
Integer120

每个ip可以在一个 RakNet 周期（10ms）内发送的数据包数量

超过此限制的ip将被暂时封禁

Data TypeDefault Value
Booleanon

启用此选项后，服务器会在客户端连接时发送一个 Cookie，用于验证客户端的合法性。

这将增强连接的安全性，防止潜在的恶意连接或攻击。

timeout-milliseconds​

数据类型默认值
Integer25000

如果客户端没有响应，服务器应该等待多长时间后踢出玩家

单位为毫秒，1000 毫秒 = 1 秒

auto-tick-rate​

数据类型默认值
Booleanon

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

auto-tick-rate-limit​

数据类型默认值
Integer20

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

base-tick-rate​

数据类型默认值
Integer1

基础游戏刻速率

1 = 每秒 20 个刻度，2 = 每秒 10 个刻度，以此类推。

建议保持默认值（1）。

always-tick-players​

数据类型默认值
Booleanoff

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

light-updates​

数据类型默认值
Booleanoff

光照更新

clear-chunk-tick-list​

数据类型默认值
Booleanon

允许服务器在完成每个游戏刻的逻辑更新后，清空用于追踪哪些区块需要进行逻辑更新的列表 chunkTickList。

这可以帮助优化服务器性能，防止不必要的计算，特别是在大型服务器或有大量区块需要管理的情况下。

spawn-threshold​

数据类型默认值
Integer56

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

chunk-sending-per-tick​

数据类型默认值
Integer4

每游戏刻发送的区块数

chunk-ticking-per-tick​

数据类型默认值
Integer40

每游戏刻 chunkTickList 存储的区块数

chunk-ticking-radius​

Data TypeDefault Value
Integer3

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

chunk-generation-queue-size​

Data TypeDefault Value
Integer8

等待生成的区块数量

chunk-generation-population-queue-size​

Data TypeDefault Value
Integer8

等待填充的区块数量

ticks-per-autosave​

Data TypeDefault Value
Integer6000

世界自动保存任务运行的频率

以刻为单位，20刻 = 1秒

ticks-per-entity-spawns​

Data TypeDefault Value
Integer200

实体自动生成任务运行的频率

以刻为单位，20刻 = 1秒

ticks-per-entity-despawns​

Data TypeDefault Value
Integer12000

实体存活的时间

以刻为单位，20刻 = 1秒

thread-watchdog​

数据类型默认值
Booleanon

启用线程看门狗

thread-watchdog-tick​

数据类型默认值
Integer60000

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

nether​

数据类型默认值
Booleanoff

生成地狱世界

end​

数据类型默认值
Booleanoff

生成末地世界

vanilla-portals​

数据类型默认值
Booleanon

原版传送门

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​

数据类型默认值
Booleanon

加载所有世界

ansi-title​

数据类型默认值
Booleanoff

启用在 Windows CMD 标题中显示服务器占用信息

block-listener​

数据类型默认值
Booleanon

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

allow-flight​

数据类型默认值
Booleanoff

启用/禁用飞行反作弊

multiversion-min-protocol​

数据类型默认值
Integer0

多版本的最低协议

multiversion-max-protocol​

数据类型默认值
Integer-1

多版本的最高协议

vanilla-bossbars​

数据类型默认值
Booleanoff

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

strong-ip-bans​

数据类型默认值
Booleanoff

强制 IP 封禁

worlds-level-auto-save-disabled​

数据类型默认值
String

禁用自动保存

等级的世界

temp-ip-ban-failed-xbox-auth​

数据类型默认值
Booleanoff

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

call-data-pk-send-event​

数据类型默认值
Booleanon

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

call-batch-pk-send-event​

数据类型默认值
Booleanon

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

do-level-gc​

数据类型默认值
Booleanon

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

skin-change-cooldown​

数据类型默认值
Integer15

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

check-op-movement​

数据类型默认值
Booleanoff

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

do-not-limit-interactions​

数据类型默认值
Booleanoff

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

do-not-limit-skin-geometry​

数据类型默认值
Booleanon

禁用最大皮肤几何大小检查

可能对某些玩家，皮肤的可用性是必需的

automatic-bug-report​

数据类型默认值
Booleanon

启用自动报告错误

anvils-enabled​

数据类型默认值
Booleanon

启用铁砧

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

save-player-data-by-uuid​

数据类型默认值
Booleanon

如果启用，则以 NukkitX 使用的格式保存玩家数据，并自动将旧格式的玩家数据转换为新格式

如果使用旧版 WaterdogPE 代理，请禁用此功能

备注

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

persona-skins​

数据类型默认值
Booleanon

允许玩家自己的皮肤

备注

如果禁用，将显示默认的史蒂夫皮肤

某些玩家的皮肤可能需要启用 do-not-limit-skin-geometry 才能使用

call-entity-motion-event​

数据类型默认值
Booleanon

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

update-notifications​

数据类型默认值
Booleanon

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

bstats-metrics​

数据类型默认值
Booleanon

启用 bStats 统计

https://bstats.org/plugin/server-implementation/Nukkit/

匿名收集数据：Nukkit 版本（Nukkit-MOT）、玩家数量、玩家游戏版本、是否开启 Xbox 身份验证、Java 版本、操作系统、CPU 架构及数量、服务器地理位置（粗略）

cache-chunks​

数据类型默认值
Booleanoff

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

备注

多版本支持的效果不佳

async-chunks​

数据类型默认值
Booleanon

启用异步区块发送

当向不同版本的玩家发送大量区块时，这可以极大地提高性能

建议保持此选项开启

deprecated-verbose​

数据类型默认值
Booleanon

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

server-authoritative-movement​

数据类型默认值
Stringserver-auth

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

server-authoritative-block-breaking​

数据类型默认值
Booleanon

服务器权威方块破坏

use-client-spectator​

数据类型默认值
Booleanon

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

enable-experiment-mode​

数据类型默认值
Booleanon

启用实验模式

use-waterdog​

数据类型默认值
Booleanoff

尝试获取 WaterdogPE 提供的客户端真实 IP

详见：https://waterdog.dev/

enable-spark​

数据类型默认值
Booleanoff

启用 Spark 用于性能分析

详见：https://spark.lucko.me/docs

hastebin-token​

数据类型默认值
String

Hastebin 令牌，方便生成 debug 链接

详见：https://www.toptal.com/developers/hastebin/documentation

use-native-leveldb​

数据类型默认值
Booleanoff

使用原生的 LevelDB 实现

enable-raw-ores​

数据类型默认值
Booleanon

启用粗矿石；若启用则对高版本玩家掉落粗铜、粗铁、粗金

版本自 BE 1.17.0 起

leveldb-cache-mb​

数据类型默认值
Integer80

与 use-native-leveldb 一同使用

用于减少每个世界硬盘读写操作的区块数据最大缓存大小

如果你拥有大量内存并且仅有几个大型世界，可以调高此缓存大小

forced-safety-enchant​

Data TypeDefault Value
Booleanon

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