mcbe-leveldb 1.9.1-jsonly → 1.10.0

package/Changelog.md

@@ -1,3 +1,54 @@
+# v1.10.0
+
+## Breaking Changes
+
+-   The `Dimension` content type and corresponding NBT schema have been split up into three new content types and NBT schemas:
+    -   `Overworld`
+    -   `Nether`
+    -   `TheEnd`
+-   The `LegacyDimension` content type has been split up into three new content types:
+    -   `LegacyOverworld`
+    -   `LegacyNether`
+    -   `LegacyTheEnd`
+-   All NBT schemas have been updated to have descriptions specified on the `markdownDescription` property instead of the `description` property.
+-   All NBT schemas have been updated to have enum descriptions specified on the `markdownEnumDescriptions` property instead of the `enumDescriptions` property.
+
+## Additions
+
+-   Added a custom serializer and parser for the `LegacyTerrain` content type.
+-   Added the `LegacyTerrain` NBT schema.
+-   Added a custom serializer and parser for the `Data2D` content type.
+-   Added the `Data2D` NBT schema.
+-   Added a custom serializer and parser for the `Data2DLegacy` content type.
+-   Added the `Data2DLegacy` NBT schema.
+-   Added support for `SubChunkPrefix` versions `0x00`, `0x01`, `0x02`, `0x03`, `0x04`, `0x05`, `0x06`, and `0x07`.
+-   Split the `SubChunkPrefix` NBT schema into three versioned schemas, the `SubChunkPrefix` NBT schema now is a union of the three versioned schemas:
+    -   `SubChunkPrefix_v0` (versions 0, 2, 3, 4, 5, 6, and 7)
+    -   `SubChunkPrefix_v1` (version 1)
+    -   `SubChunkPrefix_v8` (versions 8 and 9, the same as the previous `SubChunkPrefix` NBT schema)
+-   Added the `LegacyOverworld` NBT schema.
+-   Added the `LegacyNether` NBT schema.
+-   Added the `LegacyTheEnd` NBT schema.
+-   Added the `PositionTrackingLastId` NBT schema.
+-   Added the `PositionTrackingDB` NBT schema.
+-   Added examples for the `InventoryVersion` property of the `LevelDat` NBT schema.
+-   Added the `DBEntryContentTypesGrouping` constant.
+-   Added the `DBEntryContentTypeGroup` type.
+-   Added the `tileID` property to the `PendingTicks` NBT schema.
+-   Added default values for the following content types:
+    -   `PendingTicks`
+    -   `RandomTicks`
+-   Added an enum to the `storageVersion` property of the `SubChunkPrefixLayer` NBT schema.
+-   Added min and max item count values to several properties of various NBT schemas.
+-   Added the `package.json` file to the `package.json` file's `exports` field.
+
+## Fixes
+
+-   The `currentTick` property of the `PendingTicks` NBT schema is now marked as optional as in older versions it doesn't exist.
+-   The `time`, `x`, `y`, and `z` properties of the `PendingTicks` and `RandomTicks` NBT schemas are now marked as required.
+-   The `blockState` property of the `RandomTicks` NBT schema is now marked as required.
+-   Fixed over 100 markdown links in the NBT schemas that were missing a `https://minecraft.wiki/w/` prefix.
+
 # v1.9.1
 
 ## Critical Fixes
@@ -22,7 +73,7 @@
 
 ## Fixes
 
--   `prettyPrintSNBT` no longer inserts newlines when the `indent` option is set to `0`. 
+-   `prettyPrintSNBT` no longer inserts newlines when the `indent` option is set to `0`.
 
 # v1.8.0
 

package/DBUtils.ts

