server.properties

  “whitelist”重定向至此。关于相应的命令，详见“命令/whitelist”。

Java 版默认的 server.properties 文件。

server.properties是储存多人联机 (Minecraft 或 Minecraft Classic) 服务器所有设置的文件。

在编辑 server.properties 时，就算不同行之间的顺序可以打乱，确保其与原始的文件有相同的结构也很重要。每一行的等号之前的文本为变量名，您不应该修改这些内容。等号后面为变量的值，您可以按照规则自行编辑。以 # 开头的行为注释，添加、修改或移除注释行不会对游戏造成影响。

保存了 server.properties 的更改之后，服务端必须重新启动才能使更改生效。

如果 server.properties 文件未列出下文中所有的属性（例如服务端版本更新加入新属性，或该文件还未创建），那么服务器在启动时会重写 server.properties 补全缺失的属性，并将缺失的属性值设为默认值。

文件位置

Java版

该文件会在服务端第一次运行时自动生成（如果本来没有的话）。

操作系统	文件位置	注解
Windows	server.jar 的相同目录下
Linux Unix Unix/Mac	工作目录路径（pwd）	如果你在你的 home 目录下启动(/home/用户名)，服务端文件也会在 /home/用户名 下创建。请按照下列步骤确保服务端文件能够如你预期地正确生成。 准备一个完整的文件夹来存放所有服务端文件。（如果你不这么做的话事情会一团糟） 把 server.jar 放置（复制、移动）进去。 使用这个脚本指导设置你的 Minecraft 服务端启动脚本。 确保它位于你的可执行目录 $PATH 确保你具有启动脚本的执行权限（chmod +x 文件名，或使用文件夹管理器） minecraft_server.sh

基岩版

本文件会与 bedrock_server.exe 一同下载。

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

server.properties

新安装的 Minecraft 服务器具有以下默认设置：

Java版

#Minecraft server properties
#(文件修改时间戳)
broadcast-rcon-to-ops=true
view-distance=10
max-build-height=256
server-ip=
level-seed=
rcon.port=25575
gamemode=survival
server-port=25565
allow-nether=true
enable-command-block=false
enable-rcon=false
enable-query=false
op-permission-level=4
prevent-proxy-connections=false
generator-settings=
resource-pack=
level-name=world
rcon.password=
player-idle-timeout=0
motd=A Minecraft Server
query.port=25565
force-gamemode=false
hardcore=false
white-list=false
broadcast-console-to-ops=true
pvp=true
spawn-npcs=true
generate-structures=true
spawn-animals=true
snooper-enabled=true
difficulty=easy
function-permission-level=2
network-compression-threshold=256
level-type=default
spawn-monsters=true
max-tick-time=60000
enforce-whitelist=false
use-native-transport=true
max-players=20
resource-pack-sha1=
spawn-protection=16
online-mode=true
allow-flight=false
max-world-size=29999984

基岩版

server-name=Dedicated Server
gamemode=survival
difficulty=easy
allow-cheats=false
max-players=10
online-mode=true
white-list=false
server-port=19132
server-portv6=19133
view-distance=32
tick-distance=4
player-idle-timeout=30
max-threads=8
level-name=Bedrock level
level-seed=
default-player-permission-level=member
texturepack-required=false

Minecraft 服务器属性

Java版

