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 目录下启动(
|
基岩版[编辑 | 编辑源代码]
本文件会与bedrock_server.exe
一同下载。
操作系统 | 文件位置 |
---|---|
Windows | bedrock_server.exe 的相同目录下
|
Linux | bedrock_server 的相同目录下
|
server.properties[编辑 | 编辑源代码]
新安装的Minecraft服务器具有以下默认设置:
Java版[编辑 | 编辑源代码]
以下内容来自21w07a
#Minecraft server properties
#(文件修改时间戳)
spawn-protection=16
max-tick-time=60000
query.port=25565
generator-settings=
sync-chunk-writes=true
force-gamemode=false
allow-nether=true
enforce-whitelist=false
gamemode=survival
broadcast-console-to-ops=true
enable-query=false
player-idle-timeout=0
text-filtering-config=
difficulty=easy
broadcast-rcon-to-ops=true
spawn-monsters=true
op-permission-level=4
pvp=true
entity-broadcast-range-percentage=100
snooper-enabled=true
level-type=default
enable-status=true
hardcore=false
enable-command-block=false
network-compression-threshold=256
max-players=20
max-world-size=29999984
resource-pack-sha1=
function-permission-level=2
rcon.port=25575
server-port=25565
server-ip=
spawn-npcs=true
require-resource-pack=false
allow-flight=false
level-name=world
view-distance=10
resource-pack=
spawn-animals=true
white-list=false
rcon.password=
generate-structures=true
online-mode=true
level-seed=
prevent-proxy-connections=false
use-native-transport=true
enable-jmx-monitoring=false
motd=A Minecraft Server
rate-limit=0
enable-rcon=false
基岩版[编辑 | 编辑源代码]
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
content-log-file-enabled=false
compression-threshold=1
server-authoritative-movement=true
player-movement-score-threshold=20
player-movement-distance-threshold=0.3
player-movement-duration-threshold-in-ms=500
correct-player-movement=false
Minecraft服务器属性[编辑 | 编辑源代码]
Java版[编辑 | 编辑源代码]
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
allow-flight | 布尔值 | false | 允许玩家在安装添加飞行功能的mod前提下在生存模式下飞行。
允许飞行可能会使恶意破坏者更加常见,因为此设定会使他们更容易达成目的。在创造模式下无作用。
|
allow-nether | 布尔值 | true | 允许玩家进入下界。 |
broadcast-console-to-ops | 布尔值 | true | 向所有在线OP发送所执行命令的输出。 |
broadcast-rcon-to-ops | 布尔值 | true | 向所有在线OP发送通过RCON执行的命令的输出。 |
difficulty | 字符串 | easy | 定义服务器的游戏难度(例如生物对玩家造成的伤害,饥饿和中毒对玩家的影响方式等)。
如果设置了旧的数字ID,则会自动转化为英文的难度名称。
|
enable-command-block | 布尔值 | false | 是否启用命令方块。 |
enable-jmx-monitoring | 布尔值 | false | 暴露一个具有对象名net.minecraft.server:type=Server 的MBean 和两个属性averageTickTime 和tickTimes 用于暴露以毫秒为单位的tick时间。
|
enable-query | 布尔值 | false | 允许使用GameSpy4协议的服务器监听器。用于获取服务器信息。 |
enable-rcon | 布尔值 | false | 是否允许远程访问服务器控制台。
|
enable-status | 布尔值 | true | 使服务器在服务器列表中看起来是“在线”的。 |
enforce-whitelist | 布尔值 | false | 在服务器上强制执行白名单。
当启用后,不在白名单(前提是启用)中的用户将在服务器重新加载白名单文件后从服务器踢出。
|
entity-broadcast-range-percentage | 整数(10-1000) | 100 | 此选项控制实体需要距离玩家有多近才会将数据包发送给客户端。更高的数值意味着实体可以在更远的地方就被渲染,同时也可能提高增加延迟的几率。
|
force-gamemode | 布尔值 | false | 强制玩家加入时为默认游戏模式。
|
function-permission-level | 整数(1-4) | 2 | 设定函数的默认权限等级。
4个等级的详情见 #op-permission-level。 |
gamemode | 字符串 | survival | 定义默认游戏模式。
如果值是旧用的数字,会静默转换为对应游戏模式的英文名称。
|
generate-structures | 布尔值 | true | 定义是否能生成结构(例如村庄)。
注:即使设为false,地牢仍然会生成。 |
generator-settings | 字符串 | 空白 | 本属性质用于自定义世界的生成。详见超平坦世界和自定义了解正确的设定及例子。 |
hardcore | 布尔值 | false | 如果设为 true,服务器难度的设置会被忽略并且设为 hard(困难),玩家在死后会自动切换至旁观模式。 |
level-name | 字符串 | world | “level-name”的值将作为世界名称及其文件夹名。你也可以把你已生成的世界存档复制过来,然后让这个值与那个文件夹的名字保持一致,服务器就可以载入该存档。
|
level-seed | 字符串 | 空白 | 与单人游戏类似,为你的世界定义一个种子。
|
level-type | 字符串 | default | 确定地图所生成的类型
|
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)
|
max-world-size |
整数(1-29999984) | 29999984 | 设置可让世界边界获得的最大半径值,单位为方块。通过成功执行的命令能把世界边界设置得更大,但不会超过这里设置的最大方块限制。如果设置的 max-world-size 超过默认值的大小,那将不会起任何效果。
例如:
|
motd | 字符串 | A Minecraft Server | 本属性值是玩家客户端的多人游戏服务器列表中显示的服务器信息,显示于名称下方。 |
network-compression-threshold |
整数 | 256 | 默认会允许n-1字节的数据包正常发送, 如果数据包为n字节或更大时会进行压缩。所以,更低的数值会使得更多的数据包被压缩,但是如果被压缩的数据包字节太小将反而使压缩后字节更大。
注:以太网规范要求把小于64字节的数据包填充为64字节。因此,设置一个低于64的值可能没有什么好处。也不推荐让设置的值超过MTU(通常为1500字节)。 |
online-mode | 布尔值 | true | 是否让服务器对比Minecraft账户数据库验证登录信息。只有在你的服务器并未与 Internet 连接时,才将这个值设为false。如果设为false,黑客就能够使用任意假账户连接服务器!如果minecraft.net服务器宕机或不可访问,那么该值设为true的服务器会因为无法验证玩家身份而拒绝所有玩家加入。通常,这个值设为true的服务器被称为“正版服务器”。故意设定该变量为false的服务器称为“破解服务器”,这类服务器允许拥有未授权的Minecraft副本的玩家加入。
|
op-permission-level | 整数(1-4) | 4 | 设定使用/op 命令时OP的权限等级。所有存档会从之前的存档继承能力和命令。
|
player-idle-timeout | 整数 | 0 | 如果不为0,服务器将在玩家的空闲时间达到设置的时间(单位为分钟)时将玩家踢出服务器 |
prevent-proxy-connections | 布尔值 | false | 如果服务器发送的ISP/AS和Mojang的验证服务器的不一样,玩家将会被踢出。
|
pvp | 布尔值 | true | 是否允许PvP。也只有在允许PvP时玩家自己的箭才会受到伤害。
|
query.port | 整数(1-65534) | 25565 | 设置监听服务器的端口号(参见 enable-query)。 |
rate-limit | 整数 | 0 | 设置玩家被踢出服务器前,可以发送的数据包数量。
|
rcon.password | 字符串 | 空白 | 设置RCON远程访问的密码(参见enable-rcon)。RCON:能允许其他应用程序通过互联网与Minecraft服务器连接并交互的远程控制台协议。 |
rcon.port | 整数(1-65534) | 25575 | 设置RCON远程访问的端口号。 |
require-resource-pack[新增:JE 1.17] | 布尔值 | false | 当此选项启用(设为true)时,玩家会被提示作出选择(是否启用服务器资源包)。如果玩家拒绝则会被服务器断开连接。 |
resource-pack | 字符串 | 空白 | 可选选项,可输入指向一个资源包的URI。玩家可选择是否使用该资源包。
注意若该值含":"和"="字符,需要在其前加上反斜线(\),例如 http\://somedomain.com/somepack.zip?someparam\=somevalue 资源包大小理应不能超过
注意,下载成功或失败由客户端记录,而非服务器。 |
resource-pack-sha1 | 字符串 | 空白 | 资源包的SHA-1值,必须为小写十六进制,建议填写它。这还没有用于验证资源包的完整性,但是它提高了资源包缓存的有效性和可靠性。 |
server-ip | 字符串 | 空白 | 将服务器与一个特定IP绑定。强烈建议留空该属性值!
|
server-port | 整数(1-65534) | 25565 | 改变服务器(监听的)端口号。如果服务器在使用NAT的网络中运行,该端口必须被转发(在你有家用路由器/防火墙的前提下)。 |
snooper-enabled | 布尔值 | true | 是否允许服务端定期发送统计数据到http://snoop.minecraft.net。
|
spawn-animals | 布尔值 | true | 决定动物是否可以生成。
提示:如果你有严重的卡顿,可以设为false。 |
spawn-monsters | 布尔值 | true | 决定攻击型生物(怪物)是否可以生成。
如果difficulty=0(即难度设置为和平)的话,该属性值不会有任何影响。 提示:如果你有严重的卡顿,可以设为false。 |
spawn-npcs | 布尔值 | true | 决定是否生成村民。
|
spawn-protection | 整数 | 16 | 通过将该值进行2x+1的运算来决定出生点的保护半径。设置为1会保护以出生点为中心的3x3方块的区域,2会保护5x5方块的区域,3会保护7x7方块的区域,以此类推。这个选项不在第一次服务器启动时生成,只会在第一个玩家加入服务器时出现。如果服务器没有设置OP,这个选项会自动禁用。
|
sync-chunk-writes | 布尔值 | true | 启用后区块文件以同步模式写入。 |
text-filtering-config | [需要更多信息] | [需要更多信息] | [需要更多信息] |
use-native-transport | 布尔值 | true | 是否使用针对Linux平台的数据包收发优化。此选项仅会在Linux平台上生成。
|
view-distance | 整数(3-32) | 10 | 设置服务端发送给客户端的世界数据量,也就是设置玩家各个方向上的区块数量(是以玩家为中心的半径,不是直径)。它决定了服务端的可视距离。(另见渲染距离)
默认/推荐设置为10,如果有严重卡顿的话,减少该数值。 |
white-list | 布尔值 | false | 启用服务器的白名单。
当启用时,只有白名单上的用户才能连接服务器。白名单主要用于私人服务器,例如提供给相识的朋友、通过应用流程谨慎选择的陌生人等。
注: OP会自动被视为在白名单上,所以无需再将OP加入白名单。 |
在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 | 总是生效 | 设置空闲玩家被踢出的时间 | 单位为分钟。玩家空闲时间到达设定值后将被踢出,如果设置为0或被移除。 |
max-threads | 整数 | 8 | 总是生效 | 设置服务器尝试使用的最大线程数 | 服务器会尽可能多地使用线程。 |
tick-distance | 范围[4, 12]内的整数 | 4 | 总是生效 | 设置停止加载区块的距离 | 当玩家远离某个区块的距离超过设定值后,该区块会停止加载。较高的值可能会影响服务器性能。 |
default-player-permission-level | visitor, member, operator | member | 总是生效 | 设置新玩家加入时的权限 | visitor-新玩家不可破坏方块
member-新玩家正常加入 operator-新玩家加入时即为OP |
texturepack-required | true, false | false | 总是生效 | 是否强制加载资源包 | 如果为 true,则当服务器有资源包时,将强制客户端使用。 |
content-log-file-enabled | true,false | false | 是否启用错误日志 |
Minecraft Classic 服务器属性[编辑 | 编辑源代码]
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
verify-names | 布尔值 | true | 验证玩家的IP是否与其连接Minecraft.net的IP相同。如果启用,在一台电脑上同时运行服务端和客户端的人会出现问题,服务器看见的是本地IP(127.0.0.1),而Minecraft.net看到的是外部IP。除非上述情况发生,建议启用该属性。
|
admin-slot | 布尔值 | false | 允许OP在服务器人满时也能加入游戏。 |
public | 布尔值 | 服务器是否显示在服务器列表里。
| |
server-name | 字符串 | 服务器名称,会显示在服务器名单上及有人正加入服务器时。
| |
max-players | 整数(0-256) | 服务器同时在线的最大玩家人数。注意,服务器上玩家越多,服务器使用的资源越多。同样注意,服务器管理员的连接不算在内。 | |
max-connections | 整数(1-3) | 同一个IP允许的最大连接数。
注: 如果你尝试设定的值大于3,它会被改回3。 | |
motd | 字符串 | MOTD 是Message of the day(每日一句)的简写,尽管你不用每天更改。MOTD是玩家加入服务器时显示的信息。 | |
grow-trees | 布尔值 | 是否允许树苗长成为树木。
|
历史[编辑 | 编辑源代码]
原因:一些设置并没有首先介绍
Java版Classic | |||||
---|---|---|---|---|---|
服务器1.2 | 现今已存档的最早版本。 | ||||
可用的选项包括:port ,server-name ,max-players ,motd ,public 。 | |||||
服务器1.3 | 加入了 verify-names ,验证玩家的IP是否与其连接Minecraft.net的IP相同。 | ||||
服务器1.5 | 加入了 max-connections ,限制一个IP地址的最大连接数。 | ||||
服务器1.9.1 | 加入了 grow-tree , 除非将其设置为true,否则树苗将不会长成树木。 | ||||
服务器1.10 | 加入了verify-names 禁用时的警告。
| ||||
加入了admin-slot ,关闭它将使OP无法在服务器人满时加入游戏。 | |||||
Java版Alpha | |||||
服务器0.2.0 | 加入了monsters 选项,如果设置为true将生成怪物。 | ||||
服务器0.2.4 | 加入了no-animals 选项,如果设置为true则不会生成动物。 | ||||
服务器0.2.5 | 加入了pvp 选项,禁用或者启用玩家对战(PVP)。
| ||||
将monsters 重命名为spawn-monsters 并将默认设置为true。 | |||||
将no-animals 重命名为spawn-animals 。 | |||||
Java版Beta | |||||
1.6 | 加入了allow-nether ,如果设置为false则会禁止进入下界。
| ||||
加入了view-distance ,设置了大视距。 | |||||
Java版 | |||||
1.0.0 | Beta 1.9-pre4 | 加入了debug ,enable-query ,enable-rcon ,query.port ,rcon.password 和rcon.port 。 | |||
1.1 | 11w49a | 加入了spawn-npcs 。 | |||
12w01a | 加入了level-type 。 | ||||
正式版 | 加入了generate-structures 。 | ||||
1.2.1 | 12w07a | 加入了max-build-height 。 | |||
1.4.2 | 12w40a | 加入了spawn-protection 。 | |||
1.5 | 13w05a | 将spawn-protection 设置为0会把出生点保护关闭了,而不是像以前一样保护1×1的范围(MC-666)。 | |||
1.7.2 | 13w38a | 加入了announce-player-achievements 。 | |||
1.8 | 14w17a | 加入了generator-settings 。 | |||
14w28a | 加入了自定义网络压缩选项。 | ||||
1.11 | 16w38a | 加入了prevent-proxy-connections 。 | |||
1.12 | 17w18a | 游戏规则announceAdvancements 取代选项announce-player-achievements 。 | |||
1.14 | 18w48a | difficulty 和gamemode 设置使用字符串,整数仍旧可以使用。 | |||
1.14.4 | pre4 | 加入了function-permission-level 选项,可以控制函数的权限等级。 | |||
1.15 | pre5 | 将服务器资源包的大小上限提升到100MB。 | |||
1.16 | 20w14a | 加入了sync-chunk-writes 选项,是否禁用新的同步区块写入。 | |||
20w16a | 加入了enable-jmx-monitoring 选项,启用将使MBean使用以毫秒为单位时间计时。 | ||||
20w18a | 加入了enable-status 和entity-broadcast-range-percentage 选项。 | ||||
1.16.2 | 20w28a | 加入了rate-limit ,设置数据包的速度限制。 | |||
1.16.4 | pre1 | 加入了text-filtering-config 。 | |||
Java版(即将到来) | |||||
1.17 | 20w45a | 加入了require-resource-pack ,用于强制使用户接受服务器资源包。 | |||
基岩版 | |||||
1.6.1 | 基岩版专用服务器的首次发布。 | ||||
可用的选项包括:server-name ,gamemode ,difficulty ,allow-cheats ,max-players ,online-mode ,white-list ,server-port ,server-port-v6 ,view-distance ,tick-distance ,player-idle-timeout ,max-threads ,level-name ,level-seed ,default-player-permission ,texturepack-required 。 | |||||
1.7.0 | 将default-player-permission 重命名为default-player-permission-level 。 | ||||
1.12.0 | 加入了content-log-file-enabled ,用于启用错误日志。 | ||||
1.13.0 | 加入了compression-threshold ,server-authoritative-movement ,player-movement-score-threshold ,player-movement-distance-threshold ,player-movement-duration-threshold-in-ms ,correct-player-movement 。 | ||||
1.16.100 | server-authoritative-movement 的默认值从true 改为server-auth (原先的false 现在改为client-auth )。 |
版本 | |||||||
---|---|---|---|---|---|---|---|
开发周期 |
| ||||||
技术 |
| ||||||
多人游戏 |
| ||||||
游戏订制 |