server.properties 全项速查表

你照教程改 simulation-distance，回头打开 Minexa 的配置页，几十个开关排在一起，不知道它藏在哪一组；又或者你想改页面上没有的键，不确定该去表单里找还是直接改文件。

这一页把 Java 系的 75 项和 PowerNukkitX 的 25 项压成表格，只保留四件事：键名、默认值、建议值、改完要不要重启。完整解释在基础项详解和进阶项详解，这里负责“快速定位”。

查表之前先接受一件事：这些默认值来自 Minexa 1.5.0 配置页的预设，不是你手机里那份文件的真实内容。不同核心、不同 MC 版本生成的键会多几个少几个，表里没有的键以实际生成为准。

本页要点

用法只有一句：先在表里找到键，再看“建议”列和“重启”列。
server.properties 对应 Java 系，pnx.yml 对应 PowerNukkitX，键名不通用。
保存成功不等于已经生效，多数项要停服重启才读进新值。

先弄清三件事#

文件	谁在用	在 Minexa 里怎么改
`server.properties`	Java 系核心（Paper、Purpur、Spigot、Fabric、Forge、Vanilla 等）	服务器管理 → 服务器配置，37 项基础 + 38 项高级
`pnx.yml`	PowerNukkitX	同一个配置页，25 项；保存时端口会同步写进 `server.properties`
其他配置	PocketMine-MP、BDS	不在这个表单里，需要进文件管理手动改

三点提醒：首次启动前没有表单（文件要等服务端第一次启动才生成）；表单只有开关、输入框和下拉，改注释或加表单外的键要用文件管理页的文本编辑器；Java 系运行中能保存，PNX 运行中保存会被直接拒绝。

Java 基础配置（37 项）#

“重启”列写“是”的都要停服再启动；标 * 的能用命令临时改。

键	默认	建议	说明	重启
`difficulty`	`easy`	`normal`	怪物强度与饥饿速度	是*
`gamemode`	`survival`	`survival`	新玩家默认模式	是*
`pvp`	`true`	`true`	玩家互相攻击	是
`white-list`	`false`	`true`	只允许名单内进入	是*
`online-mode`	`true`	`true`	正版验证，关掉即离线模式	是
`enforce-whitelist`	`false`	`false`	OP 是否也受白名单限制	是
`max-players`	`20`	`3–8`	同时在线人数上限	是
`server-port`	`25565`	`25565`	TCP 监听端口	是
`server-ip`	`空`	`空`	留空监听所有网卡	是
`motd`	`A Minecraft Server`	自定义	多人列表的服务器描述	是
`view-distance`	`10`	`6–8`	客户端可见半径（3–32）	是
`simulation-distance`	`10`	`6–8`	服务端模拟半径（3–32）	是
`max-world-size`	`29999984`	默认	世界边界半径（格）	是
`spawn-protection`	`16`	`0`	出生点保护半径（0–16）	是
`hardcore`	`false`	`false`	极限模式，死亡后封禁	是
`enable-command-block`	`false`	`false`	允许使用命令方块	是
`allow-flight`	`false`	`false`	生存允许飞行	是
`allow-nether`	`true`	`true`	是否生成下界	是
`spawn-animals`	`true`	`true`	生成动物	是
`spawn-monsters`	`true`	`true`	生成敌对生物	是
`spawn-npcs`	`true`	`true`	生成村民等 NPC	是
`generate-structures`	`true`	`true`	生成村庄等结构	是
`level-name`	`world`	`world`	世界文件夹名	是
`level-seed`	`空`	`空`	留空随机生成	是
`level-type`	`minecraft:normal`	默认	地形类型	是
`force-gamemode`	`false`	`false`	重进时套用默认模式	是
`max-tick-time`	`60000`	默认	单 tick 超时毫秒数	是
`enable-status`	`true`	`true`	列表显示在线状态	是
`hide-online-players`	`false`	`false`	列表隐藏玩家名单	是
`op-permission-level`	`4`	`4`	新 OP 默认等级（1–4）	是
`function-permission-level`	`2`	`2`	数据包函数等级（1–4）	是
`rate-limit`	`空`	`0`	每秒数据包上限，0 不限	是
`require-resource-pack`	`false`	`false`	缺资源包即踢出	是
`resource-pack`	`空`	`空`	资源包下载地址	是
`player-idle-timeout`	`空`	`0`	空闲踢出分钟，0 禁用	是
`network-compression-threshold`	`256`	`256`	压缩阈值，-1 禁用	是
`max-chained-neighbor-updates`	`1000000`	默认	限制链式方块更新	是

