-
-
Notifications
You must be signed in to change notification settings - Fork 148
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
updated documentation to use the new minecraft wiki (#260)
Co-authored-by: Nitzsche, Samuel (SE-A/33) <[email protected]>
- Loading branch information
Showing
1 changed file
with
34 additions
and
23 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,76 +1,87 @@ | ||
| ### 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. | ||
| > 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 Fandom](https://minecraft.fandom.com/wiki/Region_file_format). | ||
| More details can be found on the [Minecraft Wiki](https://minecraft.wiki/w/Region_file_format). | ||
|
|
||
| #### 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 | ||
| 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 Fandom](https://minecraft.fandom.com/wiki/Anvil_file_format). | ||
| More details can be found on the [Minecraft Wiki](https://minecraft.wiki/w/Anvil_file_format). | ||
|
|
||
| #### 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 | ||
|
|
||
| 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](https://github.com/xymb-endcrystalme/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 | ||
|
|
||
| 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](https://github.com/cijaaimee/Slime-World-Manager#:~:text=Slime%20World%20Manager%20is%20a,worlds%20faster%20and%20save%20space.), as well as on [Dev Blog #5](https://hypixel.net/threads/dev-blog-5-storing-your-skyblock-island.2190753/) 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. | ||
| 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. | ||
|
|
||
| More details can be found on the [Minecraft Fandom](https://minecraft.fandom.com/wiki/Schematic_file_format) | ||
| The files stored in this format are .schematic files, and are stored in NBT format. | ||
|
|
||
| More details can be found on the [Minecraft Wiki](https://minecraft.wiki/w/Schematic_file_format) | ||
|
|
||
| ### 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 | ||
|
|
||
| - 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 | ||
| - 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 | ||
|
|
||
| - 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 | ||
|
|
||
| - 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. |