World Formats

IMPORTANT

Currently, Pumpkin only supports Anvil World Format, which is the format used by vanilla Minecraft. There is planned support for other world formats in the future though, as listed below.

Region File Format

Minecraft Beta 1.3 to Release 1.2 used a Minecraft format known as "Region file format".

The files stored in this format are .mcr files, each storing a group of 32x32 chunks called a region.

More details can be found on the Minecraft Wiki.

Anvil File Format

Replacing the Region File Format after Minecraft Release 1.2, this is the file format used to store modern vanilla Java Minecraft worlds.

The files stored in this format are .mca files, while using the same region logic, there were a number of changes. The notable changes include an increase to a 256 hight limit, then to 320, as well as a higher number of block ID's.

More details can be found on the Minecraft Wiki.

Linear File Format

There is a more modern file format known as the Linear region file format. Saving on disk space and using the zstd library instead of zlib. This is beneficial as zlib is extremely old and outdated.

The files stored in this format are .linear files, and it says about 50% of disk space in the Overworld and Nether, while saving 95% in the end.

More details can be found at the github page for LinearRegionFileFormatTools.

Slime File Format

Developed by Hypixel to fix many of the pitfalls of the Anvil file format, Slime also replaces zlib and saves space compared to Anvil, in addition to saving the entire world in a single save file, and allowing that file to be loaded into multiple instances.

The files stored in this format are .slime files.

More details can be found on the github page for Slime World Manager, as well as on Dev Blog #5 for Hypixel.

Schematic File Format

Unlike the other File Formats listed, the Schematic File Format is not for storing minecraft worlds, but instead for use within 3rd party programs such as MCEdit, WorldEdit, and Schematica.

The files stored in this format are .schematic files, and are stored in NBT format.

More details can be found on the Minecraft Wiki

World Generation

When the server is starting up, it checks if there is a save present, also known as the "world"

Pumpkin then calls for World Generation:

Save Present

AnvilChunkReader is called to process the region files for the given save

• As stated above, region files store 32x32 chunks

  Each region file is named corrosponding to coordinates of where it is in the world

r.{}.{}.mca

• The location table is read from the save file, representing the chunk coordinates
• The timestamp table is read from the save file, representing the last time the chunk was modified

No Save Present

The world seed is set to "0", in the future it will be set to the value in Basic Configuration

PlainsGenerator is called, as so far the plains is the only biome that has been implemented.

• PerlinTerrainGenerator is called to set chunk height
• Stone height is set 5 below chunk height
• Dirt height is set to 2 below chunk height
• Grass Blocks appear at the top of dirt
• Bedrock is set at y = -64
• Flowers and short grass are scattered about randomly

SuperflatGenerator is also avaliable, but is not currently callable.

• Bedrock is set at y = -64
• Dirt is set two blocks up
• Grass Block is set one more block up

Blocks are able to be placed and broken, but changes are not able to be saved in any world format. Anvil worlds are currently read only.