Java 高级配置（38 项）#

键	默认	建议	说明	重启
`accepts-transfers`	`false`	`false`	接受其他服转来的玩家	是
`broadcast-console-to-ops`	`true`	`true`	控制台命令广播给 OP	是
`broadcast-rcon-to-ops`	`true`	`true`	RCON 命令广播给 OP	是
`bug-report-link`	`空`	`空`	崩溃页面的反馈链接	是
`chat-spam-threshold-seconds`	`10`	`10`	聊天刷屏阈值（秒）	是
`command-spam-threshold-seconds`	`10`	`10`	命令刷屏阈值（秒）	是
`debug`	`false`	`false`	输出调试日志	是
`enable-code-of-conduct`	`false`	`false`	微软行为准则提示	是
`enable-jmx-monitoring`	`false`	`false`	启用 JMX 远程监控	是
`enable-query`	`false`	`false`	开启 GameSpy4 查询	是
`enable-rcon`	`false`	`false`	开启 RCON 远程控制	是
`entity-broadcast-range-percentage`	`100`	`75`	实体同步距离百分比	是
`generator-settings`	`{}`	`{}`	自定义地形 JSON	是
`initial-disabled-packs`	`空`	`空`	禁用的数据包	是
`initial-enabled-packs`	`vanilla`	`vanilla`	启用的数据包	是
`log-ips`	`true`	`true`	日志记录玩家 IP	是
`management-server-allowed-origins`	`空`	`空`	允许的来源	是
`management-server-enabled`	`false`	`false`	启用管理服务器	是
`management-server-host`	`localhost`	`localhost`	管理服务器监听地址	是
`management-server-port`	`空`	`空`	0 表示自动分配端口	是
`management-server-secret`	`空`	`空`	认证密钥	是
`management-server-tls-enabled`	`true`	`true`	启用 TLS	是
`management-server-tls-keystore`	`空`	`空`	TLS 密钥库路径	是
`management-server-tls-keystore-password`	`空`	`空`	密钥库密码	是
`pause-when-empty-seconds`	`-1`	`-1`	空服暂停秒数，-1 禁用	是
`prevent-proxy-connections`	`false`	`false`	阻止代理或 VPN 连接	是
`query.port`	`25565`	`25565`	GameSpy4 查询端口	是
`rcon.password`	`空`	`空`	RCON 密码，留空即禁用	是
`rcon.port`	`25575`	`25575`	RCON 监听端口	是
`region-file-compression`	`deflate`	`deflate`	区块文件压缩算法	是
`resource-pack-id`	`空`	`空`	资源包 UUID	是
`resource-pack-prompt`	`空`	`空`	拒绝资源包时的提示	是
`resource-pack-sha1`	`空`	`空`	资源包 SHA-1 校验值	是
`status-heartbeat-interval`	`空`	`空`	状态心跳间隔（秒）	是
`sync-chunk-writes`	`true`	`true`	同步写入区块	是
`text-filtering-config`	`空`	`空`	聊天文本过滤配置	是
`text-filtering-version`	`空`	`空`	文本过滤协议版本	是
`use-native-transport`	`true`	`true`	用原生网络传输	是

PNX 配置（25 项）#

PowerNukkitX 读 pnx.yml，不是 server.properties。配置页项目名和 YAML 字段名不完全一样，YAML 按 settings.*、gameplay-settings.*、performance-settings.baseTps、network-settings.enableQuery 分组；字段拼写以实际生成的文件为准，别照抄 Java 键名。

