nukkit-mot.yml

Nukkit-MOT 服务器高级配置。设置按类别分组排序。

如需标准 Minecraft 服务器设置，请参阅 server.properties。

性能设置

`async-workers`

数据类型	默认值
String	auto

异步工作线程数

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

`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

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

`thread-watchdog`

数据类型	默认值
Boolean	on

启用线程看门狗

`thread-watchdog-tick`

数据类型	默认值
Integer	60000

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

`do-level-gc`

数据类型	默认值
Boolean	on

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

`ticks-per-autosave`

数据类型	默认值
Integer	6000

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

以刻为单位，20刻 = 1秒

`level-auto-compaction`

数据类型	默认值
Boolean	on

启用世界 LevelDB 自动压缩

`level-auto-compaction-ticks`

数据类型	默认值
Integer	36000

LevelDB 自动压缩任务运行的频率

以刻为单位，20刻 = 1秒（默认：36000 = 30 分钟）

`leveldb-cache-mb`

数据类型	默认值
Integer	64

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

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

`use-native-leveldb`

数据类型	默认值
Boolean	off

使用原生的 LevelDB 实现

`enable-spark`

数据类型	默认值
Boolean	off

启用 Spark 用于性能分析

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

网络设置

`zlib-provider`

数据类型	默认值
Integer	2

选择 zlib 提供程序

0 = ZlibOriginal，1 = ZlibSingleThreadLowMem，2 = ZlibThreadLocal

默认：2

注意

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

`compression-level`

数据类型	默认值
Integer	5

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

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

`chunk-compression-level`

数据类型	默认值
Integer	7

区块数据的 Zlib 压缩级别（0-9）

更高的值 = 更多的 CPU 占用 + 更小的区块数据包

`compression-threshold`

数据类型	默认值
Integer	256

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

`use-snappy-compression`

数据类型	默认值
Boolean	off

使用 Snappy 压缩数据包

`rak-packet-limit`

数据类型	默认值
Integer	120

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

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

`enable-rak-send-cookie`

数据类型	默认值
Boolean	on

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

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

备注

如果您无法进入服务器（尤其是使用代理时），可以尝试将此项设置为 false。

`timeout-milliseconds`

数据类型	默认值
Integer	25000

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

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

`query-plugins`

数据类型	默认值
Boolean	off

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

`use-waterdog`

数据类型	默认值
Boolean	off

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

详见：https://waterdog.dev/

`viaproxy-username-prefix`

数据类型	默认值
String

ViaProxy 连接的用户名前缀

`enable-proxy-protocol`

数据类型	默认值
Boolean	off

为 FRP 等 UDP 代理启用 HAProxy Proxy Protocol v2 解析。

当受信任代理发送合法的 PPv2 头时，Nukkit-MOT 会把代理源地址替换为玩家真实地址。这样依赖 IP 的日志、封禁和插件都能看到玩家真实 IP，而不是代理 IP。

注意

仅当服务器位于兼容的 UDP 代理之后时才应启用此项。加入白名单的代理来源必须发送合法的 PPv2 头。

`proxy-protocol-whitelist`

数据类型	默认值
`List<String>`	["127.0.0.1/32"]

允许发送 Proxy Protocol 头的受信任代理源 IP 或 CIDR 范围列表。

这里填写代理地址，而不是玩家地址。示例：127.0.0.1/32、10.0.0.0/8、203.0.113.5/32

备注

当前白名单仅支持 IPv4/CIDR 条目。

如果该列表为空，则会信任所有来源 IP 的 Proxy Protocol 头，安全性会降低。

来自白名单来源但不带头或携带非法头的报文会被直接丢弃。

区块设置

`sending-per-tick`

数据类型	默认值
Integer	4

每游戏刻发送的区块数

`ticking-per-tick`

数据类型	默认值
Integer	40

每游戏刻 chunkTickList 存储的区块数

`ticking-radius`

数据类型	默认值
Integer	3

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

`generation-queue-size`

数据类型	默认值
Integer	8

等待生成的区块数量

`generation-population-queue-size`

数据类型	默认值
Integer	8

等待填充的区块数量

`light-updates`

数据类型	默认值
Boolean	on

光照更新

`clear-chunk-tick-list`

数据类型	默认值
Boolean	on

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

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

`spawn-threshold`

数据类型	默认值
Integer	56

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

`cache-chunks`

数据类型	默认值
Boolean	off

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

`async-chunks`

数据类型	默认值
Boolean	on

启用异步区块发送

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

建议保持此选项开启

实体设置

`spawn-eggs`

数据类型	默认值
Boolean	on

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

`mob-ai`

数据类型	默认值
Boolean	on

启用生物 AI

`auto-spawn-task`

数据类型	默认值
Boolean	on

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

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

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

`despawn-task`

数据类型	默认值
Boolean	on

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

备注

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

`ticks-per-spawns`

数据类型	默认值
Integer	200

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

以刻为单位，20刻 = 1秒

`ticks-per-despawns`

数据类型	默认值
Integer	12000

实体存活的时间

以刻为单位，20刻 = 1秒

世界设置

`nether`

数据类型	默认值
Boolean	on

生成地狱世界

`end`

数据类型	默认值
Boolean	on

生成末地世界

`vanilla-portals`

数据类型	默认值
Boolean	on

原版传送门

`portal-ticks`

数据类型	默认值
Integer	80

玩家触发传送门所需 Tick

`multi-nether-worlds`

数据类型	默认值
List

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

`anti-xray-worlds`

数据类型	默认值
List

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

示例：[world, survival, factions]

`do-not-tick-worlds`

数据类型	默认值
List

禁用随机方块刻度的世界列表

这将禁用植物生长、树叶腐烂、草方块蔓延、方块掉落等。

你可能想在这里添加你的大堂和迷你游戏世界

`entity-spawning-disabled-worlds`

数据类型	默认值
List

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

示例：[lobby, pvp, creative]

`load-all-worlds`

数据类型	默认值
Boolean	on

加载所有世界

`auto-save-disabled-worlds`

数据类型	默认值
List

禁用自动保存的世界

`worlds`

数据类型	默认值
Map

自定义世界配置。每个条目定义一个世界及其生成器、种子和生成器设置。

示例：

worlds:
  my_world:
    generator: normal
    seed: 12345
    generator-settings: ""
  my_flat_world:
    generator: flat
    seed: 0
    generator-settings: ""

每个世界条目支持：

generator - 世界生成器类型（默认：normal）
seed - 世界种子（默认：0）
generator-settings - 生成器特定设置（默认：空）

玩家设置

`save-player-data`

数据类型	默认值
Boolean	on

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

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

`save-player-data-by-uuid`

数据类型	默认值
Boolean	on

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

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

`persona-skins`

数据类型	默认值
Boolean	on

允许玩家自己的皮肤

备注

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

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

`skin-change-cooldown`

数据类型	默认值
Integer	15

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

`do-not-limit-skin-geometry`

数据类型	默认值
Boolean	on

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

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

`do-not-limit-interactions`

数据类型	默认值
Boolean	off

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

`space-name-mode`

数据类型	默认值
String	ignore

玩家名称中带有空格的处理方式

"disabled" - 禁止带有空格名称的玩家进入服务器

"ignore" - 忽略空格名称（默认）

"replacing" - 用"_"替换玩家名称中的空格

`xp-bottles-on-creative`

数据类型	默认值
Boolean	on

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

`stop-in-game`

数据类型	默认值
Boolean	off

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

`op-in-game`

数据类型	默认值
Boolean	on

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

调试设置

`debug-level`

数据类型	默认值
Integer	1

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

`ansi-title`

数据类型	默认值
Boolean	off

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

`deprecated-verbose`

数据类型	默认值
Boolean	on

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

`call-data-pk-send-event`

数据类型	默认值
Boolean	on

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

`call-batch-pk-send-event`

数据类型	默认值
Boolean	on

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

`call-entity-motion-event`

数据类型	默认值
Boolean	on

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

`block-listener`

数据类型	默认值
Boolean	on

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

`automatic-bug-report`

数据类型	默认值
Boolean	on

启用自动报告错误

`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 架构及数量、服务器地理位置（粗略）