属性	类型	默认值	描述
allow-flight	布尔值	false	允许玩家在安装添加飞行功能的 mod 前提下在生存模式下飞行。 允许飞行可能会使恶意破坏者更加常见，因为此设定会使他们更容易达成目的。在创造模式下无作用。 false - 不允许飞行。悬空超过5秒的玩家会被踢出服务器。 true - 允许飞行。玩家得以使用飞行 mod 飞行。
allow-nether	布尔值	true	允许玩家进入下界。 false - 下界传送门不会生效。 true - 玩家可以通过下界传送门前往下界。
difficulty	字符串	easy	定义服务器的游戏难度（例如生物对玩家造成的伤害，饥饿和中毒对玩家的影响方式等）。 如果设置了旧的数字ID，则会自动转化为英文的难度名称。 peaceful (0) - 和平 easy (1) - 简单 normal (2) - 普通 hard (3) - 困难
enable-command-block	布尔值	false	是否启用命令方块
enable-query	布尔值	false	允许使用 GameSpy4 协议的服务器监听器。用于获取服务器信息。
enable-rcon	布尔值	false	是否允许远程访问服务器控制台。
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（困难），玩家在死后会自动切换至旁观模式。
level-name	字符串	world	“level-name”的值将作为世界名称及其文件夹名。你也可以把你已生成的世界存档复制过来，然后让这个值与那个文件夹的名字保持一致，服务器就可以载入该存档。 部分字符，例如 ' （单引号）可能需要在前面加反斜杠号 \ 才能被正常应用。
level-seed	字符串	空白	与单人游戏类似，为你的世界定义一个种子。 这里有一些例子：minecraft，404，1a2b3c。
level-type	字符串	default	确定地图所生成的类型 default - 带有丘陵，河谷，海洋等的标准的世界。 flat - 一个没有特性的平坦世界，可用 generator-settings 修改。 largebiomes - 如同预设（default）世界，但所有生物群系都更大。 amplified - 如同预设世界，但世界生成高度提高。 buffet - 如同预设世界，但 generator-settings 设置后不同。
max-build-height	整数	256	玩家在游戏中能够建造的最大高度。可能会在该值较小时生成超过该值的地形。
max-players	整数（0-2147483647）	20	服务器同时能容纳的最大玩家数量。请注意，在线玩家越多，对服务器造成的负担也就越大。同样注意，服务器的OP具有在人满的情况下强行进入服务器的能力：找到在服务器根目录下叫 ops.json 的文件并打开，将需要此能力的OP下的 bypassesPlayerLimit 选项设置为 true 即可（默认值为 false），这意味着OP将不需要在服务器人满时等待有玩家离开后再加入。过大的数值会使客户端显示的玩家列表崩坏。
max-tick-time	整数（0–(2^63 - 1)）	60000	设置每个 tick 花费的最大毫秒数。超过该毫秒数时，服务器看门狗将停止服务器程序并附带上信息：服务器的一个 tick 花费了60.00秒（最长也应该只有0.05秒）；判定服务器已崩溃，它将被强制关闭。遇到这种情况的时候，它会调用 System.exit(1)。 译者注：如果你监测服务程序的返回代码，此时返回代码会为1。（习惯上，程序正常退出应当返回0） -1 - 完全停用看门狗（这个停用选项在 14w32a 快照中添加）
max-world-size	整数（1-29999984）	29999984	设置可让世界边界获得的最大半径值，单位为方块。通过成功执行的命令能把世界边界设置得更大，但不会超过这里设置的最大方块限制。如果设置的 max-world-size 超过默认值的大小，那将不会起任何效果。 例如： 设置 max-world-size 为 1000 将会有 2000x2000 的地图边界。 设置 max-world-size 为 4000 将会有 8000x8000 的地图边界。
motd	字符串	A Minecraft Server	本属性值是玩家客户端的多人游戏服务器列表中显示的服务器信息，显示于名称下方。 MOTD 支持样式代码。 MOTD 支持特殊符号，比如 "♥"。然而，这些符号需要转换为 Unicode 转义字符。你可以在这里找到一个转换器。 如果 MOTD 超过59个字符，服务器列表很可能会返回“通讯错误”。
network-compression-threshold	整数	256	默认会允许 n-1 字节的数据包正常发送, 如果数据包为 n 字节或更大时会进行压缩。所以，更低的数值会使得更多的数据包被压缩，但是如果被压缩的数据包字节太小将反而使压缩后字节更大。 -1 - 完全禁用数据包压缩 0 - 压缩全部数据包 注: 以太网规范要求把小于64字节的数据包填充为64字节。因此，设置一个低于64的值可能没有什么好处。也不推荐让设置的值超过MTU（通常为1500字节）。
online-mode	布尔值	true	是否让服务器对比 Minecraft 账户数据库验证登录信息。只有在你的服务器并未与 Internet 连接时，才将这个值设为 false。如果设为 false，黑客就能够使用任意假账户连接服务器！如果 minecraft.net 服务器宕机或不可访问，那么该值设为 true 的服务器会因为无法验证玩家身份而拒绝所有玩家加入。通常，这个值设为 true 的服务器被称为“正版服务器”。故意设定该变量为 false 的服务器称为“破解服务器”，这类服务器允许拥有未授权的 Minecraft 副本的玩家加入。 true - 启用。服务器会认为自己具有 Internet 连接，并检查每一位连入的玩家。 false - 禁用。服务器不会尝试检查玩家。
op-permission-level	整数（1-4）	4	设定使用/op命令时OP的权限等级。所有存档会从之前的存档继承能力和命令。 1 - OP可以绕过重生点保护。 2 - OP可以使用所有单人游戏作弊命令（除了 /publish，因为不能在服务器上使用；/debug 也是）并使用命令方块。命令方块和领域服服主/管理员有此等级权限。 3 - OP可以使用大多数多人游戏中独有的命令，包括 /debug，以及管理玩家的命令（/ban, /op 等等）。 4 - OP可以使用所有命令，包括 /stop, /save-all, /save-on 和 /save-off。
player-idle-timeout	整数	0	如果不为0，服务器将在玩家的空闲时间达到设置的时间（单位为分钟）时将玩家踢出服务器 注： 当服务器接受到下列数据包之一时将会重置空闲时间： 点击窗口 附魔物品 更新告示牌 玩家挖掘方块 玩家放置方块 更换拿着的物品 动画 (挥动手臂) 实体动作 客户端状态 聊天信息 使用实体
prevent-proxy-connections	布尔值	false	如果服务器发送的 ISP/AS 和 Mojang 的验证服务器的不一样，玩家将会被踢出。 true - 启用。服务器将会禁止玩家使用虚拟专用网络或代理。 false - 禁用。服务器将不会禁止玩家使用虚拟专用网络或代理。
pvp	布尔值	true	是否允许 PvP。也只有在允许 PvP 时玩家自己的箭才会受到伤害。 true - 玩家可以互相残杀。 false - 玩家无法互相造成伤害（也称作玩家对战环境 (PvE)）。 注： 由玩家造成的间接伤害（例如熔岩，火，TNT等，某种程度上还有水，沙子和沙砾）还是会伤害其他玩家。
query.port	整数（1-65534）	25565	设置监听服务器的端口号（参见 enable-query）。
rcon.password	字符串	空白	设置 RCON 远程访问的密码（参见enable-rcon）。RCON：能允许其他应用程序通过互联网与 Minecraft 服务器连接并交互的远程控制台协议。
rcon.port	整数（1-65534)	25575	设置 RCON 远程访问的端口号。
resource-pack	字符串	空白	可选选项，可输入指向一个资源包的 URI。玩家可选择是否使用该资源包。 注意若该值含 ":" 和 "=" 字符，需要在其前加上反斜线(\)，例如 http\://somedomain.com/somepack.zip?someparam\=somevalue 资源包大小理应不能超过 50 MiB (≈ 50.4 MB)。注意，下载成功或失败由客户端记录，而非服务器。
resource-pack-sha1	字符串	空白	资源包的 SHA-1 值，必须为小写十六进制，建议填写它。这还没有用于验证资源包的完整性，但是它提高了资源包缓存的有效性和可靠性。
server-ip	字符串	空白	将服务器与一个特定IP绑定。强烈建议留空该属性值！ 留空，或是填入你想让服务器绑定（监听）的IP。
server-port	整数（1-65534）	25565	改变服务器（监听的）端口号。如果服务器在使用NAT的网络中运行，该端口必须被转发（在你有家用路由器/防火墙的前提下）。
snooper-enabled	布尔值	true	是否允许服务端定期发送统计数据到 http://snoop.minecraft.net。 false - 禁用数据采集 true - 启用数据采集
spawn-animals	布尔值	true	决定动物是否可以生成。 true - 动物可以正常生成。 false - 动物生成后会立即消失。 提示：如果你有严重的卡顿，可以设为 false。
spawn-monsters	布尔值	true	决定攻击型生物（怪物）是否可以生成。 true - 启用。怪物会生成于夜晚和黑暗处。 false - 禁用。不会有任何怪物。 如果 difficulty = 0 (peaceful)（即难度设置为和平）的话，该属性值不会有任何影响。 提示：如果你有严重的卡顿，可以设为 false。
spawn-npcs	布尔值	true	决定是否生成村民。 true - 启用。生成村民。 false - 禁用。不会有村民。
spawn-protection	整数	16	通过将该值进行 2x+1 的运算来决定出生点的保护半径。设置为0将不会禁用出生点保护，但会保护位于出生点的那一个方块。设置为1会保护以出生点为中心的3x3方块的区域，2会保护5x5方块的区域，3会保护7x7方块的区域，以此类推。这个选项不在第一次服务器启动时生成，只会在第一个玩家加入服务器时出现。如果服务器没有设置OP，这个选项会自动禁用。
use-native-transport	布尔值	true	是否使用针对 Linux 平台的数据包收发优化。此选项仅会在 Linux 平台上生成。 true - 启用。启用 Linux 数据包收发优化。 false - 禁用。禁用 Linux 数据包收发优化。
view-distance	整数（3-32）	10	设置服务端发送给客户端的世界数据量，也就是设置玩家各个方向上的区块数量 (是以玩家为中心的半径，不是直径)。它决定了服务端的可视距离。(另见 渲染距离) 默认/推荐设置为10，如果有严重卡顿的话，减少该数值。 注: 该值小于 9 时会对服务器上的生物生成有显著影响，详见 bug MC-2536。
white-list	布尔值	false	启用服务器的白名单。 当启用时，只有白名单上的用户才能连接服务器。白名单主要用于私人服务器，例如提供给相识的朋友、通过应用流程谨慎选择的陌生人等。 false - 不使用白名单。 true - 从 whitelist.json 文件加载白名单。 注: - OP会自动被视为在白名单上，所以无需再将OP加入白名单。
enforce-whitelist	布尔值	false	在服务器上强制执行白名单。 当启用后，不在白名单（前提是启用）中的用户将在服务器重新加载白名单文件后从服务器踢出。 true - 不在白名单上的用户不会被踢出。 false - 不在白名单上的在线用户会被踢出。

