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=ServerMBean和两个属性averageTickTimetickTimes用于暴露以毫秒为单位的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 - 如同默认的世界,但所有生物群系都更大。

minecraft:amplified - 如同默认的世界,但世界生成高度提高。

minecraft:single_biome_surface - 单一生物群系世界,可用generator-settings修改。

log-ips

布尔值

true

是否在有新玩家加入游戏时,在服务器日志中记录其IP地址。

true - 在日志中记录新加入玩家的IP地址。

false - 在日志中隐藏新加入玩家的IP地址。

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

本属性值是玩家客户端的多人游戏服务器列表中显示的服务器信息,显示于名称下方。

  • 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)。

rate-limit

整数

0

设置玩家被踢出服务器前,可以发送的数据包数量。

设置为0表示关闭此功能。

rcon.password

字符串

空白

设置RCON远程访问的密码(参见enable-rcon)。RCON:能允许其他应用程序通过互联网与Minecraft服务器连接并交互的远程控制台协议。

rcon.port

整数(1-65534)

25575

设置RCON远程访问的端口号。

require-resource-pack

布尔值

false

当此选项启用(设为true)时,玩家会被提示作出选择(是否启用服务器资源包)。如果玩家拒绝则会被服务器断开连接。

  • 但是,若玩家使用Linux系统加入服务器,游戏目录内的server-resource-packs没有写权限,则会提示“无法应用服务器资源包”“所有依赖自定义资源包的功能都有可能不按预期工作”,并提示玩家“继续”或“断开连接”。若玩家选择“继续”,则仍可在此服务器中游戏。

resource-pack

字符串

空白

可选选项,可输入指向一个资源包的URI。玩家可选择是否使用该资源包。

注意若该值含":"和"="字符,需要在其前加上反斜线(\),例如 http\://somedomain.com/somepack.zip?someparam\=somevalue 资源包大小理应不能超过

  • 50 MiB(1.15-pre5前)

  • 100 MiB(1.15-pre5到1.18-pre8)

  • 250 MiB(1.18-rc1起)

注意,下载成功或失败由客户端记录,而非服务器。

resource-pack-prompt

字符串

空白

可选,用于在使用require-resource-pack时在资源包提示界面显示自定义信息。

与聊天组件语法一致,可以包含多行文本。

resource-pack-sha1

字符串

空白

资源包的SHA-1值,必须为小写十六进制,建议填写它。这还没有用于验证资源包的完整性,但是它提高了资源包缓存的有效性和可靠性。

server-ip

字符串

空白

将服务器与一个特定IP绑定。强烈建议留空该属性值!

留空,或是填入你想让服务器绑定(监听)的IP。

server-port

整数(1-65534)

25565

改变服务器(监听的)端口号。如果服务器在使用NAT的网络中运行,该端口必须被转发(在你有家用路由器/防火墙的前提下)。

simulation-distance

整数(3-32)

10

设置服务端可更新实体范围的最大值,即玩家各个方向上的区块数量(是以玩家为中心的半径,不是直径)。超出此范围的实体不会被更新,对玩家也不可见。

默认/推荐设置为10,如果有严重卡顿的话,减少该数值。

spawn-animals

布尔值

true

决定动物是否可以生成。

true - 动物可以正常生成。

false - 动物生成后会立即消失。

提示:如果你有严重的卡顿,可以设为false。

spawn-monsters

布尔值

true

决定攻击型生物(怪物)是否可以生成。

true - 启用。怪物会生成于夜晚和黑暗处。

false - 禁用。不会有任何怪物。

如果difficulty=0(即难度设置为和平)的话,该属性值不会有任何影响。

提示:如果你有严重的卡顿,可以设为false。

spawn-npcs

布尔值

true

决定是否生成村民

true - 启用。生成村民。

false - 禁用。不生成村民。

spawn-protection

整数

16

通过将该值进行2x+1的运算来决定出生点的保护半径。设置为1会保护以出生点为中心的3×3方块的区域,2会保护5×5方块的区域,3会保护7×7方块的区域,以此类推。这个选项不在第一次服务器启动时生成,只会在第一个玩家加入服务器时出现。如果服务器没有设置OP,这个选项会自动禁用。设置为0将不会禁用出生点保护,但会保护位于出生点的那一个方块(13w05a前)。

设置为0会禁用出生点保护(13w05a起,参见MC-666)。

sync-chunk-writes

布尔值

true

启用后区块文件以同步模式写入。

text-filtering-config

字符串[需要测试]

空白

服务器中需要被屏蔽的文本。[需要测试]

use-native-transport

布尔值

true

是否使用针对Linux平台的数据包收发优化。此选项仅会在Linux平台上生成。

true - 启用。启用Linux数据包收发优化。

false - 禁用。禁用Linux数据包收发优化。

view-distance

整数(3-32)

10

设置服务端发送给客户端的世界数据量,也就是设置玩家各个方向上的区块数量(是以玩家为中心的半径,不是直径)。它决定了服务端的可视距离。(另见渲染距离

默认/推荐设置为10,如果有严重卡顿的话,减少该数值。

white-list

布尔值

false

启用服务器的白名单。

当启用时,只有白名单上的用户才能连接服务器。白名单主要用于私人服务器,例如提供给相识的朋友、通过应用流程谨慎选择的陌生人等。

false - 不使用白名单。

true - 从whitelist.json文件加载白名单。

注: OP会自动被视为在白名单上,所以无需再将OP加入白名单。

基岩版

属性名称

可选值

默认值

何时生效

作用

备注

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进行身份验证。

allow-list

true, false

false

总是生效

是否开启白名单

如果为true,则玩家都必须要在allowlist.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。除非上述情况发生,建议启用该属性。

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 - 服务器不会允许树苗长成为树木。