@@ -0,0 +1,184 @@
+import type { LevelDB } from "@8crafter/leveldb-zlib";
+import { getContentTypeFromDBKey, type DBEntryContentType } from "./LevelUtils.ts";
+import NBT from "prismarine-nbt";
+import { JSONB } from "./utils/JSONB.ts";
+
+// TO-DO: Make an abstract class version of the LevelDB class to use as the type of the db parameter.
+
+/**
+ * Gets the keys from the LevelDB with a specific content type.
+ *
+ * @template T The content type to look for.
+ * @param db The LevelDB. Should match the type of the {@link LevelDB} class from the {@link https://www.npmjs.com/package/@8crafter/leveldb-zlib | @8crafter/leveldb-zlib} package. It does not have to be the one from that package, as long as the types match.
+ * @param type The {@link DBEntryContentType | content type} to look for.
+ * @returns The keys from the LevelDB with the specified content type, the keys are in Buffer format, this is because some keys contain binary data like chunk indices.
+ */
+export async function getKeysOfType<T extends DBEntryContentType>(db: LevelDB, type: T): Promise<Buffer<ArrayBuffer>[]>;
+/**
+ * Gets the keys from the list of LevelDB keys with a specific content type.
+ *
+ * @template T The content type to look for.
+ * @template TArrayBuffer The type of the buffers.
+ * @param dbKeys The LevelDB keys. Should be an array of Buffers.
+ * @param type The {@link DBEntryContentType | content type} to look for.
+ * @returns The keys from the provided LevelDB keys array with the specified content type, the keys are in Buffer format, this is because some keys contain binary data like chunk indices.
+ */
+export function getKeysOfType<T extends DBEntryContentType, TArrayBuffer extends ArrayBufferLike = ArrayBufferLike>(
+    dbKeys: Buffer<TArrayBuffer>[],
+    type: T
+): Buffer<TArrayBuffer>[];
+export function getKeysOfType<T extends DBEntryContentType>(dbOrDBKeys: LevelDB | Buffer[], type: T): Promise<Buffer<ArrayBuffer>[]> | Buffer[] {
+    if (Array.isArray(dbOrDBKeys)) return dbOrDBKeys.filter((key: Buffer): boolean => getContentTypeFromDBKey(key) === type);
+    return new Promise(
+        (resolve: (value: Buffer<ArrayBuffer>[]) => void): void =>
+            void (async (): Promise<void> => {
+                const foundKeys: Buffer<ArrayBuffer>[] = [];
+                for await (const [rawKey, _value] of dbOrDBKeys.getIterator({ keys: true, keyAsBuffer: true, values: false })) {
+                    if (getContentTypeFromDBKey(rawKey) === type) foundKeys.push(rawKey);
+                }
+                resolve(foundKeys);
+            })()
+    );
+}
+
+/**
+ * Gets the keys from the LevelDB with one of the specified content types.
+ *
+ * @template T The content types to look for.
+ * @param db The LevelDB. Should match the type of the {@link LevelDB} class from the {@link https://www.npmjs.com/package/@8crafter/leveldb-zlib | @8crafter/leveldb-zlib} package. It does not have to be the one from that package, as long as the types match.
+ * @param types The {@link DBEntryContentType | content types} to look for.
+ * @returns An object mapping each of the specified content types to the keys from the LevelDB with that content type, the keys are in Buffer format, this is because some keys contain binary data like chunk indices.
+ */
+export async function getKeysOfTypes<T extends DBEntryContentType[] | readonly DBEntryContentType[]>(
+    db: LevelDB,
+    types: T
+): Promise<{ [key in T[number]]: Buffer<ArrayBuffer>[] }>;
+/**
+ * Gets the keys from the list of LevelDB keys with one of the specified content types.
+ *
+ * @template T The content types to look for.
+ * @template TArrayBuffer The type of the buffers.
+ * @param dbKeys The LevelDB keys. Should be an array of Buffers.
+ * @param types The {@link DBEntryContentType | content types} to look for.
+ * @returns An object mapping each of the specified content types to the keys from the provided LevelDB keys array with that content type, the keys are in Buffer format, this is because some keys contain binary data like chunk indices.
+ */
+export function getKeysOfTypes<T extends DBEntryContentType[] | readonly DBEntryContentType[], TArrayBuffer extends ArrayBufferLike>(
+    dbKeys: Buffer<TArrayBuffer>[],
+    types: T
+): { [key in T[number]]: Buffer<TArrayBuffer>[] };
+export function getKeysOfTypes<T extends DBEntryContentType[] | readonly DBEntryContentType[]>(
+    dbOrDBKeys: LevelDB | Buffer[],
+    types: T
+): Promise<{ [key in T[number]]: Buffer<ArrayBuffer>[] }> | { [key in T[number]]: Buffer[] } {
+    const results = {} as { [key in T[number]]: Buffer<any>[] };
+    types.forEach((contentType: T[number]): void => {
+        results[contentType] = [];
+    });
+    if (Array.isArray(dbOrDBKeys)) {
+        for (const key of dbOrDBKeys) {
+            const contentType: DBEntryContentType = getContentTypeFromDBKey(key);
+            if (types.includes(contentType)) results[contentType as T[number]].push(key);
+        }
+        return results;
+    }
+    return new Promise(
+        (resolve: (value: { [key in T[number]]: Buffer<ArrayBuffer>[] }) => void): void =>
+            void (async (): Promise<void> => {
+                for await (const [rawKey, _value] of dbOrDBKeys.getIterator({ keys: true, keyAsBuffer: true, values: false })) {
+                    const contentType: DBEntryContentType = getContentTypeFromDBKey(rawKey);
+                    if (types.includes(contentType)) results[contentType as T[number]].push(rawKey);
+                }
+                resolve(results);
+            })()
+    );
+}
+
+/**
+ * Gets a player's name from their UUID.
+ *
+ * Only works if the player's name was stored in an add-on's dynamic properties with their ID linked to it, and it only works for a hardcoded list of add-ons,
+ * if you have your own add-on that you would like this to be able to read the player's names from, {@link https://www.8crafter.com/main/contact | contact 8Crafter},
+ * or make a pull request.
+ *
+ * @param db The LevelDB. Should match the type of the {@link LevelDB} class from the {@link https://www.npmjs.com/package/@8crafter/leveldb-zlib | @8crafter/leveldb-zlib} package. It does not have to be the one from that package, as long as the types match.
+ * @param uuid The UUID of the play to get the name of.
+ * @returns The name of the player, or `null` if the player's name cannot be found or the world has no dynamic properties.
+ *
+ * @throws {any} If there was an error reading the DynamicProperties from the DB.
+ */
+export async function getPlayerNameFromUUID(db: LevelDB, uuid: string | bigint): Promise<string | null> {
+    const dynamicProperties: NBT.NBT | null = await db
+        .get("DynamicProperties")
+        .then((data: Buffer | null): Promise<NBT.NBT> | null =>
+            data ? NBT.parse(data!).then((data: { parsed: NBT.NBT; type: NBT.NBTFormat; metadata: NBT.Metadata }): NBT.NBT => data.parsed) : null
+        );
+    if (!dynamicProperties) return null;
+    return getPlayerNameFromUUIDSync(dynamicProperties, uuid);
+}
+
+/**
+ * Gets a player's name from their UUID using the provided dynamic properties data.
+ *
+ * Only works if the player's name was stored in an add-on's dynamic properties with their ID linked to it, and it only works for a hardcoded list of add-ons,
+ * if you have your own add-on that you would like this to be able to read the player's names from, {@link https://www.8crafter.com/main/contact | contact 8Crafter},
+ * or make a pull request.
+ *
+ * @param dynamicProperties The dynamic properties data, should be the data from the `DynamicProperties` LevelDB key.
+ * @param uuid The UUID of the play to get the name of.
+ * @returns The name of the player, or `null` if the player's name cannot be found .
+ */
+export function getPlayerNameFromUUIDSync(dynamicProperties: NBT.NBT, uuid: string | bigint): string | null {
+    const UUIDString: string = uuid.toString();
+    for (const parser of playerUUIDToNameDynamicPropertyParsers) {
+        const name: string | null = parser(dynamicProperties, UUIDString);
+        if (name !== null) return name;
+    }
+    return null;
+}
+
+/**
+ * A function that can be used to get a player's name from their UUID from the dynamic properties.
+ */
+interface PlayerUUIDToNameDynamicPropertyParser {
+    /**
+     * A function that can be used to get a player's name from their UUID from the dynamic properties.
+     *
+     * @param dynamicProperties The dynamic properties data, should be the data from the `DynamicProperties` LevelDB key.
+     * @param uuid The UUID of the player to get the name of.
+     * @returns The name of the player, or `null` if the player's name cannot be found.
+     */
+    (dynamicProperties: NBT.NBT, uuid: string): string | null;
+}
+
+/**
+ * The list of functions that can be used to get a player's name from their UUID from the dynamic properties.
+ *
+ * These will be called in order until one of them returns a non-null value.
+ */
+const playerUUIDToNameDynamicPropertyParsers: PlayerUUIDToNameDynamicPropertyParser[] = [
+    function parse8CraftersServerUtilities(dynamicProperties: NBT.NBT, uuid: string): string | null {
+        const addOnUUIDs: string[] = [
+            // Internal development version
+            "53170125-3e79-4659-9bba-e49eb90b6ded",
+            // Release version
+            "53170125-3e79-4659-9bba-e49eb90b6dea",
+        ];
+        for (const addOnUUID of addOnUUIDs) {
+            const addonDynamicProperties: NBT.Compound["value"] | null =
+                dynamicProperties.value[addOnUUID]?.type === "compound" ? dynamicProperties.value[addOnUUID].value : null;
+            if (!addonDynamicProperties) continue;
+            for (const key in addonDynamicProperties) {
+                if (key !== `player:${uuid}`) continue;
+                const dynamicPropertyValue: NBT.Byte | NBT.Double | NBT.String | NBT.List<NBT.TagType.Float> = addonDynamicProperties[key]! as any;
+                if (dynamicPropertyValue.type !== "string") continue;
+                try {
+                    const data: any = JSONB.parse(dynamicPropertyValue.value);
+                    if (typeof data === "object" && data !== null && typeof data.name === "string") return data.name;
+                } catch (e) {
+                    continue;
+                }
+            }
+        }
+        return null;
+    },
+];