配置页项目	默认	建议	说明
`server-ip`	`0.0.0.0`	`0.0.0.0`	0.0.0.0 表示所有网卡
`server-port`	`19132`	`19132`	基岩版 UDP 端口
`max-players`	`20`	`3–8`	同时在线人数上限
`motd`	`PowerNukkitX Server`	自定义	服务器列表主描述
`sub-motd`	`powernukkitx.org`	自定义	服务器列表副描述
`language`	`eng`	默认	服务端语言代码
`level-name`	`world`	`world`	默认世界文件夹名
`auto-save`	`true`	`true`	自动保存世界
`white-list`	`false`	`true`	启用白名单
`online-mode`	`true`	`true`	Xbox 账号验证
`gamemode`	`survival`	`survival`	默认游戏模式
`force-gamemode`	`false`	`false`	重进时套用默认模式
`difficulty`	`easy`	`normal`	YAML 存数字
`pvp`	`true`	`true`	玩家互相攻击
`view-distance`	`8`	`4–6`	视距（区块）
`spawn-protection`	`16`	`0`	出生点保护范围
`allow-nether`	`true`	`true`	允许进入下界
`allow-the-end`	`true`	`true`	允许进入末地
`enable-command-block`	`false`	`false`	允许使用命令方块
`spawn-animals`	`true`	`true`	启用实体生成
`weather-cycle`	`true`	`true`	天气自动变化
`daylight-cycle`	`true`	`true`	昼夜自动变化
`hunger`	`true`	`true`	启用饥饿机制
`base-tps`	`20`	`20`	基础 TPS，属性能组
`enable-status`	`true`	`true`	启用服务器查询

几组最容易混淆的键#

view-distance 和 simulation-distance。 前者决定客户端能看多远，后者决定服务端真的运算多远。只降视距，红石和刷怪照旧，两个一起降性能才明显回稳。

online-mode 和 white-list。 前者管“认不认正版账号”，后者管“名单外的人能不能进”。关了正版验证不等于开了白名单，开了白名单也不代表进来的是本人。公网服建议两个都开才安全。

max-players 不是性能开关，spawn-protection 也不保护箱子。 前者只是同时在线上限，写 100 也不会让手机多出内存；后者只管出生点、不防 OP，朋友服嫌挖不动可设 0。

level-name 改了，世界就换了。 它指向世界文件夹名，改成 world2 会新建一个世界，原来的还在磁盘上但不再加载。改名字等于换世界，改之前先备份。

-1、0、空值含义不同。 空值多是“用核心默认”，0 多表示禁用或无限，-1 表示禁用。-1 和 0 不是一回事，拿不准就保持默认。

三套能直接抄的组合#

场景	建议改动
2–5 人手机原版/插件服	`view-distance=4`、`simulation-distance=4`、`max-players=5`、`spawn-protection=0`、`white-list=true`
8–10 人插件服	`view-distance=6`、`simulation-distance=5`、`max-players=10`、`network-compression-threshold=256`
基岩版 PNX（2–5 人）	`view-distance=4`、`max-players=5`、`spawn-protection=0`、`white-list=true`、`online-mode=true`

人数上限只代表“允许进来多少人”，不代表手机带得动；内存见内存分配。

改键之前的四条规矩#

一次只改一项。改完重启、进游戏验证，再改下一项；一次改十项，出错时不知道是谁。
先备份再动。尤其是 level-name、level-seed、level-type 这类碰到世界的键，见备份策略。
改端口要同步三处：配置文件、路由器/隧道、朋友手里的地址。
数字框不校验范围。视距填 99、人数填 9999 都会原样写进去；-1 只能进文本编辑器改。

找键的捷径

先按主题猜分组：玩法、世界、人数、端口在“基础配置”；RCON、Query、资源包、管理服务器、压缩在“高级配置”。

运行中改端口，地址会“看起来对了”

Java 系运行中保存配置，应用会立刻更新地址卡，但服务端还在监听旧端口。改端口请先停服。

上机自查

服务器配置页能看到 37 项基础 + 38 项高级，不再是“配置尚未生成”。
view-distance 和 simulation-distance 已改成 4，保存没有报错。
停服重启后进游戏看四周区块加载距离，和改过的视距对得上。
概览页地址卡里的端口和你填的一致，朋友也能连上。

下一步#

每个基础键的作用、风险和推荐值：server.properties 基础项
网络、性能、资源包与安全项：server.properties 进阶项
配置页怎么保存、为什么首次启动前是空的：服务器配置页