server.properties 与游戏参数

用「环境变量」修改 MOTD、人数、难度、正版验证、白名单等常用设置,以及直接编辑 server.properties 时需要注意的覆盖规则。

Minecraft · 更新于

server.properties 是 Minecraft 服务端的主配置文件,位于文件管理的根目录,首次开机后生成。平台把其中最常用的选项做成了实例的「环境变量」,在网页上选一选就能改,不用手写配置文件。

用环境变量修改(推荐)

  1. 打开实例详情,切到「环境变量」标签。
  2. 找到要改的项目,输入新值或从下拉框中选择。
  3. 点击「保存变量」。改错了可以点「撤销修改」恢复到上次保存的状态。
  4. 点击底栏的「重启」(服务器未运行时点「开机」),新的值会在启动时写入 server.properties。

保存变量本身不会重启服务器,也不会影响正在进行的游戏。环境变量页面的通用说明见 环境变量。

Java 版可用的参数

适用于 Paper、Spigot、Purpur、Folia、Mohist、Arclight、CatServer、Forge、Fabric。

环境变量 对应配置项 可选值 / 范围 说明
服务器描述(MOTD) motd 最多 120 字 玩家服务器列表里显示的描述,支持中文
最大玩家数 max-players 1~9999 同时在线人数上限
正版验证 online-mode 开启(仅正版)/ 关闭(允许离线账号) 关闭后非正版账号也能进
难度 difficulty 和平 / 简单 / 普通 / 困难
默认游戏模式 gamemode 生存 / 创造 / 冒险 / 旁观 新玩家进入时的模式
玩家互相攻击(PVP) pvp 允许 / 禁止
白名单 white-list 开启 / 关闭 开启后用 whitelist add 玩家名 添加
视距 view-distance 2~32 越大越占内存和带宽
允许飞行 allow-flight 允许 / 禁止 喷气背包等模组需要开启,否则玩家会被当作作弊踢出
出生点保护半径 spawn-protection 0~9999 格 非管理员不能破坏的范围,0 表示关闭
命令方块 enable-command-block 启用 / 禁用
极限模式 hardcore 开启 / 关闭 死亡后变为旁观模式
模拟距离 simulation-distance 3~32 实体和作物的运算距离,1.18 及以上有效
世界种子 level-seed 最多 64 字 只在生成新世界时生效

基岩版(Bedrock)可用的参数

环境变量 对应配置项 说明
服务器名称 server-name 默认 Bedrock Dedicated Server
游戏模式 gamemode 生存 / 创造 / 冒险
难度 difficulty 和平 / 简单 / 普通 / 困难,默认简单
允许作弊 allow-cheats 默认关闭
最大玩家数 max-players
Xbox Live 验证 online-mode 关闭后无需登录 Xbox 账号
白名单(allow-list) allow-list 名单保存在 allowlist.json
视距 view-distance 5 及以上
模拟距离 tick-distance 4~12
挂机踢出时间 player-idle-timeout 单位分钟,0 表示不踢
世界种子 level-seed 只在生成新世界时生效

NukkitX、Waterfall、Velocity 没有这些参数,请在文件管理中直接编辑各自的配置文件(NukkitX 为 server.properties 和 nukkit.yml,Waterfall 为 config.yml,Velocity 为 velocity.toml)。

留空和「未设置」是什么意思

Java 版以及基岩版带「MC_」前缀的参数默认都是空的:

  • 留空(下拉框选「未设置」)表示不修改 server.properties 里现有的值,你在文件里手动改的内容会被保留。
  • 一旦填了值,每次开机或重启都会用它覆盖文件里的对应项。

因此,同一个配置项请只选一种方式维护:要么用环境变量,要么清空变量后直接改文件。否则会出现"文件里改了,一重启又变回去"的情况。

基岩版的「服务器名称」「游戏模式」「难度」「允许作弊」四项始终有值,每次启动都会写入,修改它们只能通过环境变量。

直接编辑 server.properties

环境变量没有覆盖的选项(例如 level-name、allow-nether、max-world-size),可以直接编辑文件:

  1. 打开「文件管理」标签,双击根目录下的 server.properties 打开在线编辑器。
  2. 修改后保存。
  3. 重启服务器使配置生效。

注意事项:

  • server-port 由平台管理,每次启动都会被改回容器端口,请不要修改,也不需要改成外网端口。
  • MOTD 包含中文时建议通过「服务器描述(MOTD)」变量设置,平台会自动转成服务端能识别的编码;直接在文件里写中文,部分旧版本服务端可能显示乱码。
  • 修改 level-name 会让服务端读取另一个世界目录,原世界不会被删除,改回原名即可恢复。

文件管理的完整用法见 文件管理。

常见场景

更换世界种子或重新生成世界

世界种子只对新世界生效,已有世界不会因为改种子而变化。要用新种子重新生成:

  1. 在「环境变量」中填写「世界种子」并保存。
  2. 关机后在「文件管理」中把 world 目录(Paper、Purpur 等还有 world_nether、world_the_end)改名或删除。删除前请先勾选这些目录点「下载」备份到本地。
  3. 开机,服务端会用新种子生成世界。

上传自己的存档

  1. 关机。
  2. 在本地把存档文件夹压缩成 zip,通过「文件管理」上传到根目录后解压;网页上传单个文件有大小限制,存档较大时请用 SFTP 直接上传文件夹。
  3. 把存档目录名改成与 level-name 一致(默认是 world),或者把 level-name 改成你的存档目录名。
  4. 开机。

单人存档的 Nether 和 End 维度在存档目录内部,Paper 等核心首次启动时会自动迁移成独立的 world_nether、world_the_end 目录。

设置管理员

在「控制台」中执行:

op 玩家名
deop 玩家名

管理员名单保存在 ops.json。基岩版请编辑 permissions.json 或在控制台使用 op 玩家名。