package/LevelUtils.d.ts

@@ -43,7 +43,77 @@ export declare const gameModes: readonly ["survival", "creative", "adventure", u
 /**
  * The content types for LevelDB entries.
  */
-export declare const DBEntryContentTypes: readonly ["Data3D", "Version", "Data2D", "Data2DLegacy", "SubChunkPrefix", "LegacyTerrain", "BlockEntity", "Entity", "PendingTicks", "LegacyBlockExtraData", "BiomeState", "FinalizedState", "ConversionData", "BorderBlocks", "HardcodedSpawners", "RandomTicks", "Checksums", "GenerationSeed", "GeneratedPreCavesAndCliffsBlending", "BlendingBiomeHeight", "MetaDataHash", "BlendingData", "ActorDigestVersion", "LegacyVersion", "AABBVolumes", "VillageDwellers", "VillageInfo", "VillagePOI", "VillagePlayers", "VillageRaid", "Player", "PlayerClient", "ActorPrefix", "ChunkLoadedRequest", "Digest", "Map", "Portals", "SchedulerWT", "StructureTemplate", "TickingArea", "FlatWorldLayers", "LegacyDimension", "MVillages", "Villages", "LevelSpawnWasFixed", "PositionTrackingDB", "PositionTrackingLastId", "Scoreboard", "Dimension", "AutonomousEntities", "BiomeData", "BiomeIdsTable", "MobEvents", "DynamicProperties", "LevelChunkMetaDataDictionary", "RealmsStoriesData", "LevelDat", "ForcedWorldCorruption", "Unknown"];
+export declare const DBEntryContentTypes: readonly ["Data3D", "Version", "Data2D", "Data2DLegacy", "SubChunkPrefix", "LegacyTerrain", "BlockEntity", "Entity", "PendingTicks", "LegacyBlockExtraData", "BiomeState", "FinalizedState", "ConversionData", "BorderBlocks", "HardcodedSpawners", "RandomTicks", "Checksums", "GenerationSeed", "GeneratedPreCavesAndCliffsBlending", "BlendingBiomeHeight", "MetaDataHash", "BlendingData", "ActorDigestVersion", "LegacyVersion", "AABBVolumes", "VillageDwellers", "VillageInfo", "VillagePOI", "VillagePlayers", "VillageRaid", "Player", "PlayerClient", "ActorPrefix", "ChunkLoadedRequest", "Digest", "Map", "Portals", "SchedulerWT", "StructureTemplate", "TickingArea", "FlatWorldLayers", "LegacyOverworld", "LegacyNether", "LegacyTheEnd", "MVillages", "Villages", "LevelSpawnWasFixed", "PositionTrackingDB", "PositionTrackingLastId", "Scoreboard", "Overworld", "Nether", "TheEnd", "AutonomousEntities", "BiomeData", "BiomeIdsTable", "MobEvents", "DynamicProperties", "LevelChunkMetaDataDictionary", "RealmsStoriesData", "LevelDat", "ForcedWorldCorruption", "Unknown"];
+/**
+ * Maps content types to grouping labels.
+ *
+ * Most content types are not grouped, only a few are.
+ */
+export declare const DBEntryContentTypesGrouping: {
+    readonly Data3D: "Data3D";
+    readonly Version: "Version";
+    readonly Data2D: "Data2D";
+    readonly Data2DLegacy: "Data2DLegacy";
+    readonly SubChunkPrefix: "SubChunkPrefix";
+    readonly LegacyTerrain: "LegacyTerrain";
+    readonly BlockEntity: "BlockEntity";
+    readonly Entity: "Entity";
+    readonly PendingTicks: "PendingTicks";
+    readonly LegacyBlockExtraData: "LegacyBlockExtraData";
+    readonly BiomeState: "BiomeState";
+    readonly FinalizedState: "FinalizedState";
+    readonly ConversionData: "ConversionData";
+    readonly BorderBlocks: "BorderBlocks";
+    readonly HardcodedSpawners: "HardcodedSpawners";
+    readonly RandomTicks: "RandomTicks";
+    readonly Checksums: "Checksums";
+    readonly GenerationSeed: "GenerationSeed";
+    readonly GeneratedPreCavesAndCliffsBlending: "GeneratedPreCavesAndCliffsBlending";
+    readonly BlendingBiomeHeight: "BlendingBiomeHeight";
+    readonly MetaDataHash: "MetaDataHash";
+    readonly BlendingData: "BlendingData";
+    readonly ActorDigestVersion: "ActorDigestVersion";
+    readonly LegacyVersion: "LegacyVersion";
+    readonly AABBVolumes: "AABBVolumes";
+    readonly VillageDwellers: "VillageDwellers";
+    readonly VillageInfo: "VillageInfo";
+    readonly VillagePOI: "VillagePOI";
+    readonly VillagePlayers: "VillagePlayers";
+    readonly VillageRaid: "VillageRaid";
+    readonly Player: "Player";
+    readonly PlayerClient: "PlayerClient";
+    readonly ActorPrefix: "ActorPrefix";
+    readonly ChunkLoadedRequest: "ChunkLoadedRequest";
+    readonly Digest: "Digest";
+    readonly Map: "Map";
+    readonly Portals: "Portals";
+    readonly SchedulerWT: "SchedulerWT";
+    readonly StructureTemplate: "StructureTemplate";
+    readonly TickingArea: "TickingArea";
+    readonly FlatWorldLayers: "FlatWorldLayers";
+    readonly LegacyOverworld: "LegacyDimension";
+    readonly LegacyNether: "LegacyDimension";
+    readonly LegacyTheEnd: "LegacyDimension";
+    readonly MVillages: "MVillages";
+    readonly Villages: "Villages";
+    readonly LevelSpawnWasFixed: "LevelSpawnWasFixed";
+    readonly PositionTrackingDB: "PositionTrackingDB";
+    readonly PositionTrackingLastId: "PositionTrackingLastId";
+    readonly Scoreboard: "Scoreboard";
+    readonly Overworld: "Dimension";
+    readonly Nether: "Dimension";
+    readonly TheEnd: "Dimension";
+    readonly AutonomousEntities: "AutonomousEntities";
+    readonly BiomeData: "BiomeData";
+    readonly BiomeIdsTable: "BiomeIdsTable";
+    readonly MobEvents: "MobEvents";
+    readonly DynamicProperties: "DynamicProperties";
+    readonly LevelChunkMetaDataDictionary: "LevelChunkMetaDataDictionary";
+    readonly RealmsStoriesData: "RealmsStoriesData";
+    readonly LevelDat: "LevelDat";
+    readonly ForcedWorldCorruption: "ForcedWorldCorruption";
+    readonly Unknown: "Unknown";
+};
 /**
  * The content type to format mapping for LevelDB entries.
  */
@@ -118,31 +188,81 @@ export declare const entryContentTypeToFormatMap: {
         readonly defaultValue: Buffer<ArrayBuffer>;
     };
     /**
-     * @deprecated Only used in versions < 1.18.0.
+     * The Data2D content type contains heightmap and biome data for 16x128x16 chunks of the world.
      *
-     * @todo Make a parser for this so that versions < 1.18.0 can be supported.
-     * @todo Add a description for this.
+     * Unlike {@link entryContentTypeToFormatMap.Data3D | Data3D}, this only stores biome data for xz coordinates, so in this format all y coordinates have the same biome.
+     *
+     * @deprecated Only used in versions < 1.18.0.
      */
     readonly Data2D: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.Data2D.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.Data2D;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.Data2D) => Buffer<ArrayBuffer>;
     };
     /**
-     * @deprecated Only used in versions < 1.0.0.
+     * The Data2D content type contains heightmap and biome data for 16x128x16 chunks of the world.
      *
-     * @todo Make a parser for this so that versions < 1.0.0 can be supported.
-     * @todo Add a description for this.
+     * Unlike {@link entryContentTypeToFormatMap.Data3D | Data3D}, this only stores biome data for xz coordinates, so in this format all y coordinates have the same biome.
+     *
+     * Unlike both {@link entryContentTypeToFormatMap.Data3D | Data3D} and {@link entryContentTypeToFormatMap.Data2D | Data2D}, this also stores biome color data.
+     *
+     * @deprecated Only used in versions < 1.0.0.
      */
     readonly Data2DLegacy: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.Data2DLegacy.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.Data2DLegacy;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.Data2DLegacy) => Buffer<ArrayBuffer>;
     };
     /**
-     * The SubChunkPrefix content type contains block data for 16x16x16 chunks of the world.
+     * The SubChunkPrefix content type contains block data for 16x16x16 subchunks of the world.
+     *
+     * In older versions, it may also contain sky and block light data.
      *
      * @see {@link NBTSchemas.nbtSchemas.SubChunkPrefix}
      */
