先给结论
server.properties 是基岩版服务端唯一的权威配置来源,改错一项就可能出现连不上、权限失控或严重卡顿。正确做法是按网络、玩法、性能、安全四组分别理解,一次只改一组,改完重启并从日志确认生效,同时保留上一版配置用于对比。
一、网络组:先让它能被正确连上
网络组决定玩家能不能进。server-port 是 IPv4 监听端口,server-portv6 是 IPv6 侧的监听端口,两者可以不同,但公告里给玩家的必须与实际监听一致。基岩版走 UDP,任何只放行 TCP 的配置都会导致本机能进、外网进不来。
max-players 是并发上限,设得过高会让服务端在高峰时段被压垮,设得过低会让玩家排队进不来。建议按实测承载量设置并留少量余量,而不是直接填一个大数字当作「不限」。
online-mode 与 allow-list 决定准入基调:前者影响账号验证,后者是白名单开关。这两项组合必须与你对外宣传的开放程度一致,否则会出现公告说白名单制、实际却人人可进的矛盾。
二、玩法组:一次定好,避免反复变更
玩法组包括 gamemode、difficulty、allow-cheats、level-name、level-seed 等。世界生成之后再去改 level-seed 不会改变已有地形,这点必须在开服前就想明白,否则容易在开服后才发现种子选错。
level-name 决定加载哪个世界目录,它与 worlds 下的目录名必须严格对应,大小写和空格都要一致。导入单机存档失败最常见的原因就是这里名字不一致,服务端于是在旁边新建了一个同名之外的世界。
allow-cheats 打开后谁能用命令、能用哪些命令,是权限设计问题,不是开关问题。纯生存服建议关闭,需要活动与管理时按角色授权,并在活动结束后收回。
三、性能组:用基线数据说话
view-distance 控制下发给客户端的可视距离,tick-distance 控制实际模拟范围。这两个参数是基岩版性能调节的主要旋钮,但含义不同:前者影响画质与带宽,后者影响实体与方块更新的实际开销。
max-threads 与 compression-threshold 属于进阶项。在不清楚含义与当前瓶颈的情况下,改动它们往往只是把问题换个形态。正确顺序是先建立基线,再逐个调整并复测同样的场景与人数。
任何性能改动都要有对比记录:同人数、同区域、同玩法下的 TPS 表现与玩家主观体验。没有对比的调优只是换了一组数字,无法证明变好了。
四、安全组:把暴露面收小
安全相关的项包括白名单、默认玩家权限级别、聊天限制、玩家交互限制等。默认权限级别决定新玩家进来能做什么,把它设得过高是最常见的权限事故来源。
资源包强制项与内容相关设置也要纳入安全与体验的考量:强制下载会带来加载失败风险,尤其是在移动端和弱网环境。开启前必须有回退方案,避免资源包服务故障时把所有玩家挡在门外。
配置文件的变更本身就是风险。建议每次修改前复制一份带日期的旧版本,改完重启并从日志确认新值被读取,而不是假设保存即生效。出现异常时能立刻换回上一版,是最实用的应急处置。
执行步骤
- 先备份当前 server.properties 并标注日期与改动目的。
- 只修改网络组,重启后验证端口监听与外网可达。
- 确认无误后再改玩法组,重点核对 level-name 与 allow-cheats。
- 建立性能基线数据后,逐项调整 view-distance 与 tick-distance 并复测。
- 最后收安全组,把默认权限、白名单和交互限制调到目标状态。
- 把最终生效值整理成一份可查的配置说明,供团队与后续维护使用。
验收标准
- 公告中的端口与实际监听端口完全一致,外网可进。
- level-name 与 worlds 下目录名严格对应,未产生多余世界。
- 未授权玩家无法执行生成物品或切换模式等命令。
- 性能参数改动有前后对比数据,而非凭感觉。
- 保留至少一份可回退的历史配置。
- 团队中有人能说清每个改动项的作用与风险。
常见误区
- 一次改十几个参数,出问题后无法判断是哪一项导致。
- 把 view-distance 拉到很高,服务端与客户端同时卡顿。
- 世界已生成后再改种子,期待地形变化。
- 打开 allow-cheats 后忘记关闭,权限长期敞开。
- 修改配置未重启就用旧状态判断结果。
配置文件的正确用法是「小步、可回退、有记录」。把它当成需要版本管理的对象,而不是一次性的调参面板,后续排障成本会下降一个量级。