`hastebin-token`

数据类型	默认值
String

Hastebin 令牌，方便生成 debug 链接

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

游戏功能设置

`achievements`

数据类型	默认值
Boolean	on

启用玩家成就

`announce-player-achievements`

数据类型	默认值
Boolean	on

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

`bed-spawnpoints`

数据类型	默认值
Boolean	on

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

`explosion-break-blocks`

数据类型	默认值
Boolean	on

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

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

`drop-spawners`

数据类型	默认值
Boolean	on

刷怪笼被挖掘后掉落

`anvils-enabled`

数据类型	默认值
Boolean	on

启用铁砧

`vanilla-bossbars`

数据类型	默认值
Boolean	off

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

`use-client-spectator`

数据类型	默认值
Boolean	on

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

`enable-experiment-mode`

数据类型	默认值
Boolean	on

启用实验模式

`multiversion-min-protocol`

数据类型	默认值
Integer	0

多版本的最低协议

`multiversion-max-protocol`

数据类型	默认值
Integer	-1

多版本的最高协议

`enable-raw-ores`

数据类型	默认值
Boolean	on

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

版本自 BE 1.17.0 起

`enable-new-paintings`

数据类型	默认值
Boolean	on

启用在1.21版本新加入的画

`enable-new-chicken-eggs-laying`