@@ -164,6 +284,7 @@ export declare const entryContentTypeToFormatMap: {
          * @returns A promise that resolves with the parsed data.
          *
          * @throws {Error} If the SubChunkPrefix version is unknown.
+         * @throws {Error} If the storage version is unknown.
          */
         readonly parse: (data: Buffer) => Promise<NBTSchemas.NBTSchemaTypes.SubChunkPrefix>;
         /**
@@ -177,16 +298,39 @@ export declare const entryContentTypeToFormatMap: {
         readonly serialize: (data: NBTSchemas.NBTSchemaTypes.SubChunkPrefix) => Buffer<ArrayBuffer>;
     };
     /**
+     * The LegacyTerrain content type contains block, sky light, block light, dirty columns, and grass color data for 16x16x128 chunks of the world.
+     *
      * @deprecated Only used in versions < 1.0.0.
      *
-     * @todo Make a parser for this so that versions < 1.0.0 can be supported.
-     * @todo Add a description for this.
+     * @see {@link NBTSchemas.nbtSchemas.LegacyTerrain}
      */
     readonly LegacyTerrain: {
         /**
          * The format type of the data.
          */
-        readonly type: "unknown";
+        readonly type: "custom";
+        /**
+         * The format type that results from the {@link entryContentTypeToFormatMap.LegacyTerrain.parse | parse} method.
+         */
+        readonly resultType: "JSONNBT";
+        /**
+         * The function to parse the data.
+         *
+         * The {@link data} parameter should be the buffer read directly from the file or LevelDB entry.
+         *
+         * @param data The data to parse, as a buffer.
+         * @returns The parsed data.
+         */
+        readonly parse: (data: Buffer) => NBTSchemas.NBTSchemaTypes.LegacyTerrain;
+        /**
+         * The function to serialize the data.
+         *
+         * This result of this can be written directly to the file or LevelDB entry.
+         *
+         * @param data The data to serialize.
+         * @returns The serialized data, as a buffer.
+         */
+        readonly serialize: (data: NBTSchemas.NBTSchemaTypes.LegacyTerrain) => Buffer<ArrayBuffer>;
     };
     /**
      * A list of block entities associated with a chunk.
@@ -246,10 +390,11 @@ export declare const entryContentTypeToFormatMap: {
         }) => Buffer<ArrayBuffer>;
     };
     /**
+     * A list of entities associated with a chunk.
+     *
      * @deprecated No longer used.
      *
      * @todo Figure out what version this was deprecated in (it exists in v1.16.40 but not in 1.21.51).
-     * @todo Add a description for this.
      */
     readonly Entity: {
         /**
@@ -313,6 +458,12 @@ export declare const entryContentTypeToFormatMap: {
          * The format type of the data.
          */
         readonly type: "NBT";
+        /**
+         * The default value to use when initializing a new entry.
+         *
+         * @todo Add a link to the object with the default value once it is made.
+         */
+        readonly defaultValue: Buffer<ArrayBuffer>;
     };
     /**
      * @deprecated Only used in versions < 1.2.3.
@@ -343,6 +494,8 @@ export declare const entryContentTypeToFormatMap: {
      * - `0`: Unknown
      * - `1`: Unknown
      * - `2`: Unknown
+     *
+     * @todo Figure out the meanings of the values.
      */
     readonly FinalizedState: {
         /**
@@ -416,6 +569,12 @@ export declare const entryContentTypeToFormatMap: {
          * The format type of the data.
          */
         readonly type: "NBT";
+        /**
+         * The default value to use when initializing a new entry.
+         *
+         * @todo Add a link to the object with the default value once it is made.
+         */
+        readonly defaultValue: Buffer<ArrayBuffer>;
     };
     /**
      * The low segment of the 4 byte halves of the seed value used to generate the chunk.
@@ -443,7 +602,7 @@ export declare const entryContentTypeToFormatMap: {
         readonly signed: true;
     };
     /**
-     * xxHash64 checksums of `SubchunkBlocks`, `BlockEntities`, `Entities`, and `Data2D` values.
+     * xxHash64 checksums of `SubChunkPrefix`, `BlockEntity`, `Entity`, and `Data2D` values.
      *
      * @deprecated Only used in versions < 1.18.0.
      *
@@ -814,22 +973,78 @@ export declare const entryContentTypeToFormatMap: {
         readonly type: "NBT";
     };
     /**
+     * The structure data of the Overworld dimension.
+     *
+     * This content type coexists with the {@link entryContentTypeToFormatMap.Overworld | Overworld} content type in some versions (such as v1.0.0.16 and v1.1.5.0).
+     *
      * @deprecated It is unknown when this was removed, it was found in a Windows 10 Edition Beta v0.15.0 world.
      *
-     * @todo Add a schema for this.
-     * @todo Add a description for this.
+     * @see {@link NBTSchemas.nbtSchemas.LegacyOverworld}
      */
-    readonly LegacyDimension: {
+    readonly LegacyOverworld: {
         /**
          * The format type of the data.
          */
         readonly type: "NBT";
     };
     /**
-     * @todo Add a schema for this.
-     * @todo Add a description for this.
+     * The structure data of the Nether dimension.
+     *
+     * This content type coexists with the {@link entryContentTypeToFormatMap.Nether | Nether} content type in some versions (such as v1.0.0.16 and v1.1.5.0).
+     *
+     * @deprecated It is unknown when this was removed, it was found in a Windows 10 Edition Beta v0.15.0 world.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.LegacyNether}
      */
-    readonly Dimension: {
+    readonly LegacyNether: {
+        /**
+         * The format type of the data.
+         */
+        readonly type: "NBT";
+    };
+    /**
+     * The structure data of the End dimension.
+     *
+     * This content type coexists with the {@link entryContentTypeToFormatMap.TheEnd | TheEnd} content type in some versions (such as v1.0.0.16 and v1.1.5.0).
+     *
+     * @deprecated It is unknown when this was removed, it was found in a Windows 10 Edition Beta v0.15.0 world.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.LegacyTheEnd}
+     */
+    readonly LegacyTheEnd: {
+        /**
+         * The format type of the data.
+         */
+        readonly type: "NBT";
+    };
+    /**
+     * The data of the Overworld dimension.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.Overworld}
+     */
+    readonly Overworld: {
+        /**
+         * The format type of the data.
+         */
+        readonly type: "NBT";
+    };
+    /**
+     * The data of the Nether dimension.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.Nether}
+     */
+    readonly Nether: {
+        /**
+         * The format type of the data.
+         */
+        readonly type: "NBT";
+    };
+    /**
+     * The data of the End dimension.
+     *
+     * @see {@link NBTSchemas.nbtSchemas.TheEnd}
+     */
+    readonly TheEnd: {
         /**
          * The format type of the data.
          */
@@ -1361,6 +1576,10 @@ export type DBEntryContentType = (typeof DBEntryContentTypes)[number];
  * A content type of a LevelDB chunk key entry.
  */
 export type DBChunkKeyEntryContentType = "Data3D" | "Version" | "Data2D" | "Data2DLegacy" | "SubChunkPrefix" | "LegacyTerrain" | "BlockEntity" | "Entity" | "PendingTicks" | "LegacyBlockExtraData" | "BiomeState" | "FinalizedState" | "ConversionData" | "BorderBlocks" | "HardcodedSpawners" | "RandomTicks" | "Checksums" | "GenerationSeed" | "GeneratedPreCavesAndCliffsBlending" | "BlendingBiomeHeight" | "MetaDataHash" | "BlendingData" | "ActorDigestVersion" | "LegacyVersion" | "AABBVolumes";
+/**
+ * The a grouping type of LevelDB entry content types.
+ */
+export type DBEntryContentTypeGroup = (typeof DBEntryContentTypesGrouping)[DBEntryContentType];
 /**
  * Parses an integer from a buffer gives the number of bytes, endianness, signedness and offset.
  *