Minecraft Wiki

除另有声明,转载时均必须注明出处若簡繁轉換出錯,請以遊戲內為準请勇于扩充与修正内容有兴趣逛逛我们的微博沟通交流,欢迎到社区专页需要协助,请在告示板留言

了解更多

Minecraft Wiki
Advertisement
Information icon
此特性为Java版基岩版独有。
Server

用Notepad++打开的server.properties文件

server.properties为Minecraft服务端用于配置多人游戏所有参数的文件。

如果您要编辑server.properties,尽管不同行之间的顺序可以打乱,但请确保您使用和原始的文件相同的结构。每一行的等号之前的文本为变量名,您不应该修改。等号后面为变量的值,您可以按照规则自行编辑。以 # 开头的一行为注释,添加、修改或移除注释行不会对服务端运行造成任何影响。

在编辑并保存server.properties的更改之后,服务端必须重新启动以使更改生效。

如果server.properties文件未列出下文中所有的属性(例如服务端版本更新加入新属性,或 server.properties 还未创建),那么请先运行一下服务端程序。程序会补全缺失的属性并将它们的值设为默认。

文件位置

Java版

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

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

Unix Unix/Mac

工作目录路径(pwd)

如果你在你的home目录下启动(/home/yourname),服务端文件也会在/home/yourname下创建。请按照下列步骤确保服务端文件能够如你希望地成功生成。

  • 准备一个完整的文件夹以存放所有服务端文件。(如果你不这么做的话事情会一团糟
    • 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
#(File Modification Datestamp)
generator-settings=
op-permission-level=4
allow-nether=true
enforce-whitelist=false
level-name=world
enable-query=false
allow-flight=false
prevent-proxy-connections=false
server-port=25565
max-world-size=29999984
level-type=DEFAULT
enable-rcon=false
level-seed=
force-gamemode=false
server-ip=
network-compression-threshold=256
max-build-height=256
spawn-npcs=true
white-list=false
spawn-animals=true
hardcore=false
snooper-enabled=true
resource-pack-sha1=
online-mode=true
resource-pack=
pvp=true
difficulty=1
enable-command-block=false
gamemode=0
player-idle-timeout=0
max-players=20
max-tick-time=60000
spawn-monsters=true
view-distance=10
generate-structures=true
motd=A Minecraft Server

基岩版

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=10
tick-distance=4
player-idle-timeout=30
max-threads=8 

Minecraft服务器设置

Java版

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

允许飞行可能会使恶意破坏者更加常见,因为此设定会使他们更容易达成目的。在创造模式下本属性不会有任何作用。

false - 不允许飞行。悬空超过5秒的玩家会被踢出服务器。
true - 允许飞行。玩家得以使用飞行MOD飞行。
allow-nether 布尔值 true 允许玩家进入下界
false - 下界传送门不会生效。
true - 玩家可以通过下界传送门前往下界
announce-player-achievements 布尔值 true 玩家获得成就时是否在服务器中进行显示。
false - 玩家获得成就时的提示仅自己可见,不会向其他玩家进行显示。
true - 玩家获得成就时将在其他在线玩家的聊天栏进行提示。
例如:jeb_ 刚刚获得了 [打开物品栏] 成就!
difficulty 整数(0-3) 1 定义服务器的游戏难度(例如生物对玩家造成的伤害,饥饿与中毒对玩家的影响方式等)。
0 - 和平
1 - 简单
2 - 普通
3 - 困难
enable-query 布尔值 false 允许使用GameSpy4协议的服务器监听器。它被用于收集服务器信息。
enable-rcon 布尔值 false 是否允许远程访问服务器控制台。
force-gamemode 布尔值 false 强制玩家加入时为默认游戏模式
false - 玩家将以退出前的游戏模式加入
true - 玩家总是以默认游戏模式加入
gamemode 整数(0-3) 0 定义默认游戏模式
0 - 生存模式
1 - 创造模式
2 - 冒险模式(仅在12w22a之后,或正式版1.3之后可用)
3 - 旁观模式(仅在14w05a之后,或正式版1.8之后可用)
generate-structures 布尔值 true 定义是否在生成世界时生成结构(例如村庄
false - 新生成的区块中将不包含结构。
true - 新生成的区块中将包含结构。

注: 即使设为 false,地牢和下界要塞仍然会生成

generator-settings 字符串 空白 本属性质用于自定义超平坦世界的生成。详见超平坦世界自定义了解正确的设定及例子。
hardcore 布尔值 false 一旦启用,玩家在死后会自动被服务器封禁(即开启极限模式)。
level-name 字符串 world “level-name”的值将作为世界名称及其文件夹名。你也可以把你已生成的世界存档复制过来,然后让这个值与那个文件夹的名字保持一致,服务器就可以载入该存档。
部分字符,例如 ' (单引号)可能需要在前面加反斜杠号 \ 才能被正常应用。
level-seed 字符串 空白 与单人游戏类似,为你的世界定义一个种子
这里有一些例子:minecraft,404,1a2b3c。
level-type 字符串 DEFAULT 确定地图所生成的类型
DEFAULT - 标准的世界带有丘陵,河谷,海洋等
FLAT - 一个没有特色的平坦世界,适合用于建设
LARGEBIOMES - 如同预设世界,但所有生态系都更大(仅快照12w19a,或正式版1.3之后可用)
AMPLIFIED - 如同预设世界,但世界生成高度提高(仅快照13w36a,或正式版1.7.2之后可用)
CUSTOMIZED - 自快照14w21b以來,服务器也支持自定义地形。使用方法是在generator-settings贴上代码。
max-build-height 整数 256 玩家在游戏中能够建造的最大高度。地形生成算法并不会受这个值的影响。
max-players 整数(1-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 ,然而这样的话破坏者也能够使用任意假账户登录服务器。如果 Minecraft.net 服务器下线,那么开启在线验证的服务器会因为无法验证玩家身份而拒绝所有玩家加入。通常,这个值设为 true 的服务器被称为“正版服务器”,设为 false 的被称为“离线服务器”或“盗版服务器”。
true - 启用。服务器会认为自己具有 Internet 连接,并检查每一位连入的玩家。
false - 禁用。服务器不会检查玩家。
op-permission-level 整数(1-4) 4 设定OP的权限等级
1 - OP可以无视重生点保护。
2 - OP可以使用单人游戏作弊命令(除了/publish,因为不能在服务器上使用,/debug也是)并使用命令方块。命令方块和领域服服主/管理员有此等级权限。
3 - OP可以使用几乎所有多人游戏限定的命令(除第4级专用命令)
4 - OP可以使用所有命令,包括/stop、/save-all、/save-on和/save-off。
player-idle-timeout 整数 0 如果不为0,服务器将在玩家的空闲时间达到设置的时间(单位为分钟)时将玩家踢出服务器
例如:把player-idle-timeout设置为3,玩家空闲时间达到3分钟就会被踢出服务器。
注: 当服务器接受到下列数据包之一时将会重置空闲时间:
prevent-proxy-connections 布尔值 false 如果服务器发送的和Mojang的验证服务器的ISP/AS不一样,玩家将会被踢出
true - 服务器将会禁止玩家使用VPN或代理
false - 服务器将不会禁止玩家使用VPN或代理
pvp 布尔值 true 是否允许PvP。玩家自己的箭也只有在允许PvP时才可能伤害到自己。
注: 来源于玩家的间接伤害,例如熔岩TNT等,还是会造成伤害。
true - 玩家可以互相残杀。
false - 玩家无法互相造成伤害。
query.port 整数(1-65534) 25565 设置监听服务器的端口号(详见enable-query)。
rcon.password 字符串 空白 设置远程访问的密码(详见enable-rcon)。
rcon.port 整数(1-65534) 25575 设置远程访问的端口号(详见enable-rcon)。
resource-pack 字符串 空白 可选选项,可输入指向一个资源包的URI。玩家可选择是否使用该资源包
resource-pack-sha1 字符串 空白 资源包的SHA-1值,必须为小写十六进制,建议填写它,这还没有用于验证资源包的完整性,但是它提高了资源包缓存的有效性和可靠性。
注:下载到的服务器资源包将保存在.minecraft\server-resource-packs下。
server-ip 字符串 空白 将服务器与一个特定IP绑定。强烈建议你留空本属性值!
留空,或是填入你想让服务器绑定的IP。
server-port 整数(1-65534) 25565 改变服务器端口号。如果服务器通过路由器与外界连接的话,该端口必须也能够通过路由器。
snooper-enabled 布尔值 true 自1.3正式版之后,一旦启用,将允许服务端定期发送统计数据到http://snoop.minecraft.net.
false - 禁用数据采集
true - 启用数据采集
spawn-animals 布尔值 true 决定动物是否可以生成。
true - 动物可以生成。
false - 动物生成后会立即消失。
spawn-monsters 布尔值 true 决定攻击型生物(怪兽)是否可以生成。
true - 可以。只要满足条件的话怪物就会生成。
false - 禁用。不会有任何怪物。

如果difficulty = 0(和平)的话,本属性值不会有任何影响。

spawn-npcs 布尔值 true 决定是否生成村民
true - 生成村民
false - 不会有村民。
spawn-protection 整数 16 通过将该值进行(x*2)+1的运算来决定出生点的保护半径。设置为0将不会禁用出生点保护。设置为0将会保护位于出生点的1x1方块区域,设置为1将会保护以出生点为中心的3x3方块区域。设置为2会保护5x5的方块区域,设置为3将会保护7x7的方块区域,以此类推。 这个选项只会在第一个玩家进行服务器时生成。如果服务器没有设置OP,这个选项将会自动禁用。
use-native-transport 布尔值 true 是否使用针对Linux平台的数据包收发优化,此选项仅会在Linux平台下生成。
true - 启用
false - 禁用
view-distance 整数(3-15) 10 设置服务端传送给客户端的数据量,也就是设置玩家各个方向上的区块数量 (是以玩家为中心的半径,不是直径)。 它决定了服务端的可视距离。(另见 渲染距离)

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

white-list 布尔值 false 服务器的白名单

当启用时,只有白名单上的用户才能连接服务器。白名单主要用于私人服务器,例如相识的朋友等。

- OP会自动被视为在白名单上。所以无需再将OP加入白名单。
false - 不使用白名单。
true - 从 whitelist.json 文件加载白名单。
enable-command-block 布尔值 false 是否启用命令方块
true - 启用
false - 禁用
enforce-whitelist 布尔值 false 在服务器上强制执行白名单。

当启用后,不在白名单中的用户将在服务器重新加载白名单文件后从服务器踢出。

true - 启用
false - 禁用

在1.12之后的版本中,announce-player-achievements属性被移除。如果已经在服务器配置文件中设置了此条属性,则游戏规则announceAdvancements将自动更新,随后从文件中删除此条属性。

基岩版

属性 可选值 默认值 何时生效 作用 备注
allow-cheats 布尔值 false 总是生效 是否允许作弊 如果为true,则服务器将允许作弊行为(例如使用命令方块)。
default-player-permission-level 字符串 member 总是生效 设置新玩家加入时的权限 visitor-新玩家不可破坏方块

member-新玩家正常加入

operator-新玩家加入时即为OP

difficulty 字符串或整数(0-3) easy 总是生效 设置服务器的游戏难度 peaceful (0)-和平

easy (1)-简单

normal (2)-普通

hard (3)-困难

gamemode 字符串或整数(0-2) survival 总是生效或新玩家进入时 设置新玩家的游戏模式 survival (0)-生存模式

creative (1)-创造模式

adventure (2)-冒险模式

level-name 字符串 level 总是生效 作为世界名称以及文件夹名称 可以将自己的存档文件夹复制到这里,并把文件夹名改为与之前的文件夹相同的名称,以便在服务器中加载自己的世界。每个世界在/world中都有单独的文件夹。
level-seed 字符串 空白 生成地形时 为世界定义一个种子 留空将随机选择种子。
level-type 字符串 DEFAULT 生成地形时 设置地图的类型 FLAT-超平坦

LEGACY-旧世界类型

DEFAULT-默认

max-players 正整数 10 总是生效 设置服务器同时能容纳的最大玩家数量 较高的值可能会影响服务器性能。
max-threads 整数 8 总是生效 设置服务器使用的最大线程数 如果设置为0,服务器会尽可能多地使用所有线程。
online-mode 布尔值(true, false) true 总是生效 是否身份验证 如果为true,则每个玩家都必须与Xbox进行身份验证。
player-idle-timeout 整数 30 总是生效 设置空闲玩家被踢出的时间 单位为分钟。玩家空闲时间到达设定值后将被踢出。
server-name 字符串 Dedicated Server 总是生效 作为服务器的名称 将作为服务器在服务器列表中显示的名称。
server-port 整数 19132 总是生效 设置服务器的IPv4端口号
server-portv6 整数 19133 总是生效 设置服务器的IPv6端口号
texturepack-required 布尔值 false 总是生效 是否强制加载资源包 如果为true,则当服务器有资源包时,将强制客户端使用。
tick-distance 整数(4-12) 4 总是生效 设置停止加载区块的距离 当玩家远离某个区块的距离超过设定值后,该区块会停止加载。较高的值可能会影响服务器性能。
view-distance 整数 10 总是生效 设置玩家可视距离最大值 单位为区块较高的值可能会影响服务器性能。
white-list 布尔值 false 总是生效 是否有白名单 如果为true,则每个玩家都必须要在whitelist.json文件中才能登录服务器。

Minecraft Classic 服务器属性

属性 类型 默认值 描述
verify-names 布尔值 true 验证玩家的IP是否与其连接Minecraft.net的IP相同。如果启用,会在内部网络中造成问题。
true - 启用。
false - 禁用。
admin-slot 布尔值 false 允许OP在服务器人满时也能加入游戏。
public 布尔值 服务器是否显示在服务器列表里。
true - 服务器会显示在服务器列表里,任何人都能看到。
false - 服务器不会对外广播。只有掌握服务器地址的人才能加入。
server-name 字符串 服务器名称,会显示在服务器名单上。
  • 单行文本。部分字符,例如'(单引号)可能需要在前面加反斜杠号\才能正确应用。
max-players 整数(0-256) 服务器同时在线的最大玩家人数。服务器OP不被计算在内。
max-connections 整数(1-3) 同一个IP允许的最大连接数。
motd 字符串 motd是玩家加入服务器时显示的信息。
grow-trees 布尔值 是否允许树苗长成为树木。
true - 允许树苗长成为树木。
false - 不允许树苗长成为树木。
Advertisement