数据类型	默认值
Boolean	on

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

`forced-safety-enchant`

数据类型	默认值
Boolean	on

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

`enable-vibrant-visuals`

数据类型	默认值
Boolean	on

启用灵动视效效果支持

`enable-raytracing`

数据类型	默认值
Boolean	on

启用光线追踪支持

`temp-ip-ban-failed-xbox-auth`

数据类型	默认值
Boolean	off

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

`strong-ip-bans`

数据类型	默认值
Boolean	off

强制 IP 封禁

`check-op-movement`

数据类型	默认值
Boolean	off

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

网易设置

`client-support`

数据类型	默认值
Boolean	off

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

`only-allow-netease-client`

数据类型	默认值
Boolean	off

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

性能设置
网络设置
区块设置
实体设置
世界设置
玩家设置
调试设置
游戏功能设置
网易设置
- client-support
- only-allow-netease-client

性能设置​

async-workers​

auto-tick-rate​

auto-tick-rate-limit​

base-tick-rate​

always-tick-players​

thread-watchdog​

thread-watchdog-tick​

do-level-gc​

ticks-per-autosave​

level-auto-compaction​

level-auto-compaction-ticks​

leveldb-cache-mb​

use-native-leveldb​

enable-spark​

网络设置​

zlib-provider​

compression-level​

chunk-compression-level​

compression-threshold​

use-snappy-compression​

rak-packet-limit​

enable-rak-send-cookie​

timeout-milliseconds​

query-plugins​

use-waterdog​

viaproxy-username-prefix​

enable-proxy-protocol​

proxy-protocol-whitelist​

区块设置​

sending-per-tick​

ticking-per-tick​

ticking-radius​

generation-queue-size​

generation-population-queue-size​

light-updates​

clear-chunk-tick-list​

spawn-threshold​

cache-chunks​

async-chunks​

实体设置​

spawn-eggs​

mob-ai​

auto-spawn-task​

despawn-task​

ticks-per-spawns​

ticks-per-despawns​

世界设置​

nether​

end​

vanilla-portals​

portal-ticks​

multi-nether-worlds​

anti-xray-worlds​

do-not-tick-worlds​

entity-spawning-disabled-worlds​

load-all-worlds​

auto-save-disabled-worlds​

worlds​

玩家设置​

save-player-data​

save-player-data-by-uuid​

persona-skins​

skin-change-cooldown​

do-not-limit-skin-geometry​

do-not-limit-interactions​

space-name-mode​

xp-bottles-on-creative​

stop-in-game​

op-in-game​

调试设置​

debug-level​

ansi-title​

deprecated-verbose​

call-data-pk-send-event​

call-batch-pk-send-event​

call-entity-motion-event​

block-listener​

automatic-bug-report​

update-notifications​

性能设置

`async-workers`

`auto-tick-rate`

`auto-tick-rate-limit`

`base-tick-rate`

`always-tick-players`

`thread-watchdog`

`thread-watchdog-tick`

`do-level-gc`

`ticks-per-autosave`

`level-auto-compaction`

`level-auto-compaction-ticks`

`leveldb-cache-mb`

`use-native-leveldb`

`enable-spark`

网络设置

`zlib-provider`

`compression-level`

`chunk-compression-level`

`compression-threshold`

`use-snappy-compression`

`rak-packet-limit`

`enable-rak-send-cookie`

`timeout-milliseconds`

`query-plugins`

`use-waterdog`

`viaproxy-username-prefix`

`enable-proxy-protocol`

`proxy-protocol-whitelist`

区块设置

`sending-per-tick`

`ticking-per-tick`

`ticking-radius`

`generation-queue-size`

`generation-population-queue-size`

`light-updates`

`clear-chunk-tick-list`

`spawn-threshold`

`cache-chunks`

`async-chunks`

实体设置

`spawn-eggs`

`mob-ai`

`auto-spawn-task`

`despawn-task`

`ticks-per-spawns`

`ticks-per-despawns`

世界设置

`nether`

`end`

`vanilla-portals`

`portal-ticks`

`multi-nether-worlds`

`anti-xray-worlds`

`do-not-tick-worlds`

`entity-spawning-disabled-worlds`

`load-all-worlds`

`auto-save-disabled-worlds`

`worlds`

玩家设置

`save-player-data`

`save-player-data-by-uuid`

`persona-skins`

`skin-change-cooldown`

`do-not-limit-skin-geometry`

`do-not-limit-interactions`

`space-name-mode`

`xp-bottles-on-creative`

`stop-in-game`

`op-in-game`

调试设置

`debug-level`

`ansi-title`

`deprecated-verbose`

`call-data-pk-send-event`

`call-batch-pk-send-event`

`call-entity-motion-event`

`block-listener`

`automatic-bug-report`

`update-notifications`