1-产品使用教程 介绍
2
Minecraft
5
腐蚀
1
标签云
技术支持
我的工单
公告信息
帮助中心
资源下载
服务监控
提交工单

MC server.properties文件详解

Java版

操作系统 文件位置 注解
Windows server.jar 的相同目录下  
Linux

Unix Unix/Mac

 工作目录路径（pwd）

如果你在你的 home 目录下启动（/home/用户名），服务端文件也会在/home/用户名下创建。请按照下列步骤确保服务端文件能够如你预期地正确生成。

  • 准备一个完整的文件夹来存放所有服务端文件。（如果你不这么做的话事情会一团糟）
    • 把server.jar放置（复制、移动）进去。
  • 使用官方指导设置你的Minecraft服务端启动脚本。（我们假设你的Minecraft服务端启动脚本名是./start.sh）
    • 确保它位于你的可执行目录 $PATH
    • 确保你具有启动脚本的执行权限（chmod +x start.sh，或使用文件夹管理器）
      • ./start.sh

基岩版

操作系统 文件位置
Windows bedrock_server.exe的相同目录下
Linux bedrock_server的相同目录下

Java版

属性 类型 默认值 描述
allow-flight 布尔值 false 允许玩家在安装添加飞行功能的mod前提下在生存模式下飞行。

允许飞行可能会使恶意破坏者更加常见，因为此设定会使他们更容易达成目的。在创造模式下无作用。

false - 不允许飞行。悬空超过5秒的玩家会被踢出服务器。
true - 允许飞行。玩家得以使用任何能飞行的mod飞行。
allow-nether 布尔值 true 允许玩家进入下界。
false - 下界传送门不会生效。
true - 玩家可以通过下界传送门前往下界。
broadcast-console-to-ops 布尔值 true 向所有在线OP发送所执行命令的输出。
broadcast-rcon-to-ops 布尔值 true 向所有在线OP发送通过RCON执行的命令的输出。
difficulty 字符串 easy 定义服务器的游戏难度（例如生物对玩家造成的伤害，饥饿和中毒对玩家的影响方式等）。

如果设置了旧的数字ID，则会自动转化为英文的难度名称。

peaceful (0) - 和平
easy (1) - 简单
normal (2) - 普通
hard (3) - 困难
enable-command-block 布尔值 false 是否启用命令方块。
enable-jmx-monitoring 布尔值 false 暴露一个具有对象名net.minecraft.server:type=Server的MBean和两个属性averageTickTime和tickTimes用于暴露以毫秒为单位的tick时间。
为了启用JRE的JMX，你需要添加在此处所述的一些JVM标志。
enable-query 布尔值 false 允许使用GameSpy4协议的服务器监听器。用于获取服务器信息。
enable-rcon 布尔值 false 是否允许远程访问服务器控制台。
  • 由于RCON协议传输数据时没有加密，所以不建议把RCON暴露在互联网上。RCON客户端和服务端交换的所有数据（包括RCON密码）都会泄露给正在监听此连接的人。
enable-status 布尔值 true 使服务器在服务器列表中看起来是“在线”的。
enforce-secure-profile 布尔值 true 要求玩家必须具有Mojang签名的公钥才能进入服务器。
true - 不具有Mojang签名的公钥的玩家不能进入服务器。
false - 不具有Mojang签名的公钥的玩家也可进入服务器。
enforce-whitelist 布尔值 false 在服务器上强制执行白名单。

当启用后，不在白名单（前提是启用）中的用户将在服务器重新加载白名单文件后从服务器踢出。

true - 不在白名单上的用户会被踢出。
false - 不在白名单上的在线用户不会被踢出。
entity-broadcast-range-percentage 整数（10-1000） 100 此选项控制实体需要距离玩家有多近才会将数据包发送给客户端。更高的数值意味着实体可以在更远的地方就被渲染，同时也可能提高增加延迟的概率。
这个值是以默认值的百分比来表示的。例如：将此值设为50，表示将渲染正常情况下一半距离以内的生物。
此功能模仿了客户端视频设置中的功能，而不像客户端的渲染距离设置一样只能在服务器设置的限制下调整渲染距离。
force-gamemode 布尔值 false 强制玩家加入时为默认游戏模式。
false - 玩家将以退出前的游戏模式加入
true - 玩家总是以默认游戏模式加入
function-permission-level 整数（1-4） 2 设定函数的默认权限等级。

