We have begun migration of most wikis to our new host, Amazon Web Services. All but the top 100 wikis are in read-only mode until the migration is complete. Estimated completion: TBD -- Update: Fri 10/20 11pm UTC - We have encountered some unexpected issues. Our staff is working around the clock to complete this process as quickly as possible. Thank you for your patience.
Java Edition only
Each level is its own folder. A level folder is often identified by having a level.dat file, along with other subfolders to store the maps and regions of the level.
Level folders will always contain the items in bold, and will sometimes contain the items in italics.
|/level.dat||(below)||Stores global information about the level.|
|/level.dat_new||-||Program writes new global information about the level and after that file is renamed to level.dat|
|/level.dat_mcr||-||A backup of the level.dat file before conversion from MCRegion to Anvil.|
|/level.dat_old||-||A backup of the level.dat file before conversion from the Alpha level format to MCRegion or Anvil.|
|/session.lock||(below)||Used to give write access to the last program to modify this file.|
|/players/<player>.dat||Player.dat Format||Stores the individual states of the players that have played on this level, for versions before 1.7.6.|
|/playerdata/<uuid>.dat||Player.dat Format||Stores the individual states of the players that have played on this level, since 1.7.6.|
|/stats/<uuid>.json||Statistics storage format||Stores the statistics of the players that have played on this level, since 1.7.2.|
|/advancements/<uuid>.json||TBD||Stores the advancements and unlocked recipes of the players that have played on this level, since 17w13a.|
|Map Item Format||Stores the map data for the craftable Map items.|
|villages.dat Format||Stores information about the Villages in the world. The "nether" and "end" files have been added in 1.8.|
|Generated structures data file format||Stores information about the generation of various Generated structures in the world.|
|/region/||-||Contains region files for The Overworld.|
|/DIM-1/region/||-||Contains region files for The Nether.|
|/DIM1/region/||-||Contains region files for The End.|
|Anvil file format||Individual region files.|
|Region file format||Backups of the region files before conversion from MCRegion to Anvil.|
|/<#>/<#>/c.<#>.<#>.dat||Alpha Level Format||Backups of the chunk files before conversion from the Alpha level format to MCRegion.|
level.dat format[edit | edit source]
The level.dat file contains global information about the world such as the time of day, the singleplayer player, the level generator used, and the seed. It is an NBT file with this structure:
The root tag.
Data: This tag contains all the level data.
DimensionData: This tag contains level data specific to certain dimensions.
1: Data for The End
DragonFight: Data for the ender dragon fight. Only appears after the end is entered.
ExitPortalLocation: Location of the End's exit portal that the ender dragon flies to upon it's death
X: The X coordinate of the portal.
Y: The Y coordinate of the portal.
Z: The Z coordinate of the portal.
Gateways: Contains a list of locations of the End gateway portals that haven't been spawned.
: The angle of a future gateway, from 0 to 19. 0 is east of the exit portal, and numbers increase clockwise.
DragonKilled: 1 or 0 (true/false) - If the dragon is currently alive.
DragonUUIDLeast: The least significant bits of the current Ender Dragon's Universally Unique IDentifier. This is joined with DragonUUIDMost to form the dragon's unique ID.
DragonUUIDMost: The most significant bits of the current Ender Dragon's Universally Unique IDentifier. This is joined with DragonUUIDLeast to form the dragon's unique ID.
PreviouslyKilled: 1 or 0 (true/false) - If the ender dragon has ever been defeated. Used to determine EXP given by dragon.
version: The NBT version of the level, 19133.
initialized: 1 or 0 (true/false) - Normally true after a world has been initialized properly after creation. If the initial simulation was canceled somehow, this can be false and the world will be re-initialized on next load.
LevelName: The name of the level.
generatorName: The name of the generator; "default", "flat", "largeBiomes", "amplified", "customized", or "debug_all_block_states". Not case sensitive, but always written in the case here.
generatorVersion: The version of the level generator. The effects of changing this are unknown, but values other than 0 have been observed.
generatorOptions: Controls options for the world generator. Used only if the world type is Superflat or Customized. The format for Superflat is a comma separated list of block IDs from the bottom of the map up, and each block ID may optionally be preceded by the number of layers and an "*" ("x" before 1.8). Damage values are not supported. The format for Customized is an extremely long String which has name:value pairs resembling JSON.
RandomSeed: The random level seed used to generate consistent terrain.
MapFeatures: 1 or 0 (true/false) - true if the map generator should place structures such as villages, strongholds, and mineshafts. Defaults to 1. Always 1 if the world type is Customized.
LastPlayed: The Unix time in milliseconds when the level was last loaded.
SizeOnDisk: The estimated size in bytes of the level. Currently not modified or used by Minecraft, but was previously.
allowCommands: 1 or 0 (true/false) - true if cheats are enabled.
hardcore: 1 or 0 (true/false) - true if the player must delete their world on death in singleplayer. Affects all three game modes.
GameType: The default game mode for the singleplayer player when they initially spawn. 0 is Survival Mode, 1 is Creative Mode, 2 is Adventure Mode, 3 is Spectator Mode. Note: Singleplayer worlds do not use this field to save which game mode the player is currently in.
Difficulty: The current difficulty setting. 0 is Peaceful, 1 is Easy, 2 is Normal, and 3 is Hard. Defaults to 2.
DifficultyLocked: 1 or 0 (true/false) - True if the difficulty has been locked. Defaults to 0.
Time: The number of ticks since the start of the level.
DayTime: The time of day. 0 is sunrise, 6000 is mid day, 12000 is sunset, 18000 is mid night, 24000 is the next day's 0. This value keeps counting past 24000 and does not reset to 0.
SpawnX: The X coordinate of the world spawn.
SpawnY: The Y coordinate of the world spawn.
SpawnZ: The Z coordinate of the world spawn.
BorderCenterX: Center of the world border on the X coordinate. Defaults to 0.
BorderCenterZ: Center of the world border on the Z coordinate. Defaults to 0.
BorderSize: Width of the border. Defaults to 60000000.
BorderSafeZone: Defaults to 5.
BorderWarningBlocks: Defaults to 5.
BorderWarningTime: Defaults to 15.
BorderSizeLerpTarget: Defaults to 60000000.
BorderSizeLerpTime: Defaults to 0.
BorderDamagePerBlock: Defaults to 0.2.
raining: 1 or 0 (true/false) - true if the level is currently experiencing rain, snow, and cloud cover.
rainTime: The number of ticks before "raining" is toggled and this value gets set to another random value.
thundering: 1 or 0 (true/false) - true if the rain/snow/cloud cover is a lightning storm and dark enough for mobs to spawn under the sky.
thunderTime: The number of ticks before "thundering" is toggled and this value gets set to another random value.
clearWeatherTime: The number of ticks until "clear weather" has ended.
Player: The state of the Singleplayer player. This overrides the <player>.dat file with the same name as the Singleplayer player. This is only saved by Servers if it already exists, otherwise it is not saved for server worlds. See Player.dat Format.
GameRules: The gamerules used in the world.
Rule name: The value for the given rule. This is always an NBT string, which is either
falsefor the majority of rules (with it being a number for some other rules, and any arbitrary string for a user-defined rule).
Version: Information about the Minecraft version the world was saved in.
Id: An identifier for the version.
Name: The version name as a string, e.g. "15w32b"
Snapshot: 1 or 0 (true/false) - Whether the version was a snapshot
session.lock format[edit | edit source]
This file contains the timestamp of when the level was last accessed. The file contains a single 64-bit integer in big endian format, which is the timestamp, stored as the number of milliseconds elapsed since 1970-01-01 00:00:00, in UTC.
Unlike typical lock files, this file ensures that the last program to access the level is that one that has read and write access. The process goes something like this:
- Program opens session.lock
- Program writes timestamp to session.lock
- Program monitors session.lock for changes
- If the contents of session.lock change, program aborts and gives up its lock on the level.
Minecraft can sometimes try to hold the lock on a level even after the player has started playing a different level, and this can cause strange behavior. It is recommended to ensure that Minecraft is closed before trying to acquire a lock on a level.
References[edit | edit source]