server.properties 与游戏参数
用「环境变量」修改 MOTD、人数、难度、正版验证、白名单等常用设置,以及直接编辑 server.properties 时需要注意的覆盖规则。
Minecraft · 更新于
server.properties 是 Minecraft 服务端的主配置文件,位于文件管理的根目录,首次开机后生成。平台把其中最常用的选项做成了实例的「环境变量」,在网页上选一选就能改,不用手写配置文件。
用环境变量修改(推荐)
- 打开实例详情,切到「环境变量」标签。
- 找到要改的项目,输入新值或从下拉框中选择。
- 点击「保存变量」。改错了可以点「撤销修改」恢复到上次保存的状态。
- 点击底栏的「重启」(服务器未运行时点「开机」),新的值会在启动时写入
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),可以直接编辑文件:
- 打开「文件管理」标签,双击根目录下的
server.properties打开在线编辑器。 - 修改后保存。
- 重启服务器使配置生效。
注意事项:
server-port由平台管理,每次启动都会被改回容器端口,请不要修改,也不需要改成外网端口。- MOTD 包含中文时建议通过「服务器描述(MOTD)」变量设置,平台会自动转成服务端能识别的编码;直接在文件里写中文,部分旧版本服务端可能显示乱码。
- 修改
level-name会让服务端读取另一个世界目录,原世界不会被删除,改回原名即可恢复。
文件管理的完整用法见 文件管理。
常见场景
更换世界种子或重新生成世界
世界种子只对新世界生效,已有世界不会因为改种子而变化。要用新种子重新生成:
- 在「环境变量」中填写「世界种子」并保存。
- 关机后在「文件管理」中把
world目录(Paper、Purpur 等还有world_nether、world_the_end)改名或删除。删除前请先勾选这些目录点「下载」备份到本地。 - 开机,服务端会用新种子生成世界。
上传自己的存档
- 关机。
- 在本地把存档文件夹压缩成 zip,通过「文件管理」上传到根目录后解压;网页上传单个文件有大小限制,存档较大时请用 SFTP 直接上传文件夹。
- 把存档目录名改成与
level-name一致(默认是world),或者把level-name改成你的存档目录名。 - 开机。
单人存档的 Nether 和 End 维度在存档目录内部,Paper 等核心首次启动时会自动迁移成独立的 world_nether、world_the_end 目录。
设置管理员
在「控制台」中执行:
op 玩家名
deop 玩家名
管理员名单保存在 ops.json。基岩版请编辑 permissions.json 或在控制台使用 op 玩家名。