4个等级的详情见 #op-permission-level。
gamemode 字符串 survival 定义默认游戏模式。

如果值是旧用的数字，会静默转换为对应游戏模式的英文名称。

survival (0) - 生存模式
creative (1) - 创造模式
adventure (2) - 冒险模式
spectator (3) - 旁观模式
generate-structures 布尔值 true 定义是否能生成结构（例如村庄）。
false - 新生成的区块中将不包含结构。
true - 新生成的区块中将包含结构。

注：即使设为false，地牢仍然会生成。
generator-settings 字符串 {} 本属性质用于自定义世界的生成。详见超平坦世界和自定义了解正确的设定及例子。
hardcore 布尔值 false 如果设为 true，服务器难度的设置会被忽略并且设为hard（困难），玩家在死后会自动切换至旁观模式。
hide-online-players 布尔值 false 如果设为 true，服务端在响应客户端状态请求时不会返回在线玩家列表。
initial-disabled-packs 字符串 空白 需要在创建世界过程中禁用的数据包名称，以逗号分隔。
initial-enabled-packs 字符串 vanilla 需要在创建世界过程中启用的数据包名称，以逗号分隔。特别地，功能数据包必须在此指定才能生效。
level-name 字符串 world “level-name”的值将作为世界名称及其文件夹名。你也可以把你已生成的世界存档复制过来，然后让这个值与那个文件夹的名字保持一致，服务器就可以载入该存档。
部分字符，例如 ' （单引号）可能需要在前面加反斜杠号 \ 才能被正常应用。
level-seed 字符串 空白 与单人游戏类似，为你的世界定义一个种子。
这里有一些例子：minecraft，404，1a2b3c。
level-type 字符串 minecraft:normal 使用世界预设ID，确定地图所生成的类型。

使用世界预设ID时，需要在其中的“:”前加“\”转义。原版世界预设ID可以省略其前面的“minecraft:”（即命名空间）。

minecraft:normal - 带有丘陵，河谷，海洋等的标准的世界。
minecraft:flat - 一个没有特性的平坦世界，可用generator-settings修改。
minecraft:large_biomes - 如同预设（default）世界，但所有生物群系都更大。
minecraft:amplified - 如同预设世界，但世界生成高度提高。
minecraft:single_biome_surface - 单一生物群系世界，可用generator-settings修改。
max-build-height 整数 256 玩家在游戏中能够建造的最大高度。可能会在该值较小时生成超过该值的地形。
max-chained-neighbor-updates 整数[需要更多信息] 1000000 限制连锁NC更新的数量，超过此数量的连锁NC更新会被跳过。若为负数则无限制。
max-players 整数（0-2147483647） 20 服务器同时能容纳的最大玩家数量。请注意，在线玩家越多，对服务器造成的负担也就越大。同样注意，服务器的OP具有在人满的情况下强行进入服务器的能力：找到在服务器根目录下叫ops.json的文件并打开，将需要此能力的OP下的bypassesPlayerLimit选项设置为true即可（默认值为false），这意味着OP将不需要在服务器人满时等待有玩家离开后再加入。过大的数值会使客户端显示的玩家列表崩坏。
max-tick-time 整数（0–(2^63 - 1)） 60000 设置每个tick花费的最大毫秒数。超过该毫秒数时，服务器watchdog插件将停止服务器程序并附带上信息：服务器的一个tick花费了60.00秒（最长也应该只有0.05秒）；判定服务器已崩溃，它将被强制关闭。遇到这种情况的时候，它会调用 System.exit(1)。

译者注：如果你监测服务程序的返回代码，此时返回代码会为1。（习惯上，程序正常退出应当返回0）

-1 - 完全停用watchdog插件（这个停用选项在14w32a快照中添加）
max-world-size 整数（1-29999984） 29999984 设置可让世界边界获得的最大半径值，单位为方块。通过成功执行的命令能把世界边界设置得更大，但不会超过这里设置的最大方块限制。如果设置的max-world-size超过默认值的大小，那将不会起任何效果。

例如：

  • 设置 max-world-size为1000将会有2000×2000的地图边界。
  • 设置 max-world-size为4000将会有8000×8000的地图边界。
motd 字符串 A Minecraft Server 本属性值是玩家客户端的多人游戏服务器列表中显示的服务器信息，显示于名称下方。