本站文本内容除另有声明外,均在知识共享 署名-非商业性使用-相同方式共享 3.0 协议下提供。(详细信息…

server.properties

来自Minecraft Wiki
跳转至: 导航搜索
用Notepad++打开的server.properties文件

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

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

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

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

文件位置[编辑 | 编辑源代码]

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

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

Unix *nix/Mac

工作目录路径(pwd)

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

  • 准备一个完整的文件夹以存放所有服务端文件。(如果你不这么做的话事情会一团糟
    • 把minecraft_server.jar复制进去。
  • 使用Media:Minecraft server template.txt脚本作为创建Minecraft服务端启动脚本的教程。
    • 确保它位于你的可执行目录$PATH
    • 确保你具有启动脚本的执行权限(chmod +x 文件名,或使用文件夹管理器)
      • minecraft_server(.sh)

Server.properties[编辑 | 编辑源代码]

新创建的Minecraft服务器具有以下默认设置:

#Minecraft server properties
#(File Modification Datestamp)
generator-settings=
op-permission-level=4
allow-nether=true
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

Minecraft服务器属性[编辑 | 编辑源代码]

属性 类型 默认值 描述
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也不具有在人满的情况下强行进入服务器的权力。所以请慎重设置本属性,过大的数值会使客户端显示的玩家列表崩坏。
max-tick-time 整数(0–(2^63 - 1)) 60000 毫秒计数的最大服务器看门狗消息监测周期,超过该周期看门狗将停止服务器程序。一个服务器周期为60.00秒(最大密度0.05);如果服务器程序被判定为宕机,它将被强制终止运行。遇到这种情况的时候,它调用System.exit(1)。

译者:如果你监测服务程序的返回代码,此时返回代码为1,(习惯上,程序正常退出应当返回0)

The maximum number of milliseconds a single tick may take before the server watchdog stops the server with the message, A single server tick took 60.00 seconds (should be max 0.05); Considering it to be crashed, server will forcibly shutdown. Once this criteria is met, it calls System.exit(1).

-1 - disable watchdog entirely (this disable option was added in 14w32a)
-1 - 完全停用看门狗(这个停用选项在14w32a快照中添加)
max-world-size 整数(1-29999984) 29999984 设置世界的边界最大半径值,以方块数量表示。使用命令操作超过边界更大区域该命令也能完全成功执行,但是真实的边界不会移动过限制的方块。如果设置 max-world-size 超过默认值的大小,将不会起任何效果。

This sets the maximum possible size in blocks, expressed as a radius, that the world border can obtain. Setting the world border bigger causes the commands to complete successfully but the actual border will not move past this block limit. Setting the max-world-size higher than the default doesn't appear to do anything.

例如:
设置 max-world-size 为 1000 ,地图边界将是 2000x2000 尺寸。
设置 max-world-size 为 4000 ,地图边界将是 8000x8000 尺寸。
motd 字符串 A Minecraft Server 本属性值是玩家客户端的多人游戏服务器列表中显示的服务器讯息,显示于名称下方。
  • 请注意,motd 不支持彩色样式代码
  • 如果 motd 超过59字符,服务器列表很可能会返回“通讯错误”。
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分钟即会被踢出服务器。
注: 玩家产生以下操作时,空闲时间将被复位
  • 102 (0x66) WindowClick
  • 108 (0x6c) ButtonClick
  • 130 (0x82) UpdateSign
  • 14 (0xe) BlockDig
  • 15 (0xf) Place
  • 16 (0x10) BlockItemSwitch
  • 18 (0x12) ArmAnimation
  • 19 (0x13) EntityAction
  • 205 (0xcd) ClientCommand
  • 3 (0x3) Chat
  • 7 (0x7) UseEntity
resource-pack 字符串 空白 随意的 URI 指向一个资源包。玩家可选择是否使用
resource-pack-hash 字符串 空白 资源包的SHA-1值,必须为小写十六进制,虽然不是必填选项,但可减少每次进入服务器时重复下载资源包的情况。
注:下载到的服务器资源包将保存在.minecraft\server-resource-packs下。
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)。
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 决定重生保护的半径。此设置为0时将不会禁用重生保护。 值为0时将保护重生点的单个区块;值为1时将保护以重生点为中心3x3的区块;值为2时将保护以重生点为中心5x5的区块,值为3时将保护以重生点为中心7x7的区块……此选项不会在服务器初始化时生成,而在第一个玩家加入服务器时出现。如果OP没有设置该项,重生保护将自动关闭。
use-native-transport 布尔值 true 是否使用针对Linux平台的数据包收发优化,此选项仅会在Linux平台下生成。
true - 启用
false - 禁用
view-distance 整数(3-15) 10 设置服务端传送给客户端的数据量。用每一个方向上的区块数量衡量。这个值也是客户端视野距离的上限。当视野为“远”时,实际的值为9,所以默认推荐值为 10 。
white-list 布尔值 false 允许服务器白名单

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

- OP会自动被视为在白名单上。所以无需再将OP加入白名单。
false - 不使用白名单。
true - 从 whitelist.json 文件加载白名单。
enable-command-block 布尔值 false 当启用时地图中的命令方块可以被红石所激活
- 只有在创造模式的OP才可以正常输入命令方块命令

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