在Java版1.12之前的版本中，announce-player-achievements 布尔值（默认为 true）属性用于切换是否成就要广播给所有玩家。该属性已被移除，但如果已经设置了这条属性，则游戏规则 announceAdvancements将自动更新，随后从文件中删除这条属性。

基岩版

属性名称	可选值	默认值	何时生效	作用	备注
gamemode	survival (0), creative (1), adventure (2)	survival	总是生效或新玩家进入时	设定新玩家的游戏模式。	survival (0) - 生存模式 creative (1) - 创造模式 adventure (2) - 冒险模式
difficulty	peaceful (0), easy (1), normal (2), hard (3)	easy	总是生效	设置世界的游戏难度。	peaceful (0) - 和平 easy (1) - 简单 normal (2) - 普通 hard (3) - 困难
level-type	FLAT, LEGACY, DEFAULT	DEFAULT	生成地形时	决定生成的地图的类型。	FLAT-超平坦 LEGACY-旧世界类型 DEFAULT-默认
server-name	任意字符串	Dedicated Server	总是生效	用作服务器的名称	作为服务器在游戏内服务器列表中显示的名称。
max-players	正整数	10	总是生效	设置服务器同时能容纳的最大玩家数量。	这是应该能在服务器上游戏的玩家的最大数量。较高的值可能会影响服务器性能。
server-port	任意整数	19132	总是生效	设置服务器监听的 IPv4 端口号。
server-portv6	任意整数	19133	总是生效	设置服务器监听的 IPv6 端口号。
level-name	任意字符串	level	总是生效	该值用于世界的名称以及文件夹名。你也可以复制你的存档到这里，并把该值修改成文件夹的名称，以此替换服务器加载的存档。	使用/生成的存档名称。每个存档在/worlds中都有单独的文件夹。
level-seed	任意字符串	空白(th34f1ju34facjn5f871df312h)	生成地形时	用于将世界随机化	为世界定义一个种子。留空将随机选择种子。
online-mode	true, false	true	总是生效	是否身份验证	如果为 true，则每个连接的玩家都必须与 Xbox Live 进行身份验证。
white-list	true, false	false	总是生效	是否开启白名单	如果为 true，则玩家都必须要在 whitelist.json 文件中才能登录服务器。
allow-cheats	true, false	false	总是生效	是否允许作弊	如果为 true，则服务器将允许作弊行为（例如使用命令）。
view-distance	任意整数	10	总是生效	设置玩家可视距离最大值	单位为区块。较高的值可能会影响服务器性能。
player-idle-timeout	任意整数	30	总是生效	设置空闲玩家被踢出的时间	单位为分钟。玩家空闲时间到达设定值后将被踢出。
max-threads	整数	8	总是生效	设置服务器尝试使用的最大线程数	如果设置为0或被移除，服务器会尽可能多地使用线程。
tick-distance	范围[4, 12]内的整数	4	总是生效	设置停止加载区块的距离	当玩家远离某个区块的距离超过设定值后，该区块会停止加载。较高的值可能会影响服务器性能。
default-player-permission-level	visitor, member, operator	member	总是生效	设置新玩家加入时的权限	visitor-新玩家不可破坏方块 member-新玩家正常加入 operator-新玩家加入时即为OP
texturepack-required	true, false	false	总是生效	是否强制加载资源包	如果为 true，则当服务器有资源包时，将强制客户端使用。

