关于基岩版的世界格式,请见“基岩版世界格式”。
此特性为Java版独有。
每一个世界都有自己的文件夹。在每一个世界的存档文件夹中通常需要靠level.dat文件和存储地图和区域的子文件夹才能鉴别对应的世界。
在世界文件夹中一定包含的文件以粗体显示,可能包含的文件则以斜体的形式显示。
相对路径
名称
描述
/level.dat
见下文
存储关于世界的全局信息。
/level.dat_new
—
程序会在此文件中写入该世界的新的全局信息,之后会被重命名为level.dat。
/level.dat_mcr
—
level.dat文件在转换为MCRegion和Anvil文件前的备份文件。
/level.dat_old
—
level.dat文件在从Alpha世界格式转换为MCRegion和Anvil文件前的备份文件。[来源请求]
/session.lock
见下文
用于获取最后执行的程序修改这一文件以及访问的权限。
/players/
Player.dat格式
在Java版1.7.6之前,存储这一世界内玩家所有的个人信息。
/playerdata/
Player.dat格式
于Java版1.7.6加入,存储这一世界内玩家所有的个人信息。
/stats/
统计储存格式
于Java版1.7.2加入,储存玩家在此世界游玩时的统计。
/advancements/
待定
储存玩家在该世界的进度和已解锁的配方。
/data/idcounts.dat/data/map_<#>.dat
地图物品格式
存储可合成地图这一物品所包括的地图数据。
/data/random_sequences.dat
随机序列格式
存储战利品表使用的随机序列数据。
/data/villages.dat
Villages.dat格式
存储世界中村民的信息。“nether”和“end”文件在Java版1.8被加入。在Java版1.14中被POI区域文件代替。
/entities//DIM-1/entities//DIM1/entities/
实体格式
保存了实体数据。
/poi//DIM-1/poi//DIM1/poi/
兴趣点文件格式
世界内的兴趣点信息,例如村民特定的床,工作站点和钟。
/data/raids.dat/DIM-1/data/raids_nether.dat/DIM1/data/raids_end.dat
raids.dat格式
储存世界内正在进行的袭击的信息。
/region//DIM-1/region//DIM1/region/
区块格式
包含各个维度中的区域信息。
r.<#>.<#>.mca
Anvil文件格式
独立区域信息。
r.<#>.<#>.mcr
Region文件格式
用于存储区域文件在从Region文件格式转换为Anvil之前的备份文件。
/<#>/<#>/c.<#>.<#>.dat
Alpha世界格式
用于存储区块文件在转换从Alpha世界格式转换为MCRegion之前的备份文件。
level.dat格式[]
level.dat文件包含了世界的全局信息,如时间,单人游戏玩家,所使用的世界类型以及地图种子等。为NBT文件,其格式如下:
根标签
Data:此标签包含所有的世界数据。
allowCommands:表示此世界是否允许作弊。
BorderCenterX:世界边界中心的X坐标。默认为0。
BorderCenterZ:世界边界中心的Z坐标。默认为0。
BorderDamagePerBlock:超出边界安全区后,玩家每远离安全区一格增加的伤害值。默认0.2。
BorderSafeZone:超出边界后,玩家仍然不会受到窒息伤害的安全区的宽度。默认为5。
BorderSize:边界宽度。默认为59999968。
BorderSizeLerpTarget:边界宽度过渡到的目标宽度。默认为59999968。
BorderSizeLerpTime:边界宽度的过渡时间。默认为0。
BorderWarningBlocks:玩家接近边界渲染出现红色警告框的最大距离。默认为5。
BorderWarningTime:当玩家接近边界距离小于边界过渡速度乘以此值时渲染出现红色警告框。默认为15。
clearWeatherTime:晴天剩余刻数,在此期间天气将保持晴天,但此值大于0不是晴天的必须条件。默认为0。
CustomBossEvents:自定义boss栏数据。
Color:boss栏的颜色代码,可以为pink(粉色)、blue(蓝色)、red(红色)、green(绿色)、yellow(黄色)、purple(紫色)和white(白色)。
CreateWorldFog:表示boss栏是否创建迷雾效果。
DarkenScreen:表示boss栏是否会使天空变得黯淡。
Max:boss栏的最大值。
Name:boss栏的显示文本,是一个JSON文本。
Overlay:boss栏的显示样式。可以的值有progress(完整进度条)、notched_6(进度条分为6段)、notched_10(进度条分为10段)、notched_12(进度条分为12段)和notched_20(进度条分为20段)。
PlayBossMusic:表示boss栏是否播放boss音乐。
Players:可以看见boss栏的玩家列表。
: 玩家的UUID。
Value:boss栏的当前值。
Visible:表示boss栏是否对列表中的玩家可见。
DataPacks:数据包选项。
Disabled:禁用的数据包。
:一个数据包。
Enabled:启用的数据包。默认会包含字符串"vanilla"。
:一个数据包。
DataVersion:存档的数据版本。
DayTime:游戏时间,以刻计。
Difficulty:游戏难度。0-3分别为和平、简单、普通和困难,默认为2(普通)。
DifficultyLocked:表示难度是否被锁定。默认为false。
DragonFight:末影龙战斗数据。
Dragon:当前末影龙的UUID。
DragonKilled:表示末影龙是否已经死亡。
ExitPortalLocation:末影龙被击败后会飞往的地方,即返回传送门的位置。
X:传送门的X轴坐标。
Y:传送门的Y轴坐标。
Z:传送门的Z轴坐标。
Gateways:包含即将生成的末地折跃门的位置。刚创建世界时为20个数字,末影龙每死亡一次此列表长度减1,直到为0。
:折跃门的角度,0为东方,数字按顺时针方向递增。
NeedsStateScanning:表示此世界是否没有进入过末地。
PreviouslyKilled:表示末影龙是否被击败过。决定下次击败末影龙获得的经验值。
enabled_features:被启用的游戏内容,可能不存在。
:已被启用的游戏内容,以命名空间ID表示。目前可用值有minecraft:vanilla(原版内容,此项必须存在)、minecraft:bundle(收纳袋内容)、minecraft:trade_rebalance(村民交易的平衡性调整内容)和minecraft:update_1_21(1.21更新内容)。
GameRules:游戏规则,一共43条。
<游戏规则名称>:一项游戏规则和它对应的值。
GameType:在单人游戏玩家生成或重生时的默认游戏模式。0为生存模式,1为创造模式,2为冒险模式,3为旁观模式。
hardcore:表示玩家死亡后是否转变为旁观模式。
initialized:表示世界是否被正确初始化。如果世界初始化被某种情况所中断,此处为false,世界将会在下一次载入时重新初始化。
LastPlayed:世界最后被加载时的Unix时间戳。
LevelName:世界的名字。
Player:单人游戏玩家的数据。此处如果玩家与
参见Player.dat格式。
raining:表示目前是否处于降雨天气。
rainTime:如果目前不处于降雨天气,此值代表距离下一次降雨的时间,取值为12000游戏刻(10分)~180000游戏刻(150分)。如果目前正处于降雨天气,此值表示距离降雨结束的时间,取值为12000游戏刻(10分)~24000游戏刻(20分)。
removed_features:曾经已被启用过的游戏内容,开关该游戏内容的选项被弃用,可能不存在。
:曾经已被启用过的游戏内容,开关该游戏内容的选项被弃用,以命名空间ID表示。目前可用值有minecraft:update_1_20(1.20更新内容)。
ScheduledEvents:已计划的事件列表。
:一个计划事件。
Callback:事件回调。
Name:回调名称,是一个命名空间ID。
Type:回调类型。可以为minecraft:function(函数)和minecraft:function_tag(函数标签)。
Name:事件名称。
TriggerTime:触发时间。
ServerBrands:打开过此存档的服务器的铭牌列表。
:一个服务器铭牌。
SpawnAngle:出生角度。
SpawnX:出生点的X坐标。
SpawnY:出生点的Y坐标。
SpawnZ:出生点的Z坐标。
thundering:表示目前是否处于雷暴天气。
thunderTime:如果目前不处于雷暴天气,此值代表距离下一次雷暴的时间,取值为12000游戏刻(10分)~180000游戏刻(150分)。如果目前正处于雷暴天气,此值表示距离雷暴结束的时间,取值为3600游戏刻(3分)~15600游戏刻(13分)。
Time:世界自开始时所经历的刻数。
version:区块文件的版本,对于Anvil文件格式为19133,对于McRegion格式为19132。
Version:世界存入时的版本信息。
Id:数据版本。
Name:版本名称,比如15w32b。
Series:开发系列,用于标识开发分支。1.18实验性快照中为“ccpreview”,其他则为“main”。
Snapshot:表示此版本是否为快照版。
WanderingTraderId:流浪商人的UUID。
WanderingTraderSpawnChance:下次生成尝试时,生成流浪商人的概率。此值以百分比表示,游戏加载时除以10计算真实概率。如50表示5.0%的生成概率。
WanderingTraderSpawnDelay:距下次尝试生成流浪商人的刻数。
WasModded:表示此世界是否在被修改过的版本中打开过。
WorldGenSetting:世界与各维度的生成设置。
bouns_chest:表示在玩家首次进入游戏时,是否在出生点附近生成奖励箱,仅单人游戏有效。
dimensions:包含世界所有的维度。
<维度的命名空间ID>:生成器设置的根标签。
generate_features:表示世界是否生成结构。
seed:数字形式的世界种子。
generatorOptions标签格式[]
该段落所介绍的内容已从Minecraft中移除。
这些特性曾存在于游戏中,但已被移除。
在1.15及之前,世界生成器使用 generatorOptions保存:
generatorName:世界类型:default(默认)、flat(超平坦)、largeBiomes(巨型生物群系)、amplified(放大化)、debug_all_block_states(调试模式)和buffet(自选)。不区分大小写。
generatorOptions:自选世界类型、超平坦世界和旧版自定义世界的生成器选项。
generatorVersion:世界类型的版本。修改此处的作用未知,但是从观察到的情况下非零。
不同世界类型的世界, generatorOptions标签的具体格式不同。此标签下的内容仅影响主世界,适用于1.15及以下版本。
以下格式适用于自选世界类型:
generatorOptions:生成器选项根标签。
biome_source:生物群系源。
options:生物群系设置。
biomes:生物群系的列表。
:一个生物群系ID
size:生物群系的大小。仅用于生物群系生成器为minecraft:checkerboard时,生物群系分界处分辨率为2
type:生物群系生成器,无法在游戏内改变,默认为minecraft:fixed,也可以是minecraft:checkerboard和minecraft:vanilla_layered。
chunk_generator:区块生成器。
options:区块生成器选项。
default_block:默认的方块,为方块ID。默认为minecraft:stone。
default_fluid:默认的流体,为方块ID。默认为minecraft:water。
type:使用的生成器ID。可以是minecraft:surface、minecraft:cave和minecraft:floating_islands。
以下格式适用于超平坦世界:
generatorOptions:生成器选项根标签。
structures:超平坦世界的结构。
结构名称:名称为结构名称的空复合标签,比如village。
参数名称:参数值为一以字符串代表的数字。
layers:设置超平坦的地层。
:一层。
block:方块ID。
height:地层高度,用于在Java版1.13-pre5之前生成的世界。
height:地层高度(小于128格),用于在Java版1.13-pre5及之后生成的世界。
height:地层高度(大于等于128格),用于在Java版1.13-pre5及之后生成的世界。
biome:生物群系ID。
flat_world_options:未转义的generator-settings字符串。仅在由服务器创建的世界上出现。由于MC-134900,20w11a之前都不会被游戏解析,故不能生成以上复合标签,故generator-settings无法正常生效。
以下格式适用于旧版自定义世界:
该章节的编辑正在进行中。
请帮助我们扩充或改进这篇文章。
session.lock格式[]
此文件包含了该世界最后一次进入时的时间戳。该文件包含一个大端序的64位整数,为自1970-01-01 00:00:00(UTC)时区至今所经历的毫秒数。
与典型的lock文件不同,这一文件确保了最后访问这一世界的程序有读取和修改的权限。该过程通常如下所示:
程序打开session.lock
程序在session.lock写入当前时间戳
程序对session.lock的变化进行监控
如果session.lock内容发生变化,则程序中断并锁定世界。
即使在玩家开始这一世界之后Minecraft有时也会锁定这一世界。这通常会带来未知的后果。推荐在需要获取修改世界的权限之前完全关闭Minecraft程序。
在Linux发行版中,session.lock会有如下行为:
若session.lock没有w(写)权限,该世界在“选择世界”菜单中显示红色文本“被另一个正在运行的Minecraft实例锁定”,且无法进入。
在ext文件系统上,若session.lock已经拥有文件属性i,该世界不会在“选择世界”菜单中出现;若session.lock在游戏位于“选择世界”菜单时拥有了文件属性i,该世界并不会立刻从菜单中消失,但是尝试进入时会出现“加载世界失败”的提示并回到标题屏幕。
在终端使用rm命令删除session.lock不会导致世界被锁定。
Java版
版本
演示版
地点
PC Gamer演示版(Beta 1.3)
开发周期
版本记录
pre-Classic
Classic
Classic早期创造
多人测试
生存测试
Classic后期创造
Indev
Infdev
Alpha
Beta
正式版
开发版本
已移除特性
方块
物品
配方
未使用特性
独有特性
提及特性
计划版本
技术
已知漏洞
启动器
Minecraft API
硬件需求
al_version
方块实体
命令
函数
崩溃
数据值
Classic
Indev
扁平化前
数据版本
调试屏幕
格式化代码
键控代码
启动器
命名空间ID
协议版本
截屏
种子
统计信息
刻
出生点区块
坐标
世界加载屏幕
.minecraft
client.jar
client.json
launcher_profiles.json
options.txt
开发资源
Anvil文件格式
区块格式
命令存储格式
世界格式
战利品表
随机序列格式
地图物品格式
模型
Mojang API
NBT格式
混淆映射表
实体格式
生物记忆
Player格式
兴趣点文件格式
raids.dat格式
区域文件格式
结构文件格式
Schematic文件格式
记分板格式
已保存的快捷栏格式
服务器列表格式
原始JSON文本格式
sounds.json
字幕
已配置的地物
已配置的结构地物
过时开发资源
Classic世界格式
Classic服务器协议
Indev世界格式
Alpha世界格式
材料
server_level.dat
结构生成格式
villages格式
已配置的地表生成器
多人游戏
服务器
Minecraft Realms
服务器列表
server.properties
服务器需求
定制服务器
游戏订制
皮肤
披风
资源包
数据包
语言
Deutsch
English
français
日本語
한국어
Nederlands
português