Minecraft Classic 服务器属性

属性	类型	默认值	描述
verify-names	布尔值	true	验证玩家的IP是否与其连接 Minecraft.net 的IP相同。如果启用，在一台电脑上同时运行服务端和客户端的人会出现问题，服务器看见的是本地IP（127.0.0.1），而 Minecraft.net 看到的是外部IP。除非上述情况发生，建议启用该属性。 true - 启用。服务器会和 Minecraft.net 检查所有的名字。 false - 禁用。服务区会确保IP吻合。
admin-slot	布尔值	false	允许OP在服务器人满时也能加入游戏。
public	布尔值		服务器是否显示在服务器列表里。 true - 服务器会显示在服务器列表里，任何人都能看到。 false - 只有掌握服务器 URL（可以在 externalurl.txt 中找到）的人和掌握IP和端口的人才能加入。
server-name	字符串		服务器名称，会显示在服务器名单上及有人正加入服务器时。 单行文本。部分字符，例如 '（单引号）可能需要在前面加反斜杠号\才能正确应用。
max-players	整数（0-256）		服务器同时在线的最大玩家人数。注意，服务器上玩家越多，服务器使用的资源越多。同样注意，服务器管理员的连接不算在内。
max-connections	整数（1-3）		同一个IP允许的最大连接数。 注: 如果你尝试设定的值大于3，它会被改回3。
motd	字符串		MOTD 是 Message of the day（每日一句）的简写，尽管你不用每天更改。MOTD 是玩家加入服务器时显示的信息。
grow-trees	布尔值		是否允许树苗长成为树木。 true - 服务器会允许树苗长成为树木。 false - 服务器不会允许树苗长成为树木。

历史

Java版
1.14.4		pre4			添加 function-permission-level 选项，可以控制函数的权限等级